NAME

dminfo − report information about a device entry in a device maps file

SYNOPSIS

dminfo [ −v ] [ −a ] [ −f pathname ]

dminfo [ −v ] [ −a ] [ −f pathname ] −n dev−name ...

dminfo [ −v ] [ −a ] [ −f pathname ] −d dev−path ...

dminfo [ −v ] [ −a ] [ −f pathname ] −t dev−type ...

dminfo [ −v ] [ −f pathname ] −u dm−entry

DESCRIPTION

dminfo reports and updates information about the device_maps(4) file. 

OPTIONS

−v Verbose.  Print the requested entry or entries, one line per entry, on the standard output.  If no entries are specified, all are printed. 

−a Succeed if any of the requested entries are found.  If used with −v, all entries that match the requested case(s) are printed. 

−f pathname Use a device_maps file with pathname instead of /etc/security/device_maps. 

−n dev−name Search by dev−name. Search device_maps(4) for a device_name field matching dev−name. This option cannot be used with −d, −t or −u. 

−d dev−path Search by dev−path. Search device_maps(4) for a device special pathname in the device_list field matching the dev−path argument.  This option cannot be used with −n, −t or −u. 

−t dev−type Search by dev−type. Search device_maps(4) for a device_type field matching the given dev−type. This option cannot be used with −d, −n or −u. 

−u dm−entry Update the device_maps(4) file.  This option is provided to add entries to the device_maps(4) file.  The dm−entry must be a complete device_maps(4) file entry.  The dm−entry has fields, as in the device_maps file.  It uses the colon (:) as a field separator, and white space as the device_list subfield separators.  The dm−entry is not made if any fields are missing, or if the dm−entry would be a duplicate.  The default device maps file can be updated only by the super user. 

DIAGNOSTICS

dminfo returns an exit code of 0 if successful, 1 if the request failed, and 2 if the invocation syntax was incorrect. 

FILES

/etc/security/device_maps

ATTRIBUTES

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

SEE ALSO

bsmconv(1M), device_maps(4), attributes(5)

NOTES

The functionality described in this man page is available only if the Basic Security Module (BSM) has been enabled.  See bsmconv(1M) for more information. 

SunOS 5.6  —  Last change: 6 May 1993