getdmapnam man page on SunOS

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

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

NAME
       getdmapent,  getdmapnam,	 getdmaptype,  getdmaptdev,  setdmapent,  end‐
       dmapent, setdmapfile - get device_maps entry

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

       #include <bsm/devices.h>

       devmap_t *getdmapent(void);

       devmap_t *getdmapnam(char *name);

       devmap_t *getdmapdev(char *name);

       devmap_t *getdmaptype(char *type);

       void setdmapent(void);

       void enddmapent(void);

       void setdmapfile(char *file);

DESCRIPTION
       The getdmapent(), getdmapnam(), getdmapdev(), and  getdmaptype()	 func‐
       tions  each return a device_deallocate entry. The getdmapent() function
       enumerates all device_maps entries. The getdmaptype() function  enumer‐
       ates  device_maps entries with a given device type. Successive calls to
       these functions return either successive device_maps entries  or	 NULL.
       The getdmapnam() function searches for a device_maps entry with a given
       device allocation  name.	 The  getdmapdev()  function  searches	for  a
       device_maps entry containing a given device special file.

       The internal representation of a device_maps entry is a devmap_t struc‐
       ture defined in <bsm/devices.h> with the following members:

       char *dmap_devname;     /* device allocation name */
       char *dmap_devtype;     /* generic device type */
       char *dmap_devlist;     /* list of associated device special files */

       The setdmapent() function "rewinds" to the beginning of the enumeration
       of device_maps entries. Calls to getdmapnam() may leave the enumeration
       in an indeterminate state, so setdmapent() should be called before  the
       first call to getdmapent() or getdmaptype().

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

       The setdmapfile() function changes the pathname used by the other func‐
       tions for opening the device_maps file,	allowing  use  of  device_maps
       files other than the default file, /etc/security/device_maps.

RETURN VALUES
       The  getdmapent()  and  getdmaptype()  functions	 return a pointer to a
       devmap_t if they successfully enumerate an entry. Otherwise they return
       NULL, indicating the end of the enumeration.

       The  getdmapnam()  function  returns a pointer to a devmap_t if it suc‐
       cessfully locates the requested entry. Otherwise it returns NULL.

FILES
       /etc/security/device_maps

	   Administrative file defining the mapping of device special files to
	   allocatable device names.

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Unsafe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       allocate(1), free(3C), device_maps(4), attributes(5)

NOTES
       The  getdmapent(),  getdmapnam(), getdmapdev(), and getdmaptype() func‐
       tions allocate memory for the pointers they return. This memory can  be
       deallocated with the free(3C) function.

SunOS 5.10			  11 Jan 2001		      getdmapent(3BSM)
[top]

List of man pages available for SunOS

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