HOTSWAP(1)

📦 version 0.4.0, in ubuntu jammy

💖 HOTSWAP 💖

okay bestie, welcome to hotswap(1), from the General Commands Manual section, no less 👑

✨ NAME ✨

hotswap — register and unregister hotswappable IDE hardware 🦋

🌸 SYNOPSIS 🌸

hotswap [ -c | --ide-controller N] [-h | --help] [-n | --nocheck] [-v |
--verbose] [-V | --version] [ACTION]

💅 DESCRIPTION 💅

so basically hotswap lets you register and unregister hotswappable IDE devices — think notebook computer modules, that whole vibe — with the Linux kernel. it's giving plug-and-play but make it IDE 🔥

it was developed on and for a Dell Latitude C600, but lowkey it doesn't rely on any specific properties of that machine, so don't stress if you're not on a C600.

by default, the command line utility guides you through the hotswapping process interactively 💖 it's also possible to specify an ACTION, for example unregistering the current device, rescanning the IDE bus, &c. this feature is primarily intended for use with scripts and GUI frontends such as xhotswap(1). iykyk ✨

and here's the slay part: by using an XML configuration file, system administrators can specify arbitrary shell scripts to be run before and after registering and unregistering devices 🎀 this is particularly helpful for automatic configuration of CD-RW drives, which require SCSI emulation and bypass normal access via the IDE subsystem. by default, the configuration file is located at /etc/hotswaprc; its syntax is described in hotswaprc(5). periodt 💅

⭐ OPTIONS ⭐

the program follows the usual GNU command line syntax, with long options starting with two dashes (`-`).

  • -c, --ide-controller N — use IDE controller N. 🎀
  • -h, --help — print a brief help text and exit successfully. bestie behaviour fr fr 🫶
  • -n, --nocheck — do not perform sanity checks before attempting an action. > use with care, as this option may cause some steps to fail silently. 💀
  • -v, --verbose — print more information. we love a chatty king 👑
  • -V, --version — print version information and exit successfully. ✨

🌈 ACTIONS 🌈

besides the above options, the program allows you to specify one of the following actions on the command line:

  • probe-ide — detect the currently configured IDE device. 🔍
  • mounted-ide — detect whether a file system on the currently configured IDE device is mounted. 🧚
  • unregister-ide — unregister the currently configured IDE device. bye bye 👋
  • rescan-ide — scan the IDE bus for a new device. if a device has been found, register it with the kernel. main character energy 🔥

if no ACTION is specified, interactive mode is entered 💖 in this mode the program guides you through the hotswapping process as appropriate for the current configuration. so cozy 🥰

🦋 NOTES 🦋

  • there is generally no need to manage floppy disk devices. the FDC is always present and configured. floppy disk drives do not connect to the IDE controller, even if they come in the same modules as IDE devices and use the same connector. wild, right? 😭
  • the Linux kernel requires hotswappable devices to be the only device connected to their IDE controller. no sharing besties 🙈
  • the mounted-ide action assumes file systems have been mounted as /dev/hdc. if this is not the case (i.e., you've used a symbolic link such as /dev/cdrom) the command will not work. 💀
okay that last one is a whole vibe check fail waiting to happen, so double-check your mounts before you come for this command, bestie 🫶

🍓 FILES 🍓

  • /etc/hotswaprc — the default location for the XML configuration file. 📁✨

😭 REPORT BUGS 😭

report bugs to t.stadelmann1@physics.ox.ac.uk. be nice, they're doing their best 💜

👑 AUTHOR 👑

written by Tim Stadelmann.

this manual page is based on an earlier version kindly contributed by Wouter Verhelst. iconic collaboration fr fr 🤝

🌟 SEE ALSO 🌟

xhotswap(1), hdparm(8), hotswaprc(5).

copyright (c) 2002-2003 Wouter Verhelst, Tim Stadelmann.

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License (GPL), Version 2 or any later version published by the Free Software Foundation. slay, legally speaking 💖

and that's the whole page, bestie!! this one dropped on 4th November 2002 and it lives in the HOTSWAP(1) section of the manual — go hotswap something responsibly, mwah 💅✨🦋

📦 where this page comes from