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 "Mar 6, 2017"
   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 .LP
  37 \fBdminfo\fR reports and updates information about the \fBdevice_maps\fR(4)
  38 file.
  39 .SH OPTIONS
  40 .LP
  41 The following options are supported
  42 .sp
  43 .ne 2
  44 .na
  45 \fB\fB-a\fR\fR
  46 .ad
  47 .RS 18n
  48 Succeed if any of the requested entries are found. If used with \fB-v\fR, all
  49 entries that match the requested case(s) are printed.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-d\fR \fIdev\(mipath\fR\fR
  56 .ad
  57 .RS 18n
  58 Search by \fIdev\(mipath\fR. Search \fBdevice_maps\fR(4) for a device special
  59 pathname in the \fIdevice_list\fR field matching the \fIdev\(mipath\fR
  60 argument. This option cannot be used with \fB-n\fR, \fB-t\fR or \fB-u\fR.
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fB-f\fR \fIpathname\fR\fR
  67 .ad
  68 .RS 18n
  69 Use a device_maps file with \fIpathname\fR instead of
  70 \fB/etc/security/device_maps\fR.
  71 .RE
  72
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB-n\fR \fIdev\(miname\fR\fR
  77 .ad
  78 .RS 18n
  79 Search by \fIdev\(miname\fR. Search \fBdevice_maps\fR(4) for a
  80 \fIdevice_name\fR field matching \fIdev\(miname\fR. This option cannot be used
  81 with \fB-d\fR, \fB-t\fR or \fB-u\fR.
  82 .RE
  83
  84 .sp
  85 .ne 2
  86 .na
  87 \fB\fB-t\fR \fIdev\(mitype\fR\fR
  88 .ad
  89 .RS 18n
  90 Search by \fIdev\(mitype\fR. Search \fBdevice_maps\fR(4) for a
  91 \fIdevice_type\fR field matching the given \fIdev\(mitype\fR. This option
  92 cannot be used with \fB-d\fR, \fB-n\fR or \fB-u\fR.
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB-u\fR \fIdm\(mientry\fR\fR
  99 .ad
 100 .RS 18n
 101 Update the \fBdevice_maps\fR(4) file. This option is provided to add entries to
 102 the \fBdevice_maps\fR(4) file. The \fIdm\(mientry\fR must be a complete
 103 \fBdevice_maps\fR(4) file entry. The \fIdm\(mientry\fR has fields, as in the
 104 \fBdevice_maps\fR file. It uses the colon (\fB:\fR) as a field separator, and
 105 white space as the \fIdevice_list\fR subfield separators. The \fIdm\(mientry\fR
 106 is not made if any fields are missing, or if the \fIdm\(mientry\fR would be a
 107 duplicate. The default device maps file can be updated only by the super user.
 108 .RE
 109
 110 .sp
 111 .ne 2
 112 .na
 113 \fB\fB-v\fR\fR
 114 .ad
 115 .RS 18n
 116 Verbose. Print the requested entry or entries, one line per entry, on the
 117 standard output. If no entries are specified, all are printed.
 118 .RE
 119
 120 .SH EXIT STATUS
 121 .ne 2
 122 .na
 123 \fB0\fR
 124 .ad
 125 .RS 5n
 126 Successful completion.
 127 .RE
 128
 129 .sp
 130 .ne 2
 131 .na
 132 \fB1\fR
 133 .ad
 134 .RS 5n
 135 Request failed.
 136 .RE
 137
 138 .sp
 139 .ne 2
 140 .na
 141 \fB2\fR
 142 .ad
 143 .RS 5n
 144 Incorrect syntax.
 145 .RE
 146
 147 .SH FILES
 148 .LP
 149 \fB/etc/security/device_maps\fR
 150 .SH SEE ALSO
 151 .LP
 152 \fBdevice_maps\fR(4), \fBattributes\fR(5)