GETDDENT man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GETDDENT(3BSM)							GETDDENT(3BSM)

NAME
       getddent,  getddnam, setddent, endddent, setddfile - get device_deallo‐
       cate 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  devdeal‐
       loc_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 enumer‐
       ation  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_deallo‐
       cate  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	 func‐
       tions   for   opening  the  device_deallocate  file,  allowing  use  of
       device_deallocate  files	 other	than  the  default  file,   /etc/secu‐
       rity/device_deallocate.

RETURN VALUES
       The  getddent() function returns a pointer to a devdealloc_t if it suc‐
       cessfully 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 suc‐
       cessfully 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	point‐
       ers they return. This memory can be deallocated with the free(3C) func‐
       tion.

				 Jan 11, 2001			GETDDENT(3BSM)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net