sunos man page for getdmapnam

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

NAME
       getdmapent, getdmapnam, getdmaptype, getdmaptdev, setdmapent, enddmapent, 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() functions each return a device_deallocate entry. The getdmapent() function
       enumerates all device_maps entries. The getdmaptype() function enumerates 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 structure 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 enumer-
       ation 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 functions 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 successfully 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() functions 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)