xref: /titanic_52/usr/src/man/man1m/dminfo.1m (revision 35b6f0471a5d938b98734483be3c5a258e319010)
te
Copyright (c) 1993, Sun Microsystems, Inc.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
DMINFO 1M "Apr 16, 2008"
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

The following options are supported -a

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

-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.

-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.

-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.

-v

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

EXIT STATUS
0

Successful completion.

1

Request failed.

2

Incorrect syntax.

FILES

/etc/security/device_maps

SEE ALSO

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

NOTES

The functionality described in this man page is available only if the Solaris Auditing feature has been enabled. See bsmconv(1M) for more information.