Security and Auditing Library Functions            getddent(3BSM)



NAME
     getddent, getddnam,  setddent,  endddent,  setddfile  -  get
     devicedeallocate entry

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


     #include 

     devdealloct *getddent(void);


     devdealloct *getddnam(char *name);


     void setddent(void);


     void endddent(void);


     void setddfile(char *file);


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


     The internal representation of a devicedeallocate entry  is
     a devdealloct structure defined in  with the
     following members:

       char *dddevname;  /* device allocation name */
       char *ddlogout;   /* deallocation action on user logout */
       char *ddboot;     /* deallocation action on system boot */



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






SunOS 5.11          Last change: 11 Jan 2001                    1






Security and Auditing Library Functions            getddent(3BSM)



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


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

RETURN VALUES
     The getddent() function returns a pointer to a  devdealloct
     if it successfully enumerates an entry. Otherwise it returns
     NUL, indicating the end of the enumeration.


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

FILES
     /etc/security/devicedeallocate

         Administrative file defining parameters for device deal-
         location.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE 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          Last change: 11 Jan 2001                    2