Update cheatsheets

tldr/linux/libuser-lid

@@ -5,14 +5,8 @@ source: https://github.com/tldr-pages/tldr.git
 ---
 # libuser-lid
 
-> Display a user's groups or a group's users.
+> This command is an alias of `lid`.
-> On Fedora and Arch Linux, this program is installed as `lid`.
-> More information: <https://manned.org/lid.8>.
 
-- List primary and secondary groups of a specific user:
+- View documentation for the original command:
 
-`sudo lid {{username}}`
+`tldr lid.libuser`
-
-- List users of a specific group:
-
-`sudo lid --group {{name}}`

tldr/linux/lid

@@ -5,11 +5,12 @@ source: https://github.com/tldr-pages/tldr.git
 ---
 # lid
 
-> Note: This page is currently a redirection stub. If you are familiar with this program, please open a pull request.
+> `lid` can refer to multiple commands with the same name.
-> Query ID database and report results.
-> On Fedora and Arch Linux, the binary name `lid` is taken by another program - see `tldr libuser-lid`.
-> More information: <https://www.gnu.org/software/idutils/>.
 
-- View documentation for `libuser-lid`:
+- View documentation for the `libuser` tool:
 
-`tldr libuser-lid`
+`tldr lid.libuser`
+
+- View documentation for the `idutils` tool:
+
+`tldr lid.idutils`

tldr/linux/lid.libuser

@@ -0,0 +1,17 @@
+---
+syntax: markdown
+tags: [tldr, linux]
+source: https://github.com/tldr-pages/tldr.git
+---
+# lid
+
+> Display a user's groups or a group's users.
+> More information: <https://manned.org/lid.8>.
+
+- List primary and secondary groups of a specific user:
+
+`sudo lid {{username}}`
+
+- List users of a specific group:
+
+`sudo lid --group {{name}}`

tldr/linux/lxc-top

@@ -0,0 +1,21 @@
+---
+syntax: markdown
+tags: [tldr, linux]
+source: https://github.com/tldr-pages/tldr.git
+---
+# lxc-top
+
+> Display resource usage of LXC containers.
+> More information: <https://linuxcontainers.org/lxc/manpages/man1/lxc-top.1.html>.
+
+- Start `lxc-top`:
+
+`lxc-top`
+
+- Adjust update interval:
+
+`lxc-top {{[-d|--delay]}} {{5}}`
+
+- Sort by [n]ame, [c]pu use, [b]lock I/O, [m]emory, or [k]ernel memory:
+
+`lxc-top {{[-s|--sort]}} {{n|c|b|m|k}}`

tldr/linux/mount.ddi

@@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 > Mount Discoverable Disk Images.
 > See also: `systemd-dissect` for other commands relevant to DDIs.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemd-dissect.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemd-dissect.html>.
 
 - Mount an OS image:
 

tldr/linux/nmcli-agent

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli agent
 
 > Run `nmcli` as a NetworkManager secret agent or polkit agent.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#agent>.
 
 - Register `nmcli` as a secret agent and listen for secret requests:
 

tldr/linux/nmcli-connection

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli connection
 
 > Manage connections with NetworkManager.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#connection>.
 
 - List all NetworkManager connections (shows name, UUID, type and device):
 

tldr/linux/nmcli-device

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli device
 
 > Manage network interfaces and establish new Wi-Fi connections using NetworkManager.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#device>.
 
 - Print the statuses of all network interfaces:
 

tldr/linux/nmcli-general

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli general
 
 > Manage general settings of NetworkManager.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#general>.
 
 - Show the general status of NetworkManager:
 

tldr/linux/nmcli-monitor

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli monitor
 
 > Monitor changes to the NetworkManager connection status.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#monitor>.
 
 - Start monitoring NetworkManager changes:
 

tldr/linux/nmcli-networking

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli networking
 
 > Manage the networking status of NetworkManager.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#networking>.
 
 - Show the networking status of NetworkManager:
 

tldr/linux/nmcli-radio

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # nmcli radio
 
 > Show the status of radio switches or enable/disable them using NetworkManager.
-> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
+> More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html#radio>.
 
 - Show status of Wi-Fi:
 

tldr/linux/partclone

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # partclone
 
 > Copy and restore partitions to and from an image while disregarding empty blocks.
-> More information: <https://manned.org/a2disconf.8>.
+> More information: <https://manned.org/partclone>.
 
 - Copy a partition into an image:
 

tldr/linux/pct-clone

@@ -14,4 +14,4 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Clone a container with a custom name:
 
-`pct clone {{template_id}} {{copy_id}} --hostname {{host_name}}`
+`pct {{[cl|clone]}} {{template_id}} {{copy_id}} --hostname {{host_name}}`

tldr/linux/pct-template

@@ -10,4 +10,4 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Convert a container into a template:
 
-`pct template {{100}}`
+`pct {{[t|template]}} {{100}}`

tldr/linux/pve-firewall

@@ -10,15 +10,15 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Compile and print all firewall rules:
 
-`pve-firewall compile`
+`pve-firewall {{[c|compile]}}`
 
 - Show information about the local network:
 
-`pve-firewall localnet`
+`pve-firewall {{[l|localnet]}}`
 
 - Restart the Proxmox VE Firewall service:
 
-`pve-firewall restart`
+`pve-firewall {{[r|restart]}}`
 
 - Start the Proxmox VE Firewall service:
 
@@ -30,7 +30,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Simulate all firewall rules:
 
-`pve-firewall simulate`
+`pve-firewall {{[si|simulate]}}`
 
 - Show the status of Proxmox VE Firewall:
 

tldr/linux/pveam

@@ -10,16 +10,16 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Update container template database:
 
-`pveam update`
+`pveam {{[u|update]}}`
 
 - List available templates:
 
-`pveam available`
+`pveam {{[a|available]}}`
 
 - Download a template:
 
-`pveam download {{local}} {{template_name}}`
+`pveam {{[d|download]}} {{local}} {{template_name}}`
 
 - List downloaded templates:
 
-`pveam list {{local}}`
+`pveam {{[l|list]}} {{local}}`

tldr/linux/pvecm

@@ -14,24 +14,24 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Add a node to the cluster configuration (internal use):
 
-`pvecm addnode {{node}}`
+`pvecm {{[addn|addnode]}} {{node}}`
 
 - Display the version of the cluster join API available on this node:
 
-`pvecm apiver`
+`pvecm {{[ap|apiver]}}`
 
 - Generate new cluster configuration:
 
-`pvecm create {{clustername}}`
+`pvecm {{[c|create]}} {{clustername}}`
 
 - Remove a node from the cluster configuration:
 
-`pvecm delnode {{node}}`
+`pvecm {{[d|delnode]}} {{node}}`
 
 - Display the local view of the cluster nodes:
 
-`pvecm nodes`
+`pvecm {{[n|nodes]}}`
 
 - Display the local view of the cluster status:
 
-`pvecm status`
+`pvecm {{[s|status]}}`

tldr/linux/pvesh

@@ -10,8 +10,8 @@ source: https://github.com/tldr-pages/tldr.git
 
 - List available nodes:
 
-`pvesh get /nodes`
+`pvesh {{[g|get]}} /nodes`
 
 - Discover API paths:
 
-`pvesh ls {{/}}`
+`pvesh {{[l|ls]}} {{/}}`

tldr/linux/pvesm

@@ -10,16 +10,16 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Get status for all datastores:
 
-`pvesm status`
+`pvesm {{[st|status]}}`
 
 - List storage contents:
 
-`pvesm list {{storage_name}}`
+`pvesm {{[l|list]}} {{storage_name}}`
 
 - Add a directory storage:
 
-`pvesm add dir {{storage_name}} --path {{path/to/directory}}`
+`pvesm add {{[d|dir]}} {{storage_name}} --path {{path/to/directory}}`
 
 - Remove a storage:
 
-`pvesm remove {{storage_name}}`
+`pvesm {{[r|remove]}} {{storage_name}}`

tldr/linux/pveum

@@ -10,12 +10,12 @@ source: https://github.com/tldr-pages/tldr.git
 
 - List users:
 
-`pveum user list`
+`pveum {{[u|user]}} {{[l|list]}}`
 
 - Add a user:
 
-`pveum user add {{username}}@pve`
+`pveum {{[u|user]}} {{[a|add]}} {{username}}@pve`
 
 - Delete a user:
 
-`pveum user delete {{username}}@pve`
+`pveum {{[u|user]}} {{[d|delete]}} {{username}}@pve`

tldr/linux/qm-disk-rescan

@@ -10,8 +10,8 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Rescan all storages and update disk sizes and unused disk images of a specific virtual machine:
 
-`qm disk rescan {{vm_id}}`
+`qm {{[di|disk]}} {{[resc|rescan]}} {{vm_id}}`
 
 - Perform a dry-run of rescan on a specific virtual machine and do not write any changes to configurations:
 
-`qm disk rescan --dryrun {{true}} {{vm_id}}`
+`qm {{[di|disk]}} {{[resc|rescan]}} --dryrun {{true}} {{vm_id}}`

tldr/linux/qm-list

@@ -10,8 +10,8 @@ source: https://github.com/tldr-pages/tldr.git
 
 - List all virtual machines:
 
-`qm list`
+`qm {{[l|list]}}`
 
 - List all virtual machines with a full status about the ones which are currently running:
 
-`qm list --full 1`
+`qm {{[l|list]}} --full 1`

tldr/linux/qm-terminal

@@ -10,7 +10,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Attach to a terminal:
 
-`qm terminal {{100}}`
+`qm {{[ter|terminal]}} {{100}}`
 
 - Detach from a terminal:
 

tldr/linux/repo-add

@@ -6,13 +6,18 @@ source: https://github.com/tldr-pages/tldr.git
 # repo-add
 
 > Package database maintenance utility which enables installation of said package via Pacman.
+> See also: `repo-remove`.
 > More information: <https://manned.org/repo-add>.
 
 - Create an empty repository:
 
 `repo-add {{path/to/database.db.tar.gz}}`
 
-- Add all package binaries in the current directory and remove the old database file:
+- Add packages to the repository:
+
+`repo-add {{path/to/database.db.tar.gz}} {{package1.pkg.tar.zst package2.pkg.tar.zst ...}}`
+
+- Add all package binaries in the current directory and remove any outdated package files:
 
 `repo-add {{[-R|--remove]}} {{path/to/database.db.tar.gz}} {{*.pkg.tar.zst}}`
 

tldr/linux/repo-remove

@@ -6,6 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # repo-remove
 
 > Package database maintenance utility which removes packages from a local repository.
+> See also: `repo-add`.
 > More information: <https://manned.org/repo-add>.
 
 - Remove a package from a local repository:

tldr/linux/run0

@@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 > Elevate privileges interactively.
 > Similar to `sudo`, but it's not a SUID binary, authentication takes place via polkit, and commands are invoked from a `systemd` service.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/run0.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/run0.html>.
 
 - Run a command as root:
 

tldr/linux/systemctl-disable

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # systemctl disable
 
 > Disable systemd services.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemctl.html#disable%20UNIT%E2%80%A6>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemctl.html#disable%20UNIT%E2%80%A6>.
 
 - Stop a service from running on boot:
 

tldr/linux/systemctl-enable

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # systemctl enable
 
 > Enable systemd services.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemctl.html#enable%20UNIT%E2%80%A6>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemctl.html#enable%20UNIT%E2%80%A6>.
 
 - Enable a service to run on boot:
 

tldr/linux/systemd-cgtop

@@ -15,11 +15,11 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Change the sort order:
 
-`systemd-cgtop {{[-i|--order]}} {{cpu|memory|path|tasks|io}}`
+`systemd-cgtop --order {{cpu|memory|path|tasks|io}}`
 
 - Show the CPU usage by time instead of percentage:
 
-`systemd-cgtop --cpu percentage`
+`systemd-cgtop --cpu=percentage`
 
 - Change the update interval in seconds (or one of these time units: `ms`, `us`, `min`):
 

tldr/linux/systemd-cryptsetup

@@ -8,7 +8,7 @@ source: https://github.com/tldr-pages/tldr.git
 > Create or remove decrypted mappings of encrypted volumes. Equivalent of `cryptsetup open` and `cryptsetup close`.
 > Arguments to this command are written exactly like a line in `/etc/crypttab`. It's used by systemd to unlock devices on boot.
 > See also: `cryptsetup`.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemd-cryptsetup.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemd-cryptsetup.html>.
 
 - Open a LUKS volume and create a decrypted mapping at `/dev/mapper/mapping_name`:
 

tldr/linux/systemd-dissect

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # systemd-dissect
 
 > Introspect and interact with file system OS disk images, specifically Discoverable Disk Images (DDIs).
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemd-dissect.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemd-dissect.html>.
 
 - Show general image information about the OS image:
 

tldr/linux/systemd-nspawn

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # systemd-nspawn
 
 > Spawn a command or OS in a lightweight container.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemd-nspawn.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemd-nspawn.html>.
 
 - Run a command in a container:
 

tldr/linux/systemd-socket-activate

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # systemd-socket-activate
 
 > Socket activation for systemd services.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemd-socket-activate.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemd-socket-activate.html>.
 
 - Activate a service when a specific socket is connected:
 

tldr/linux/systemd-stdio-bridge

@@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 > Implement a proxy between `stdin`/`stdout` and a D-Bus.
 > Note: It expects to receive an open connection via `stdin`/`stdout` when started, and will create a new connection to the specified bus.
-> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemd-stdio-bridge.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/systemd-stdio-bridge.html>.
 
 - Forward `stdin`/`stdout` to the local system bus:
 

tldr/linux/updatectl

@@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git
 # updatectl
 
 > System update utility.
-> More information: <https://www.freedesktop.org/software/systemd/man/257/updatectl.html>.
+> More information: <https://www.freedesktop.org/software/systemd/man/updatectl.html>.
 
 - Apply an update:
 

tldr/php

@@ -26,7 +26,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Start a PHP built-in web [S]erver in the current directory:
 
-`php {{[-S|--server]}} {{host:port}}`
+`php {{[-S|--server]}} {{host}}:{{port}}`
 
 - List installed PHP extensions:
 

tldr/rmdir

@@ -16,3 +16,7 @@ source: https://github.com/tldr-pages/tldr.git
 - Remove specific nested directories recursively:
 
 `rmdir {{[-p|--parents]}} {{path/to/directory1 path/to/directory2 ...}}`
+
+- Clean a directory of empty directories:
+
+`rmdir *`

tldr/sr

@@ -0,0 +1,12 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# sr
+
+> This command is an alias of `surfraw`.
+
+- View documentation for the original command:
+
+`tldr surfraw`

tldr/surfraw

@@ -15,20 +15,20 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Open the elvi's results page for a specific search in the browser:
 
-`surfraw {{elvi}} "{{search_terms}}"`
+`surfraw {{elvi_name}} "{{search_terms}}"`
 
 - Display an elvi description and its specific options:
 
-`surfraw {{elvi}} -local-help`
+`surfraw {{elvi_name}} {{[-lh|-local-help]}}`
 
 - Search using an elvi with specific options and open the results page in the browser:
 
-`surfraw {{elvi}} {{elvi_options}} "{{search_terms}}"`
+`surfraw {{elvi_name}} {{elvi_options}} "{{search_terms}}"`
 
 - Display the URL to the elvi's results page for a specific search:
 
-`surfraw -print {{elvi}} "{{search_terms}}"`
+`surfraw -print {{elvi_name}} "{{search_terms}}"`
 
 - Search using the alias:
 
-`sr {{elvi}} "{{search_terms}}"`
+`sr {{elvi_name}} "{{search_terms}}"`