Commands

Documentation / Contents - Removable Media

• Overview of Removable Media
  • What It Is Not
  • The Two Programs
  • In This Book
• Setting Up the Daemon
  • What You Need
  • Build and Install
  • Privilege Hop
  • Media Directories
  • Start the Daemon
  • Check That It Works
  • Common Mistakes
• How the Daemon Works
  • What It Does Each Poll
  • Pidfile and One Instance
  • Without Privilege
  • Stopping
• Commands
  • Everyday Commands
  • Mount Eject and Chest
  • Environment
• CyDrive
  • Opening CyDrive
  • The List
  • Open Mount Eject
• Files and Paths
  • The Ledger
  • Mount Points
  • Helper
• Copyright

Commands

cymount is a multi-command binary. Summary:

cymount <command> [args]
cymount --daemon
cymount --notify
cymount --selftest
cymount --help | --version

Full detail: man cymount.

Everyday Commands

discover              candidates only, no mount
scan                  discover + automount; update ledger
list                  print ledger
status                media roots, helper, privilege, daemon
ensure-media-root     create /media and /media/$USER if needed
setup-privilege       install helper / least-priv pieces

Mount Eject and Chest

mount <device>        mount one block device into the namespace
unmount <id|path>     unmount only
eject <id|path|dev>   unmount + eject / safe-remove
eject-media           Toolchest Eject Media policy (0 / 1 / many)

eject-media with no media opens CyDrive (or reports nothing). One volume ejects it. Several volumes open CyDrive so you can choose.

Environment

CYMOUNT_MOUNT_ROOT    override /media/$USER (tests)
CYMOUNT_STATE         override ledger path (tests)
CYMOUNT_HELPER        path to cymount-helper
CYMOUNT_ASK=1         interactive doas/sudo (not for --daemon)

See Also

• Setting Up the Daemon
• Files and Paths