usrmnt

A small utility to mount devices from the command line.
git clone https://git.sr.ht/~jbauer/usrmnt
Log | Files | Refs | README | LICENSE

README.md (1905B)


      1 # usrmnt
      2 
      3 [The webpage for this project.](https://www.paritybit.ca/projects/usrmnt)
      4 
      5 usrmnt is a small utility to mount, unmount, unlock, etc. your devices from the
      6 command line with an intuitive command syntax and using an intuitive text-based
      7 UI. It is effectively a wrapper for udisksctl to make it more friendly to use.
      8 
      9 ## Installation
     10 
     11 Simply clone this repository and copy the `usrmnt` script to a folder that is in
     12 your `PATH`.
     13 
     14 ## Usage
     15 
     16 Simply run the script with no arguments: usrmnt. You will then be presented with
     17 a listing of the currently recognized devices in your computer and a command
     18 prompt. The usage of that command prompt is detailed below:
     19 
     20 ```
     21 Options:
     22 ls – List the currently recognized devices
     23 q  – Exit
     24 v  – Print the current version
     25 ?  – Print this help dialog
     26 <command> <device> – Execute <command> on <device> where <command> is one of:
     27 Supported udisks Commands:
     28 mount     – Mount a device to a mountpoint in /media. Will prompt to
     29 unlock encrypted drives.
     30 unmount   – Unmount a device (can also use "umount")
     31 lock      – Lock an unlocked encrypted device
     32 unlock    – Unlock an encrypted device without mounting it
     33 info      – Print device info
     34 power-off – Power a device off (computer will stop recognizing it)
     35 (can also use "poweroff")
     36 Examples:
     37 ()>>> mount sdc1
     38 (sdc1)>>> unmount sdb2
     39 (sdb2)>>> unlock mmcblk0p1
     40 
     41 The device in parentheses is the device from the previous command.
     42 When there is a device in parentheses, you can type any command without
     43 specifying a device name and that command will act on the device in
     44 parentheses. The device in parentheses is only updated when the previous
     45 command completed successfully except if you are unlocking a device, it
     46 exists, and you get the password wrong in which case it will still update
     47 so you can just type "unlock" or "mount" again.
     48 
     49 For example:
     50 (sdb1)>>> unmount
     51 will unmount /dev/sdb1.
     52 ```