Print this page
8708 Want diskinfo(1m) to list all disk bays, including those don't have disk installed
   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\" Copyright 2014 Joyent, Inc.
  12 .\" Copyright 2016 Nexenta Systems, Inc.
  13 .\"
  14 .Dd July 20, 2016
  15 .Dt DISKINFO 1M
  16 .Os
  17 .Sh NAME
  18 .Nm diskinfo
  19 .Nd provide disk device inventory and status
  20 .Sh SYNOPSIS
  21 .Nm
  22 .Op Fl Hp
  23 .Op Fl c Ns | Ns Fl P
  24 .Sh DESCRIPTION
  25 The diskinfo tool provides information about the disk devices in the system.
  26 Because it interacts with the kernel's device management subsystem, this tool
  27 can be used only from the global zone.
  28 If run in any other zone, its output will be incomplete and unreliable.
  29 .Pp
  30 There are three main modes.
  31 The default mode, when neither the
  32 .Fl c
  33 nor
  34 .Fl P
  35 option is specified, provides a basic inventory of the disk devices in the
  36 system.
  37 Each line describes a single device and contains the device's attachment bus or
  38 fabric type, the base name of the device in the
  39 .Pa /dev/dsk
  40 directory, the disk's vendor and product identification strings, the size
  41 .Pq storage capacity
  42 of the device, whether the device is removable, and whether it is solid-state.


  48 the fields provided indicate the base name of the device in the
  49 .Pa /dev/dsk
  50 directory, the disk's vendor and product identification strings, the serial
  51 number of the device, whether the device is faulty as diagnosed by
  52 .Xr fmd 1M ,
  53 whether the locate or identification indicator is on for the device
  54 .Pq if one is present ,
  55 and the chassis and bay number containing the disk if known.
  56 .Pp
  57 The
  58 .Fl c
  59 option selects compact mode.
  60 This mode provides all of the information provided by both the default mode and
  61 physical mode in a compact format.
  62 .Pp
  63 See
  64 .Sx OUTPUT FIELDS
  65 below for a detailed description of each column.
  66 .Sh OPTIONS
  67 .Bl -tag -width Ds


  68 .It Fl c
  69 Select compact mode output.
  70 At most one of
  71 .Fl c
  72 and
  73 .Fl P
  74 may be present on the command line.
  75 .It Fl H
  76 Do not print a header.
  77 This provides output suitable for passing into text processing tools.
  78 .It Fl P
  79 Select physical mode output.
  80 At most one of
  81 .Fl P
  82 and
  83 .Fl c
  84 may be present on the command line.
  85 .It Fl p
  86 Parsable output.
  87 When


   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\" Copyright 2014 Joyent, Inc.
  12 .\" Copyright 2016 Nexenta Systems, Inc.
  13 .\"
  14 .Dd October 06, 2017
  15 .Dt DISKINFO 1M
  16 .Os
  17 .Sh NAME
  18 .Nm diskinfo
  19 .Nd provide disk device inventory and status
  20 .Sh SYNOPSIS
  21 .Nm
  22 .Op Fl aHp
  23 .Op Fl c Ns | Ns Fl P
  24 .Sh DESCRIPTION
  25 The diskinfo tool provides information about the disk devices in the system.
  26 Because it interacts with the kernel's device management subsystem, this tool
  27 can be used only from the global zone.
  28 If run in any other zone, its output will be incomplete and unreliable.
  29 .Pp
  30 There are three main modes.
  31 The default mode, when neither the
  32 .Fl c
  33 nor
  34 .Fl P
  35 option is specified, provides a basic inventory of the disk devices in the
  36 system.
  37 Each line describes a single device and contains the device's attachment bus or
  38 fabric type, the base name of the device in the
  39 .Pa /dev/dsk
  40 directory, the disk's vendor and product identification strings, the size
  41 .Pq storage capacity
  42 of the device, whether the device is removable, and whether it is solid-state.


  48 the fields provided indicate the base name of the device in the
  49 .Pa /dev/dsk
  50 directory, the disk's vendor and product identification strings, the serial
  51 number of the device, whether the device is faulty as diagnosed by
  52 .Xr fmd 1M ,
  53 whether the locate or identification indicator is on for the device
  54 .Pq if one is present ,
  55 and the chassis and bay number containing the disk if known.
  56 .Pp
  57 The
  58 .Fl c
  59 option selects compact mode.
  60 This mode provides all of the information provided by both the default mode and
  61 physical mode in a compact format.
  62 .Pp
  63 See
  64 .Sx OUTPUT FIELDS
  65 below for a detailed description of each column.
  66 .Sh OPTIONS
  67 .Bl -tag -width Ds
  68 .It Fl a
  69 Show all disk bays, including those don't have disks installed.
  70 .It Fl c
  71 Select compact mode output.
  72 At most one of
  73 .Fl c
  74 and
  75 .Fl P
  76 may be present on the command line.
  77 .It Fl H
  78 Do not print a header.
  79 This provides output suitable for passing into text processing tools.
  80 .It Fl P
  81 Select physical mode output.
  82 At most one of
  83 .Fl P
  84 and
  85 .Fl c
  86 may be present on the command line.
  87 .It Fl p
  88 Parsable output.
  89 When