Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

SunOS 5.10 - man page for setdmapfile (sunos section 3bsm)

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)