getddent(3BSM)					      Security and Auditing Library Functions					    getddent(3BSM)

NAME

       getddent, getddnam, setddent, endddent, setddfile - get device_deallocate entry

SYNOPSIS

       cc   [flag]... file... -lbsm  [library]...

       #include <bsm/devices.h>

       devdealloc_t *getddent(void);

       devdealloc_t *getddnam(char *name);

       void setddent(void);

       void endddent(void);

       void setddfile(char *file);

DESCRIPTION

       The  getddent()	and  getddnam()  functions each return a device_deallocate entry. The getddent() function enumerates all device_deallocate
       entries. Successive calls to this function return either successive device_deallocate entries or NULL. The getddnam() function searches for
       a device_deallocate entry with a given device name.

       The internal representation of a device_deallocate entry is a devdealloc_t structure defined in <bsm/devices.h> with the following members:

	 char *dd_devname;  /* device allocation name */
	 char *dd_logout;   /* deallocation action on user logout */
	 char *dd_boot;     /* deallocation action on system boot */

       The  setddent() function "rewinds" to the beginning of the enumeration of device_deallocate entries. Calls to getddnam() may leave the enu-
       meration in an indeterminate state, so setddent() should be called before the first call to getddent().

       The endddent() function can be called to indicate that device_deallocate processing is complete. The library can  then  close  any  opende-
       vice_deallocate file, deallocate any internal storage, and so forth.

       The  setddfile()  function  changes  the  pathname  used  by  the  other  functions for opening the device_deallocate file, allowing use of
       device_deallocate files other than the default file, /etc/security/device_deallocate.

RETURN VALUES

       The getddent() function returns a pointer to a devdealloc_t if it successfully enumerates an entry. Otherwise it returns  NULL,	indicating
       the end of the enumeration.

       The getddnam() function returns a pointer to a devdealloc_t if it successfully locates the requested entry. Otherwise it returns NULL.

FILES

       /etc/security/device_deallocate

	   Administrative file defining parameters for device deallocation.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       free(3C),  attributes(5)

NOTES

       The  getddent()	and  getddnam()  functions  allocate memory for the pointers they return. This memory can be deallocated with the free(3C)
       function.

SunOS 5.11							    11 Jan 2001 						    getddent(3BSM)