*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> standard/setspinfo (2)              


setspinfo(2)							  setspinfo(2)

NAME    [Toc]    [Back]

     setspinfo - set service provider information

SYNOPSIS    [Toc]    [Back]

     #include <sys/extacct.h>
     #include <unistd.h>

     int setspinfo(struct acct_spi *spi);

DESCRIPTION    [Toc]    [Back]

     The setspinfo function sets the service provider information for the
     array session containing the current process to the contents of the
     acct_spi struct pointed to	by spi.	 Typically, this would only be done
     when the array session is first created.  The invoker must	have superuser

     Service provider information is intended for use by software such as
     batch queueing systems that need to maintain fairly static	information
     about an array session.  It is included in	session	accounting records and
     can be retrieved by any member of the array session.  Ordinarily, the
     service provider information for a	new array session is inherited from
     the array session of the process that created it; setspinfo can be	used
     to	override this default behavior.

     The service provider information itself has no particular meaning to
     IRIX.  For	convenience, a suggested acct_spi struct is defined in the
     <sys/extacct.h> header file and has the following layout:

	  struct acct_spi {	  /* Service provider information */
	      char    spi_company[8];	 /* Name of company providing service */
	      char    spi_initiator[8];	 /* Name of machine initiating job */
	      char    spi_origin[16];	 /* Name of queue */
	      char    spi_spi[16];	 /* Available for service provider */
	      char    spi_spare[16];	 /*   reserved */

     setspinfo is provided primarily for compatibility with older versions of
     IRIX.  A more general mechanism for setting the service provider
     information, including the	ability	to save	more or	less than the 64 bytes
     of	data implied by	acct_spi, is provided by the ARSOP_SETSPI function of

ERRORS    [Toc]    [Back]

     setspinfo may fail	if one or more of these	conditions are true:

     EFAULT    spi points to an	invalid	location.

     EPERM     The current process does	not have superuser privileges.

									Page 1

setspinfo(2)							  setspinfo(2)

SEE ALSO    [Toc]    [Back]

     arsop(2), getspinfo(2), newarraysess(2), array_sessions(5), extacct(5).

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, setspinfo returns a value of 0.  Otherwise, a
     value of -1 is returned and errno is set to indicate the error.

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
getspinfo IRIX get service provider information
pam_sm_acct_mgmt HP-UX Service provider implementation for pam_acct_mgmt
pam_sm_chauthtok HP-UX Service provider implementation for pam_chauthtok
pam_sm_setcred HP-UX Service provider implementation for pam_setcred
pam_sm_authenticate HP-UX Service provider implementation for pam_authenticate
pam_sm_open_session HP-UX Service provider implementation for pam_open_session and pam_close_session respectively
pam_sm_close_session HP-UX Service provider implementation for pam_open_session and pam_close_session respectively
CSSM_SPI_ModuleAttach Tru64 Attach a service provider module(CDSA)
CSSM_ModuleDetach Tru64 Detach application from service provider module (CDSA)
CSSM_ModuleAttach Tru64 Attach and verify a service provider module (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service