{ "content": [ { "type": "text", "text": "# scsi-spin (man)\n\n## NAME\n\nscsi-spin - spin up and down a SCSI device\n\n## SYNOPSIS\n\nscsi-spin [-options...] [device]\n\n## DESCRIPTION\n\nscsi-spin let the user to manually spin up and down a SCSI device.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (15 subsections)\n- **SEE ALSO**\n- **AUTHORS**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "scsi-spin", "section": "", "mode": "man", "summary": "scsi-spin - spin up and down a SCSI device", "synopsis": "scsi-spin [-options...] [device]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "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" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 13, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-u, --up", "lines": 2, "flag": "-u", "long": "--up" }, { "name": "-d, --down", "lines": 2, "flag": "-d", "long": "--down" }, { "name": "-e, --loej", "lines": 2, "flag": "-e", "long": "--loej" }, { "name": "-w, --wait=[n]", "lines": 4, "flag": "-w", "long": "--wait", "arg": "[n]" }, { "name": "-l, --lock", "lines": 2, "flag": "-l", "long": "--lock" }, { "name": "-L, --unlock", "lines": 2, "flag": "-L", "long": "--unlock" }, { "name": "-I, --oldioctl", "lines": 3, "flag": "-I", "long": "--oldioctl" }, { "name": "-v, --verbose=[n]", "lines": 3, "flag": "-v", "long": "--verbose", "arg": "[n]" }, { "name": "-f, --force", "lines": 2, "flag": "-f", "long": "--force" }, { "name": "-n, --noact", "lines": 3, "flag": "-n", "long": "--noact" }, { "name": "-p, --proc", "lines": 6, "flag": "-p", "long": "--proc" }, { "name": "SCSI devices naming convention", "lines": 1 }, { "name": "Old kernel naming convention", "lines": 3 }, { "name": "scsidev naming convention", "lines": 3 }, { "name": "devfs naming convention", "lines": 5 } ] }, { "name": "SEE ALSO", "lines": 3, "subsections": [] }, { "name": "AUTHORS", "lines": 6, "subsections": [] } ], "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/.\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 , 2001\nRob Browning , 1998\n\n\n\n03 September 2001 scsi-spin(8)", "subsections": [] } } } }