{
    "mode": "man",
    "parameter": "scsi-spin",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/scsi-spin/8/json",
    "generated": "2026-06-15T13:12:58Z",
    "synopsis": "scsi-spin [-options...] [device]",
    "sections": {
        "NAME": {
            "content": "scsi-spin - spin up and down a SCSI device\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "scsi-spin [-options...] [device]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "scsi-spin let the user to manually spin up and down a SCSI device.\n\nThis command is particularly useful if you've got noisy (or hot) drives in a machine that you\nrarely need to access.  This is not the same as the kernel patch that's floating around  that\nwill  automatically spin down the drive after some time.  scsi-spin is completely manual, and\nspinning down a drive that's in use, especially the one containing the scsi-spin  binary,  is\nprobably a really bad idea.\n\nTo avoid running in trouble with such cases, scsi-spin verifies that the device to work on is\nnot currently in use by scanning the mounted file system description  file  for  a  partition\nliving on it and issue an error if this the case.\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-u, --up",
                    "content": "spin up device.\n",
                    "flag": "-u",
                    "long": "--up"
                },
                {
                    "name": "-d, --down",
                    "content": "spin down device.\n",
                    "flag": "-d",
                    "long": "--down"
                },
                {
                    "name": "-e, --loej",
                    "content": "load or eject medium from drive (use along with -u or -d )\n",
                    "flag": "-e",
                    "long": "--loej"
                },
                {
                    "name": "-w, --wait=[n]",
                    "content": "wait  up  to  n seconds for the spin up/down command to complete. Default is to return\nimmediately after the command was sent to the device.  Either repeat -w n times or set\nn to define the time to wait before to report a timeout.\n",
                    "flag": "-w",
                    "long": "--wait",
                    "arg": "[n]"
                },
                {
                    "name": "-l, --lock",
                    "content": "prevent removal of medium from device.\n",
                    "flag": "-l",
                    "long": "--lock"
                },
                {
                    "name": "-L, --unlock",
                    "content": "allow removal of medium from device.\n",
                    "flag": "-L",
                    "long": "--unlock"
                },
                {
                    "name": "-I, --oldioctl",
                    "content": "use  legacy  ioctl interface instead of SGIO to dialog with device (could not be sup‐\nported on all platforms).  -e and -w are not allowed with this option.\n",
                    "flag": "-I",
                    "long": "--oldioctl"
                },
                {
                    "name": "-v, --verbose=[n]",
                    "content": "verbose mode. Either repeat -v or set n accordingly to increase verbosity. 1  is  ver‐\nbose, 2 is debug (dump SCSI commands and Sense buffer).\n",
                    "flag": "-v",
                    "long": "--verbose",
                    "arg": "[n]"
                },
                {
                    "name": "-f, --force",
                    "content": "force spinning up/down the device even if it is in use.\n",
                    "flag": "-f",
                    "long": "--force"
                },
                {
                    "name": "-n, --noact",
                    "content": "do nothing but check if the device is in use.\n\n",
                    "flag": "-n",
                    "long": "--noact"
                },
                {
                    "name": "-p, --proc",
                    "content": "use /proc/mounts instead of /etc/mtab to determine if the device is in use or not.\n\ndevice the device is any name in the filesystem which points to a SCSI block device (sd, scd)\nor generic SCSI device (sg). See section below.\n\n",
                    "flag": "-p",
                    "long": "--proc"
                },
                {
                    "name": "SCSI devices naming convention",
                    "content": ""
                },
                {
                    "name": "Old kernel naming convention",
                    "content": "It is typically /dev/sd[a-z] , /dev/scd[0-9]* or /dev/sg[0-9]*.\n\n"
                },
                {
                    "name": "scsidev naming convention",
                    "content": "It is typically /dev/scsi/s[rdg]h[0-9]*-e????c?i?l?  or /dev/scsi/<aliasname>.\n\n"
                },
                {
                    "name": "devfs naming convention",
                    "content": "It is  typically  /dev/scsi/host[0-9]/bus[0-9]/target[0-9]/lun[0-9]/disc  (same  for  cd  and\ngeneric  devices) or short name /dev/sd/c[0-9]b[0-9]t[0-9]u[0-9] when devfsd \"new compatibil‐\nity entries\" naming scheme is enabled.\n\n"
                }
            ]
        },
        "SEE ALSO": {
            "content": "scsiinfo(8), sgstart(8), sd(4), proc(5),\n\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Eric Delaunay <delaunay@debian.org>, 2001\nRob Browning <rlb@cs.utexas.edu>, 1998\n\n\n\n03 September 2001                             scsi-spin(8)",
            "subsections": []
        }
    },
    "summary": "scsi-spin - spin up and down a SCSI device",
    "flags": [
        {
            "flag": "-u",
            "long": "--up",
            "arg": null,
            "description": "spin up device."
        },
        {
            "flag": "-d",
            "long": "--down",
            "arg": null,
            "description": "spin down device."
        },
        {
            "flag": "-e",
            "long": "--loej",
            "arg": null,
            "description": "load or eject medium from drive (use along with -u or -d )"
        },
        {
            "flag": "-w",
            "long": "--wait",
            "arg": "[n",
            "description": "wait up to n seconds for the spin up/down command to complete. Default is to return immediately after the command was sent to the device. Either repeat -w n times or set n to define the time to wait before to report a timeout."
        },
        {
            "flag": "-l",
            "long": "--lock",
            "arg": null,
            "description": "prevent removal of medium from device."
        },
        {
            "flag": "-L",
            "long": "--unlock",
            "arg": null,
            "description": "allow removal of medium from device."
        },
        {
            "flag": "-I",
            "long": "--oldioctl",
            "arg": null,
            "description": "use legacy ioctl interface instead of SGIO to dialog with device (could not be sup‐ ported on all platforms). -e and -w are not allowed with this option."
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": "[n",
            "description": "verbose mode. Either repeat -v or set n accordingly to increase verbosity. 1 is ver‐ bose, 2 is debug (dump SCSI commands and Sense buffer)."
        },
        {
            "flag": "-f",
            "long": "--force",
            "arg": null,
            "description": "force spinning up/down the device even if it is in use."
        },
        {
            "flag": "-n",
            "long": "--noact",
            "arg": null,
            "description": "do nothing but check if the device is in use."
        },
        {
            "flag": "-p",
            "long": "--proc",
            "arg": null,
            "description": "use /proc/mounts instead of /etc/mtab to determine if the device is in use or not. device the device is any name in the filesystem which points to a SCSI block device (sd, scd) or generic SCSI device (sg). See section below."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "scsiinfo",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/scsiinfo/8/json"
        },
        {
            "name": "sgstart",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/sgstart/8/json"
        },
        {
            "name": "sd",
            "section": "4",
            "url": "https://www.chedong.com/phpMan.php/man/sd/4/json"
        },
        {
            "name": "proc",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/proc/5/json"
        }
    ]
}