usr/src/man/man1m/dminfo.1m

   1 '\" te
   2 .\" Copyright (c) 1993, Sun Microsystems, Inc.
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH DMINFO 1M "Apr 16, 2008"
   7 .SH NAME
   8 dminfo \- report information about a device entry in a device maps file
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdminfo\fR [\fB-v\fR] [\fB-a\fR] [\fB-f\fR \fIpathname\fR]
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBdminfo\fR [\fB-v\fR] [\fB-a\fR] [\fB-f\fR \fIpathname\fR] \fB-n\fR \fIdev\fR \fB-\fIname\fR\fR...
  18 .fi
  19
  20 .LP
  21 .nf
  22 \fBdminfo\fR [\fB-v\fR] [\fB-a\fR] [\fB-f\fR \fIpathname\fR] \fB-d\fR \fIdev\fR \fB-\fIpath\fR\fR...
  23 .fi
  24
  25 .LP
  26 .nf
  27 \fBdminfo\fR [\fB-v\fR] [\fB-a\fR] [\fB-f\fR \fIpathname\fR] \fB-t\fR \fIdev\fR \fB-\fItype\fR\fR...
  28 .fi
  29
  30 .LP
  31 .nf
  32 \fBdminfo\fR [\fB-v\fR] [\fB-f\fR \fIpathname\fR] \fB-u\fR \fIdm\fR -\fIentry\fR
  33 .fi
  34
  35 .SH DESCRIPTION
  36 .sp
  37 .LP
  38 \fBdminfo\fR reports and updates information about the \fBdevice_maps\fR(4)
  39 file.
  40 .SH OPTIONS
  41 .sp
  42 .LP
  43 The following options are supported
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-a\fR\fR
  48 .ad
  49 .RS 18n
  50 Succeed if any of the requested entries are found. If used with \fB-v\fR, all
  51 entries that match the requested case(s) are printed.
  52 .RE
  53
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB-d\fR \fIdev\(mipath\fR\fR
  58 .ad
  59 .RS 18n
  60 Search by \fIdev\(mipath\fR. Search \fBdevice_maps\fR(4) for a device special
  61 pathname in the \fIdevice_list\fR field matching the \fIdev\(mipath\fR
  62 argument. This option cannot be used with \fB-n\fR, \fB-t\fR or \fB-u\fR.
  63 .RE
  64
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fB-f\fR \fIpathname\fR\fR
  69 .ad
  70 .RS 18n
  71 Use a device_maps file with \fIpathname\fR instead of
  72 \fB/etc/security/device_maps\fR.
  73 .RE
  74
  75 .sp
  76 .ne 2
  77 .na
  78 \fB\fB-n\fR \fIdev\(miname\fR\fR
  79 .ad
  80 .RS 18n
  81 Search by \fIdev\(miname\fR. Search \fBdevice_maps\fR(4) for a
  82 \fIdevice_name\fR field matching \fIdev\(miname\fR. This option cannot be used
  83 with \fB-d\fR, \fB-t\fR or \fB-u\fR.
  84 .RE
  85
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB-t\fR \fIdev\(mitype\fR\fR
  90 .ad
  91 .RS 18n
  92 Search by \fIdev\(mitype\fR. Search \fBdevice_maps\fR(4) for a
  93 \fIdevice_type\fR field matching the given \fIdev\(mitype\fR. This option
  94 cannot be used with \fB-d\fR, \fB-n\fR or \fB-u\fR.
  95 .RE
  96
  97 .sp
  98 .ne 2
  99 .na
 100 \fB\fB-u\fR \fIdm\(mientry\fR\fR
 101 .ad
 102 .RS 18n
 103 Update the \fBdevice_maps\fR(4) file. This option is provided to add entries to
 104 the \fBdevice_maps\fR(4) file. The \fIdm\(mientry\fR must be a complete
 105 \fBdevice_maps\fR(4) file entry. The \fIdm\(mientry\fR has fields, as in the
 106 \fBdevice_maps\fR file. It uses the colon (\fB:\fR) as a field separator, and
 107 white space as the \fIdevice_list\fR subfield separators. The \fIdm\(mientry\fR
 108 is not made if any fields are missing, or if the \fIdm\(mientry\fR would be a
 109 duplicate. The default device maps file can be updated only by the super user.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fB-v\fR\fR
 116 .ad
 117 .RS 18n
 118 Verbose. Print the requested entry or entries, one line per entry, on the
 119 standard output. If no entries are specified, all are printed.
 120 .RE
 121
 122 .SH EXIT STATUS
 123 .sp
 124 .ne 2
 125 .na
 126 \fB0\fR
 127 .ad
 128 .RS 5n
 129 Successful completion.
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 \fB1\fR
 136 .ad
 137 .RS 5n
 138 Request failed.
 139 .RE
 140
 141 .sp
 142 .ne 2
 143 .na
 144 \fB2\fR
 145 .ad
 146 .RS 5n
 147 Incorrect syntax.
 148 .RE
 149
 150 .SH FILES
 151 .sp
 152 .LP
 153 \fB/etc/security/device_maps\fR
 154 .SH SEE ALSO
 155 .sp
 156 .LP
 157 \fBbsmconv\fR(1M), \fBdevice_maps\fR(4), \fBattributes\fR(5)
 158 .SH NOTES
 159 .sp
 160 .LP
 161 The functionality described in this man page is available only if the Solaris
 162 Auditing feature has been enabled.  See \fBbsmconv\fR(1M) for more information.