Add commands

Author: SimonSchubert

assets/commands/lpinfo.md

@@ -0,0 +1,86 @@
+# TLDR
+
+**List available printers**
+
+```lpinfo -v```
+
+**List available printer drivers**
+
+```lpinfo -m```
+
+**List drivers matching keyword**
+
+```lpinfo -m | grep -i [keyword]```
+
+**Show long printer names**
+
+```lpinfo -l -v```
+
+**List drivers for specific make**
+
+```lpinfo --make-and-model "[HP LaserJet]" -m```
+
+**Exclude specific schemes**
+
+```lpinfo -v --exclude-schemes [dnssd]```
+
+**Include only specific schemes**
+
+```lpinfo -v --include-schemes [usb,parallel]```
+
+# SYNOPSIS
+
+**lpinfo** [_-l_] [_-m_] [_-v_] [_--make-and-model pattern_] [_options_]
+
+# PARAMETERS
+
+**-l**
+> Show long listing with device details.
+
+**-m**
+> List available printer drivers (PPD files).
+
+**-v**
+> List available printer devices.
+
+**--device-id** _ID_
+> Show only devices matching IEEE-1284 device ID.
+
+**--make-and-model** _PATTERN_
+> Filter by make and model string.
+
+**--exclude-schemes** _SCHEMES_
+> Exclude device URIs matching schemes.
+
+**--include-schemes** _SCHEMES_
+> Include only device URIs matching schemes.
+
+**-h** _SERVER_
+> Connect to CUPS server.
+
+**--timeout** _SECONDS_
+> Timeout for device discovery.
+
+# DESCRIPTION
+
+**lpinfo** lists available printers and printer drivers known to CUPS. It queries the CUPS server for devices and PPD (PostScript Printer Description) files.
+
+Device listing (-v) shows all detected printer connections including USB, network, and parallel ports. Each entry includes a device URI that can be used when adding printers with lpadmin.
+
+Driver listing (-m) shows PPD files that describe printer capabilities. PPDs define paper sizes, resolutions, color options, and other features. Driverless printing uses generic IPP Everywhere or AirPrint drivers.
+
+The make-and-model filter helps find drivers for specific printers. Combined with grep, you can search for compatible drivers for your hardware.
+
+Network printer discovery may include DNS-SD (Bonjour/Avahi) discovered printers. Use scheme filters to focus on specific connection types.
+
+# CAVEATS
+
+Requires CUPS to be running. Network discovery can be slow. Some printers need proprietary drivers not included with CUPS. Driverless printing requires modern printers with IPP Everywhere or AirPrint support.
+
+# HISTORY
+
+**lpinfo** is part of the **CUPS** (Common UNIX Printing System) suite, originally developed by **Michael Sweet** at Easy Software Products. CUPS was released in **1999** and acquired by **Apple** in **2007**. lpinfo provides the discovery mechanism used by print configuration tools.
+
+# SEE ALSO
+
+[lpadmin](/man/lpadmin)(1), [lpstat](/man/lpstat)(1), [lp](/man/lp)(1), [lpr](/man/lpr)(1), [cupsd](/man/cupsd)(8)

assets/commands/lsar.md

@@ -0,0 +1,89 @@
+# TLDR
+
+**List archive contents**
+
+```lsar [archive.zip]```
+
+**List with detailed info**
+
+```lsar -l [archive.rar]```
+
+**List very long format**
+
+```lsar -L [archive.7z]```
+
+**Test archive integrity**
+
+```lsar -t [archive.zip]```
+
+**List with password**
+
+```lsar -p [password] [encrypted.zip]```
+
+**List specific encoding**
+
+```lsar -e [shift_jis] [japanese.zip]```
+
+**Print only filenames**
+
+```lsar -1 [archive.tar.gz]```
+
+# SYNOPSIS
+
+**lsar** [_-l_] [_-L_] [_-t_] [_-p password_] [_-e encoding_] [_archive_]
+
+# PARAMETERS
+
+**-l**
+> Long listing with size, date, permissions.
+
+**-L**
+> Very long listing with extra details.
+
+**-t**
+> Test archive integrity.
+
+**-p** _PASSWORD_
+> Specify password for encrypted archives.
+
+**-e** _ENCODING_
+> Force character encoding for filenames.
+
+**-1**
+> Print only filenames, one per line.
+
+**-j**
+> Output as JSON.
+
+**-q**
+> Quiet mode.
+
+**-nr**
+> Don't recurse into nested archives.
+
+**-h**, **--help**
+> Show help.
+
+# DESCRIPTION
+
+**lsar** lists the contents of archive files. It supports a wide variety of formats including Zip, RAR, 7-Zip, tar, gzip, bzip2, ISO, and many legacy formats.
+
+The tool is part of The Unarchiver suite. While unar extracts files, lsar provides inspection without extraction. It handles archives that standard tools may fail on, including corrupted or non-standard archives.
+
+Encoding detection handles international filenames automatically. For archives with mislabeled encodings, the -e flag forces specific character sets like Shift_JIS, GBK, or EUC-KR.
+
+Long listing shows file sizes (compressed and uncompressed), modification dates, and permissions where available. The test mode (-t) verifies archive integrity without extracting.
+
+JSON output enables scripting and integration with other tools.
+
+# CAVEATS
+
+Not installed by default on most systems - requires The Unarchiver package. Some formats may have limited metadata support. Encrypted RAR5 archives require specific builds.
+
+# HISTORY
+
+**lsar** is part of **The Unarchiver**, created by **Dag Ågren** starting around **2006**. Originally a macOS application, command-line tools were added later. The project focuses on compatibility with many archive formats and proper handling of international filenames.
+
+# SEE ALSO
+
+[unar](/man/unar)(1), [unzip](/man/unzip)(1), [tar](/man/tar)(1), [7z](/man/7z)(1), [unrar](/man/unrar)(1)

assets/commands/lstopo.md

@@ -0,0 +1,99 @@
+# TLDR
+
+**Show hardware topology**
+
+```lstopo```
+
+**Display in terminal** (text mode)
+
+```lstopo-no-graphics```
+
+**Output as image**
+
+```lstopo [topology.png]```
+
+**Output as PDF**
+
+```lstopo [topology.pdf]```
+
+**Output as XML**
+
+```lstopo [topology.xml]```
+
+**Show only CPU info**
+
+```lstopo --only core```
+
+**Show with PCI devices**
+
+```lstopo --whole-io```
+
+**Show physical indexes**
+
+```lstopo -p```
+
+# SYNOPSIS
+
+**lstopo** [_--of format_] [_--only type_] [_--whole-io_] [_options_] [_output_]
+
+# PARAMETERS
+
+**--of** _FORMAT_
+> Output format (png, pdf, svg, xml, txt, console).
+
+**--only** _TYPE_
+> Show only specific object types.
+
+**--whole-io**
+> Show all I/O devices.
+
+**--no-io**
+> Hide I/O devices.
+
+**-p**, **--physical**
+> Show physical/OS indexes.
+
+**-l**, **--logical**
+> Show logical indexes.
+
+**--merge**
+> Merge identical objects.
+
+**--no-legend**
+> Hide the legend.
+
+**--no-caches**
+> Hide cache information.
+
+**-v**, **--verbose**
+> Verbose output.
+
+**--input** _FILE_
+> Read topology from XML file.
+
+**--version**
+> Print version.
+
+# DESCRIPTION
+
+**lstopo** displays hardware topology including CPUs, caches, memory, and I/O devices. It visualizes the hierarchical structure of the system from machine level down to individual cores and threads.
+
+The output shows NUMA nodes, packages (sockets), cores, and processing units (threads). Cache levels (L1, L2, L3) are displayed with their sizes and sharing between cores.
+
+Graphical output creates images showing the topology tree. Text mode (lstopo-no-graphics) works in terminals without graphics support.
+
+Understanding topology is important for performance optimization. It shows which cores share caches, which are on the same NUMA node, and how memory is organized.
+
+The tool can load topology from XML files, enabling offline analysis or comparison between systems.
+
+# CAVEATS
+
+Graphical output requires Cairo/X11 libraries. Some virtual environments may show incorrect topology. Root access may be needed for complete I/O device information.
+
+# HISTORY
+
+**lstopo** is part of **hwloc** (Hardware Locality), developed by the **Open MPI** project starting around **2009**. hwloc provides a portable abstraction for hardware topology across different operating systems. lstopo evolved from earlier tools in the project.
+
+# SEE ALSO
+
+[hwloc-info](/man/hwloc-info)(1), [hwloc-bind](/man/hwloc-bind)(1), [lscpu](/man/lscpu)(1), [numactl](/man/numactl)(8)

assets/commands/lsyncd.md

@@ -0,0 +1,85 @@
+# TLDR
+
+**Sync directories locally**
+
+```lsyncd -rsync [/source/] [/destination/]```
+
+**Sync to remote server**
+
+```lsyncd -rsyncssh [/local/] [user@host] [/remote/]```
+
+**Use configuration file**
+
+```lsyncd [config.lua]```
+
+**Run in foreground with logging**
+
+```lsyncd -log all [config.lua]```
+
+**Dry run** (show what would sync)
+
+```lsyncd -nodaemon -log all [config.lua]```
+
+**Specify log file**
+
+```lsyncd -logfile [/var/log/lsyncd.log] [config.lua]```
+
+# SYNOPSIS
+
+**lsyncd** [_-rsync source dest_] [_-rsyncssh source host dest_] [_-log level_] [_options_] [_config.lua_]
+
+# PARAMETERS
+
+**-rsync** _SOURCE_ _DEST_
+> Simple rsync sync mode.
+
+**-rsyncssh** _SOURCE_ _HOST_ _DEST_
+> Rsync over SSH to remote host.
+
+**-nodaemon**
+> Run in foreground, don't daemonize.
+
+**-log** _LEVEL_
+> Set log level (all, scarce, normal, error).
+
+**-logfile** _FILE_
+> Write logs to file.
+
+**-pidfile** _FILE_
+> Write PID file.
+
+**-delay** _SECONDS_
+> Delay before syncing (aggregation window).
+
+**-insist**
+> Keep trying on startup errors.
+
+**-version**
+> Show version.
+
+**-help**
+> Show help.
+
+# DESCRIPTION
+
+**lsyncd** (Live Syncing Daemon) watches directories for changes and synchronizes them in real-time. It uses inotify on Linux to detect file changes efficiently.
+
+When changes occur, lsyncd waits briefly (delay) to aggregate multiple changes, then triggers rsync to synchronize. This approach handles burst writes efficiently while maintaining near-real-time sync.
+
+Configuration files use Lua scripting for flexibility. They define sync pairs, exclude patterns, rsync options, and can implement custom sync logic.
+
+The tool works with both local directories and remote servers via SSH. Multiple sync pairs can run simultaneously from a single configuration.
+
+Common uses include backup systems, cluster file synchronization, and development environments where files need to stay synchronized across machines.
+
+# CAVEATS
+
+Initial sync can take time for large directories. Inotify watch limits may need increasing for large trees. High-frequency changes can cause delays. Symlinks and special files need careful handling.
+
+# HISTORY
+
+**lsyncd** was created by **Axel Kittenberger** around **2008**. It combined inotify's efficient change notification with rsync's reliable file synchronization. The project introduced Lua configuration in version 2, enabling sophisticated sync scenarios.
+
+# SEE ALSO
+
+[rsync](/man/rsync)(1), [inotifywait](/man/inotifywait)(1), [unison](/man/unison)(1), [syncthing](/man/syncthing)(1)