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 .\"
  12 .\" Copyright 2015 Nexenta Systems, Inc.  All rights reserved.
  13 .\"
  14 .Dd January 26, 2015
  15 .Dt DISK-DMC 1M
  16 .Os
  17 .Sh NAME
  18 .Nm disk-dmc
  19 .Nd firmware update utility
  20 .Sh SYNOPSIS
  21 .Nm
  22 .Fl h
  23 .Nm
  24 .Op Fl l
  25 .Op Fl v
  26 .Nm
  27 .Op Fl v
  28 .Fl d Ar dsk
  29 .Fl p Ar path
  30 .Op Fl s Ar 5|7
  31 .Op Fl w Ar delay
  32 .Nm
  33 .Op Fl v
  34 .Fl m Ar str
  35 .Fl p Ar path
  36 .Op Fl s Ar 5|7
  37 .Op Fl w Ar delay
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 utility performs firmware upgrade by issuing SCSI
  42 .Sy Write Buffer
  43 command (mode 5 or mode 7) on specified device(s).
  44 .Nm
  45 uses the
  46 .Xr uscsi 7I
  47 interface so the execution is limited to the root user.
  48 .Sh OPTIONS
  49 The following options are supported:
  50 .Bl -tag -width "-w delay"
  51 .It Fl d Ar dsk
  52 Specify the drive that will be targeted for firmware upgrade.
  53 .Ar dsk
  54 is the drive path in the form of
  55 .Sy /dev/rdsk/c?t?d?p0
  56 Requires
  57 .Fl p .
  58 This option is mutually exclusive with the
  59 .Fl m
  60 option.
  61 .It Fl s 7|5
  62 Change default (5) write buffer command mode.
  63 Supported values are 5 and 7.
  64 If 5 is selected
  65 .Nm
  66 will attempt to download the full firmware file onto
  67 the specified drive(s) in one write buffer command.
  68 If 7 is selected
  69 .Nm
  70 will break up the firmware file into 32K chunks and send as many write buffer
  71 commands as needed to complete the firmware transfer.
  72 .It Fl h
  73 Display the command line usage message.
  74 .It Fl l
  75 List the drives on a system available for firmware upgrade and display
  76 information specific to each device.
  77 This is implied if
  78 .Nm
  79 is run without any arguments.
  80 .It Fl m Ar str
  81 Specify the model of drive(s) to download firmware to.
  82 All discovered drives whose model exactly matches the
  83 .Ar str
  84 will be upgraded.
  85 Requires
  86 .Fl p .
  87 This option is mutually exclusive with the
  88 .Fl d
  89 option.
  90 .It Fl p Ar path
  91 Specify the path to the binary firmware image file you want to write to the
  92 device.
  93 .It Fl v
  94 Verbose mode, turns on extra debug messages.
  95 .It Fl w Ar delay
  96 Number of seconds to delay check for drive readiness after downloading the
  97 firmware.
  98 Also used for drive preparation timeouts.
  99 .El
 100 .Sh SEE ALSO
 101 .Xr fwflash 1M ,
 102 .Xr uscsi 7I
 103 .Pp
 104 .Lk http://www.t10.org "The SCSI Storage Interfaces committee website"