Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
shisa_principal_update(3)	    shishi	     shisa_principal_update(3)

NAME
       shisa_principal_update -	API function

SYNOPSIS
       #include	<shisa.h>

       int  shisa_principal_update(Shisa * dbh,	const char * realm, const char
       * principal, const Shisa_principal * ph);

ARGUMENTS
       Shisa * dbh Shisa library handle	created	by shisa().

       const char * realm
		   Name	of realm the principal belongs in.

       const char * principal
		   Name	of principal to	get information	on.

       const Shisa_principal * ph
		   Pointer to principal	structure with information to store in
		   database.

DESCRIPTION
       Modify  information  stored  for	given PRINCIPALREALM.  Note that it is
       usually a good idea to only set the fields in ph	that you actually want
       to  update.   Specifically, first calling shisa_principal_find()	to get
       the  current  information,  then	 modifying  one	 field,	 and   calling
       shisa_principal_update()	is not recommended in general, as this will 1)
       overwrite any modifications made	to other fields	between	the two	 calls
       (by  other processes) and 2) will cause all values to be	written	again,
       which may generate more overhead.

RETURN VALUE
       Returns SHISA_OK	if successful, SHISA_NO_REALM if the  indicated	 realm
       does  not exist,	SHISA_NO_PRINCIPAL if the indicated principal does not
       exist, or an error code.

REPORTING BUGS
       Report bugs to <bug-shishi@gnu.org>.

COPYRIGHT
       Copyright (C) 2002-2010 Simon Josefsson.
       Copying and distribution	of this	file, with  or	without	 modification,
       are  permitted in any medium without royalty provided the copyright no-
       tice and	this notice are	preserved.

SEE ALSO
       The full	documentation for shishi is maintained as  a  Texinfo  manual.
       If  the	info  and shishi programs are properly installed at your site,
       the command

	      info shishi

       should give you access to the complete manual.

shishi				     1.0.2	     shisa_principal_update(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURN VALUE | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=shisa_principal_update&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help