.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shisa_principal_add" 3 "1.0.1" "shishi" "shishi"
.SH NAME
shisa_principal_add \- API function
.SH SYNOPSIS
.B #include <shisa.h>
.sp
.BI "int shisa_principal_add(Shisa * " dbh ", const char * " realm ", const char * " principal ", const Shisa_principal * " ph ", const Shisa_key * " key ");"
.SH ARGUMENTS
.IP "Shisa * dbh" 12
Shisa library handle created by \fBshisa()\fP.
.IP "const char * realm" 12
Name of realm the principal belongs in.
.IP "const char * principal" 12
Name of principal to add, may be \fBNULL\fP to indicate that
the \fIrealm\fP should be created, in which case \fIph\fP and \fIkey\fP are not used.
.IP "const Shisa_principal * ph" 12
Pointer to principal structure with information to store in database.
.IP "const Shisa_key * key" 12
Pointer to key structure with information to store in database.
.SH "DESCRIPTION"
Add given information to database as PRINCIPAL\fIREALM\fP.
.SH "RETURN VALUE"
Returns SHISA_OK iff successfully added, or an error code.
.SH "REPORTING BUGS"
Report bugs to <bug-shishi@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2002-2010 Simon Josefsson.
.br
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
.SH "SEE ALSO"
The full documentation for
.B shishi
is maintained as a Texinfo manual.  If the
.B info
and
.B shishi
programs are properly installed at your site, the command
.IP
.B info shishi
.PP
should give you access to the complete manual.