Print this page
12745 man page typos

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/luxadm.1m
          +++ new/usr/src/man/man1m/luxadm.1m
   1    1  '\" te
   2    2  .\"  Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
   3    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    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    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 LUXADM 1M "May 13, 2017"
        6 +.TH LUXADM 1M "May 17, 2020"
   7    7  .SH NAME
   8    8  luxadm \- administer Sun Fire 880 storage subsystem and FC_AL devices
   9    9  .SH SYNOPSIS
  10      -.LP
  11   10  .nf
  12   11  \fBluxadm\fR [\fIoptions\fR]... \fIsubcommand\fR [\fIoptions\fR]... \fIenclosure\fR
  13   12       [,\fIdev\fR] | \fIpathname\fR...
  14   13  .fi
  15   14  
  16   15  .SH DESCRIPTION
  17      -.LP
  18   16  The \fBluxadm\fR program is an administrative command that manages the
  19   17  \fBSENA\fR, Sun Fire 880 internal storage subsystem, and individual Fiber
  20   18  Channel Arbitrated Loop (\fBFC_AL\fR) devices. \fBluxadm\fR performs a variety
  21   19  of control and query tasks depending on the command line arguments and options
  22   20  used.
  23   21  .sp
  24   22  .LP
  25   23  The command line must contain a subcommand. The command line may also contain
  26   24  options, usually at least one enclosure name or pathname, and other parameters
  27   25  depending on the subcommand. You need specify only as many characters as are
↓ open down ↓ 1 lines elided ↑ open up ↑
  29   27  .sp
  30   28  .LP
  31   29  Specify the device that a subcommand interacts with by entering a pathname. For
  32   30  the \fBSENA\fR subsystem, a disk device or enclosure services controller may
  33   31  instead be specified by entering the World Wide Name (\fBWWN\fR) for the device
  34   32  or a port to the device. The device may also be specified by entering the name
  35   33  of the \fBSENA\fR enclosure, and an optional identifier for the particular
  36   34  device in the enclosure. The individual \fBFC_AL\fR devices may be specified by
  37   35  entering the \fBWWN\fR for the device or a port to the device.
  38   36  .SS "Pathname"
  39      -.LP
  40   37  Specify the device or controller by either a complete physical pathname or a
  41   38  complete logical pathname.
  42   39  .sp
  43   40  .LP
  44   41  For \fBSENA,\fR a typical physical pathname for a device is:
  45   42  .sp
  46   43  .in +2
  47   44  .nf
  48   45  /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
  49   46           0:a,raw
↓ open down ↓ 63 lines elided ↑ open up ↑
 113  110  and a typical logical pathname is:
 114  111  .sp
 115  112  .in +2
 116  113  .nf
 117  114  /dev/rdsk/c1t0d0s2
 118  115  .fi
 119  116  .in -2
 120  117  .sp
 121  118  
 122  119  .SS "Enclosure"
 123      -.LP
 124  120  For \fBSENA,\fR a device may be identified by its enclosure name and slotname:
 125  121  .br
 126  122  .in +2
 127  123  \fIbox_name\fR[\fB,f\fR\fIslot_number\fR]
 128  124  .in -2
 129  125  .br
 130  126  .in +2
 131  127  \fIbox_name\fR[\fB,r\fR\fIslot_number\fR]
 132  128  .in -2
 133  129  .sp
↓ open down ↓ 28 lines elided ↑ open up ↑
 162  158  \fBenclosure_name\fR subcommand. When used without the optional
 163  159  \fIslot_number\fR parameter, \fIbox_name\fR identifies the Sun Fire 880
 164  160  internal storage subsystem enclosure services device. Use \fIs\fR to specify
 165  161  the disk slot number in the Sun Fire 880 internal storage subsystem, \fB0\fR -
 166  162  \fB11\fR.
 167  163  .sp
 168  164  .LP
 169  165  See \fBdisks\fR(1M) and \fBdevlinks\fR(1M) for additional information on
 170  166  logical names for disks and subsystems.
 171  167  .SH OPTIONS
 172      -.LP
 173  168  The following options are supported by all subcommands:
 174  169  .sp
 175  170  .ne 2
 176  171  .na
 177  172  \fB\fB-e\fR\fR
 178  173  .ad
 179  174  .RS 6n
 180  175  Expert mode. This option is not recommended for the novice user.
 181  176  .RE
 182  177  
↓ open down ↓ 4 lines elided ↑ open up ↑
 187  182  .ad
 188  183  .RS 6n
 189  184  Verbose mode.
 190  185  .RE
 191  186  
 192  187  .sp
 193  188  .LP
 194  189  Options that are specific to particular subcommands are described with the
 195  190  subcommand in the \fBUSAGE\fR section.
 196  191  .SH OPERANDS
 197      -.LP
 198  192  The following operands are supported:
 199  193  .sp
 200  194  .ne 2
 201  195  .na
 202  196  \fB\fIenclosure\fR\fR
 203  197  .ad
 204  198  .sp .6
 205  199  .RS 4n
 206  200  The \fIbox_name\fR of the \fBSENA\fR or Sun Fire 880 internal storage
 207  201  subsystem.
↓ open down ↓ 100 lines elided ↑ open up ↑
 308  302  .ad
 309  303  .sp .6
 310  304  .RS 4n
 311  305  Download the prom image pointed to the SENA subsystem Interface Board unit or
 312  306  the Sun Fire 880 internal storage subsystem specified by the enclosure or
 313  307  pathname.
 314  308  .sp
 315  309  When the \fBSENA's\fR download is complete, the \fBSENA\fR will be reset and
 316  310  the downloaded code executed. If no filename is specified, the default prom
 317  311  image will be used. The default prom image for the \fBSENA\fR is in the
 318      -directory \fBusr/lib/locale/C/LC_MESSAGES\fR and is named \fBibfirmware\fR
      312 +directory \fB/usr/lib/locale/C/LC_MESSAGES\fR and is named \fBibfirmware\fR
 319  313  .sp
 320  314  When the Sun Fire 880 internal storage subsystem's download is complete, the
 321  315  subsystem resets and the downloaded code begins execution. The default firmware
 322  316  image for the Sun Fire 880 internal storage subsystem is in:
 323  317  \fB/usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw\fR.
 324  318  .sp
 325  319  .ne 2
 326  320  .na
 327  321  \fB\fB-s\fR\fR
 328  322  .ad
↓ open down ↓ 410 lines elided ↑ open up ↑
 739  733  .ne 2
 740  734  .na
 741  735  \fB\fBstop\fR \fIpathname\fR...\fR
 742  736  .ad
 743  737  .sp .6
 744  738  .RS 4n
 745  739  Spin down the specified disks in a SENA.
 746  740  .RE
 747  741  
 748  742  .SS "SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive Expert Mode Subcommands"
 749      -.LP
 750  743  The following subcommands are for expert use only, and are applicable only to
 751  744  the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and fiber channel
 752  745  loops. They should only be used by users that are knowledgeable about the
 753  746  \fBSENA\fR subsystem and fiber channel loops.
 754  747  .sp
 755  748  .LP
 756  749  If you specify a disk to an expert subcommand that operates on a bus, the
 757  750  subcommand operates on the bus to which the specified disk is attached.
 758  751  .sp
 759  752  .ne 2
↓ open down ↓ 100 lines elided ↑ open up ↑
 860  853  \fB\fB\fR\fB-e\fR \fBrdls\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
 861  854  \fIpathname\fR\|.\|.\|.\fR
 862  855  .ad
 863  856  .sp .6
 864  857  .RS 4n
 865  858  Read and display the link error status information for all available devices on
 866  859  the loop that contains the device specified by the enclosure or pathname.
 867  860  .RE
 868  861  
 869  862  .SS "Other Expert Mode Subcommands"
 870      -.LP
 871  863  See \fBNOTES\fR for limitations of these subcommands. They should only be used
 872  864  by users that are knowledgeable about the systems they are managing.
 873  865  .sp
 874  866  .LP
 875  867  These commands do not apply to the Sun Fire 880 internal storage subsystem.
 876  868  .sp
 877  869  .ne 2
 878  870  .na
 879  871  \fB\fB\fR\fB-e\fR \fBbus_getstate\fR \fIpathname\fR\fR
 880  872  .ad
↓ open down ↓ 67 lines elided ↑ open up ↑
 948  940  .sp
 949  941  .ne 2
 950  942  .na
 951  943  \fB\fB\fR\fB-e\fR \fBonline\fR \fIpathname\fR\fR
 952  944  .ad
 953  945  .RS 29n
 954  946  Put the specified device online.
 955  947  .RE
 956  948  
 957  949  .SH EXAMPLES
 958      -.LP
 959  950  \fBExample 1 \fRDisplaying the \fBSENA\fRs and Individual FC_AL Devices on a
 960  951  System
 961  952  .sp
 962  953  .LP
 963  954  The following example finds and displays all of the \fBSENA\fRs and individual
 964  955  \fBFC_AL\fR devices on a system:
 965  956  
 966  957  .sp
 967  958  .in +2
 968  959  .nf
↓ open down ↓ 231 lines elided ↑ open up ↑
1200 1191  .in +2
1201 1192  .nf
1202 1193  example# \fBluxadm \fR\fB-e\fR\fB bus_unquiesce /dev/rdsk/c1t8d0s2\fR
1203 1194  example# \fBluxadm \fR\fB-e\fR\fB online /dev/rdsk/c1t8d0s2\fR
1204 1195  example# \fBluxadm release /dev/rdsk/c1t8d0s2\fR
1205 1196  .fi
1206 1197  .in -2
1207 1198  .sp
1208 1199  
1209 1200  .SH ENVIRONMENT VARIABLES
1210      -.LP
1211 1201  See \fBenviron\fR(5) for a description of the \fBLANG\fR environment variable
1212 1202  that affects the execution of \fBluxadm\fR.
1213 1203  .SH EXIT STATUS
1214      -.LP
1215 1204  The following exit values are returned:
1216 1205  .sp
1217 1206  .ne 2
1218 1207  .na
1219 1208  \fB\fB0\fR\fR
1220 1209  .ad
1221 1210  .RS 9n
1222 1211  Successful completion.
1223 1212  .RE
1224 1213  
↓ open down ↓ 2 lines elided ↑ open up ↑
1227 1216  .na
1228 1217  \fB\fB\(mi1\fR\fR
1229 1218  .ad
1230 1219  .RS 9n
1231 1220  An error occurred.
1232 1221  .RE
1233 1222  
1234 1223  .SH FILES
1235 1224  .ne 2
1236 1225  .na
1237      -\fB\fBusr/lib/firmware/fc_s/fc_s_fcode\fR\fR
     1226 +\fB\fB/usr/lib/firmware/fc_s/fc_s_fcode\fR\fR
1238 1227  .ad
1239 1228  .sp .6
1240 1229  .RS 4n
1241 1230  
1242 1231  .RE
1243 1232  
1244 1233  .sp
1245 1234  .ne 2
1246 1235  .na
1247      -\fB\fBusr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
     1236 +\fB\fB/usr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
1248 1237  .ad
1249 1238  .sp .6
1250 1239  .RS 4n
1251 1240  
1252 1241  .RE
1253 1242  
1254 1243  .SH SEE ALSO
1255      -.LP
1256 1244  \fBdevlinks\fR(1M), \fBdisks\fR(1M), \fBattributes\fR(5), \fBenviron\fR(5),
1257 1245  \fBses\fR(7D)
1258 1246  .SH NOTES
1259      -.LP
1260 1247  Currently, only some device drivers
1261 1248  support hot plugging. If hot plugging is attempted on a disk or bus where it is
1262 1249  not supported, an error message of the form:
1263 1250  .sp
1264 1251  .in +2
1265 1252  .nf
1266 1253  luxadm: can't acquire "PATHNAME": No such file or directory
1267 1254  .fi
1268 1255  .in -2
1269 1256  .sp
1270 1257  
1271 1258  .sp
1272 1259  .LP
1273 1260  will be displayed.
1274 1261  .sp
1275 1262  .LP
1276 1263  You must be careful not to quiesce a bus that contains the root or the
1277 1264  \fB/usr\fR filesystems or any swap data. If you do quiesce such a bus a
1278 1265  deadlock can result, requiring a system reboot.
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX