diff --git a/tldr/abduco b/tldr/abduco index 5bde0de8..65ed9434 100644 --- a/tldr/abduco +++ b/tldr/abduco @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # abduco > Terminal session manager. -> More information: . +> More information: . - List sessions: diff --git a/tldr/astyle b/tldr/astyle index cd0fde92..192113c2 100644 --- a/tldr/astyle +++ b/tldr/astyle @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Source code indenter, formatter, and beautifier for the C, C++, C# and Java programming languages. > Upon running, a copy of the original file is created with an ".orig" appended to the original file name. -> More information: . +> More information: . - Apply the default style of 4 spaces per indent and no formatting changes: diff --git a/tldr/atoum b/tldr/atoum index bacf8357..27acf707 100644 --- a/tldr/atoum +++ b/tldr/atoum @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # atoum > A simple, modern and intuitive unit testing framework for PHP. -> More information: . +> More information: . - Initialize a configuration file: diff --git a/tldr/blockout2 b/tldr/blockout2 index 65e2142d..f8bbc23a 100644 --- a/tldr/blockout2 +++ b/tldr/blockout2 @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # blockout2 > Tetris like game in 3D. -> More information: . +> More information: . - Start a new game: diff --git a/tldr/cppcheck b/tldr/cppcheck index 63a7050b..12dccde7 100644 --- a/tldr/cppcheck +++ b/tldr/cppcheck @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > A static analysis tool for C/C++ code. > Instead of syntax errors, it focuses on the types of bugs that compilers normally do not detect. -> More information: . +> More information: . - Recursively check the current directory, showing progress on the screen and logging error messages to a file: diff --git a/tldr/dcfldd b/tldr/dcfldd index 921ef149..a3f02511 100644 --- a/tldr/dcfldd +++ b/tldr/dcfldd @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # dcfldd > Enhanced version of dd for forensics and security. -> More information: . +> More information: . - Copy a disk to a raw image file and hash the image using SHA256: diff --git a/tldr/doxygen b/tldr/doxygen index 7921ce17..b4f867a5 100644 --- a/tldr/doxygen +++ b/tldr/doxygen @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # doxygen > A documentation system for various programming languages. -> More information: . +> More information: . - Generate a default template configuration file `Doxyfile`: diff --git a/tldr/duplicity b/tldr/duplicity index 95249167..6d0a0a9d 100644 --- a/tldr/duplicity +++ b/tldr/duplicity @@ -8,7 +8,7 @@ source: https://github.com/tldr-pages/tldr.git > Create incremental, compressed, encrypted and versioned backups. > Can also upload the backups to a variety of backend services. > It is worth mentioning that depending on the version, some options may not be available (e.g. `--gio` in 2.0.0). -> More information: . +> More information: . - Backup a directory via FTPS to a remote machine, encrypting it with a password: diff --git a/tldr/entr b/tldr/entr index 82860ec7..16c68a38 100644 --- a/tldr/entr +++ b/tldr/entr @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # entr > Run arbitrary commands when files change. -> More information: . +> More information: . - Rebuild with `make` if any file in any subdirectory changes: diff --git a/tldr/espeak b/tldr/espeak index 53f0fd2f..75826aa2 100644 --- a/tldr/espeak +++ b/tldr/espeak @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # espeak > Uses text-to-speech to speak through the default sound device. -> More information: . +> More information: . - Speak a phrase aloud: diff --git a/tldr/f3fix b/tldr/f3fix index d7e3aecb..ecab9469 100644 --- a/tldr/f3fix +++ b/tldr/f3fix @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Edit the partition table of a fake flash drive. > See also: `f3probe`, `f3write`, `f3read`. -> More information: . +> More information: . - Fill a fake flash drive with a single partition that matches its real capacity: diff --git a/tldr/f3read b/tldr/f3read index bf1b6a3f..63011b7d 100644 --- a/tldr/f3read +++ b/tldr/f3read @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Validate .h2w files to test the real capacity of the drive. > See also: `f3write`, `f3probe`, `f3fix`. -> More information: . +> More information: . - Validate a device by checking the files in a given directory: diff --git a/tldr/f3write b/tldr/f3write index 5f303c05..abe3b334 100644 --- a/tldr/f3write +++ b/tldr/f3write @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Fill a drive out with .h2w files to test its real capacity. > See also: `f3read`, `f3probe`, `f3fix`. -> More information: . +> More information: . - Write test files to a given directory, filling the drive: diff --git a/tldr/ffe b/tldr/ffe index a789578b..62c5429f 100644 --- a/tldr/ffe +++ b/tldr/ffe @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Extract fields from a flat database file and write to another format. > A configuration file is required to interpret the input and format the output. -> More information: . +> More information: . - Display all input data using the specified data configuration: diff --git a/tldr/freebsd/base64 b/tldr/freebsd/base64 new file mode 100644 index 00000000..67622d0b --- /dev/null +++ b/tldr/freebsd/base64 @@ -0,0 +1,33 @@ +--- +syntax: markdown +tags: [tldr, freebsd] +source: https://github.com/tldr-pages/tldr.git +--- +# base64 + +> Encode or decode file or `stdin` to/from base64, to `stdout` or another file. +> More information: . + +- Encode a file to `stdout`: + +`base64 {{-i|--input}} {{path/to/file}}` + +- Encode a file to the specified output file: + +`base64 {{-i|--input}} {{path/to/input_file}} {{-o|--output}} {{path/to/output_file}}` + +- Wrap encoded output at a specific width (`0` disables wrapping): + +`base64 {{-b|--break}} {{0|76|...}} {{path/to/file}}` + +- Decode a file to `stdout`: + +`base64 {{-d|--decode}} {{-i|--input}} {{path/to/file}}` + +- Encode from `stdin` to `stdout`: + +`{{command}} | base64` + +- Decode from `stdin` to `stdout`: + +`{{command}} | base64 {{-d|--decode}}` diff --git a/tldr/httpry b/tldr/httpry index 2d5935a3..8cd98658 100644 --- a/tldr/httpry +++ b/tldr/httpry @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > A lightweight packet sniffer for displaying and logging HTTP traffic. > It can be run in real-time displaying the traffic as it is parsed, or as a daemon process that logs to an output file. -> More information: . +> More information: . - Save output to a file: diff --git a/tldr/inkview b/tldr/inkview index aba42d34..6301dacd 100644 --- a/tldr/inkview +++ b/tldr/inkview @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Inkscape graphical SVG previewer. > Also functions as a slideshow viewer. -> More information: . +> More information: . - Preview an SVG: diff --git a/tldr/interdiff b/tldr/interdiff index a1656ca4..b1a22f26 100644 --- a/tldr/interdiff +++ b/tldr/interdiff @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # interdiff > Show differences between two diff files. -> More information: . +> More information: . - Compare diff files: diff --git a/tldr/jcal b/tldr/jcal index 7f1bddfb..9c8c6472 100644 --- a/tldr/jcal +++ b/tldr/jcal @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # jcal > Display calendar information in the Jalali format, with the current day highlighted. -> More information: . +> More information: . - Display a calendar for the current month: diff --git a/tldr/jrnl b/tldr/jrnl index 3a439711..46a93acb 100644 --- a/tldr/jrnl +++ b/tldr/jrnl @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # jrnl > A simple journal application for your command-line. -> More information: . +> More information: . - Insert a new entry with your editor: diff --git a/tldr/keychain b/tldr/keychain index 2c8d25fa..846743ed 100644 --- a/tldr/keychain +++ b/tldr/keychain @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # keychain > Re-use ssh-agent and/or gpg-agent between logins. -> More information: . +> More information: . - Check for a running ssh-agent, and start one if needed: diff --git a/tldr/kosmorro b/tldr/kosmorro index f19565b8..2d0f4325 100644 --- a/tldr/kosmorro +++ b/tldr/kosmorro @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # kosmorro > Compute the ephemerides and the events for a date at a position on Earth. -> More information: . +> More information: . - Get ephemerides for Paris, France: diff --git a/tldr/less-than b/tldr/less-than index b913e99e..3704b44e 100644 --- a/tldr/less-than +++ b/tldr/less-than @@ -5,10 +5,17 @@ source: https://github.com/tldr-pages/tldr.git --- # Less than -> Redirect a file to `stdin`. -> Achieves the same effect as `cat file.txt |`. +> Redirect data to `stdin`. > More information: . -- Redirect a file to `stdin`: +- Redirect a file to `stdin` (achieves the same effect as `cat file.txt |`): `{{command}} < {{path/to/file.txt}}` + +- Create a here document and pass that into `stdin` (requires a multiline command): + +`{{command}} << {{EOF}} {{multiline_data}} {{EOF}}` + +- Create a here string and pass that into `stdin`: + +`{{command}} <<< {{string}}` diff --git a/tldr/linux/betterlockscreen b/tldr/linux/betterlockscreen index 6f8b4d5b..a71393ec 100644 --- a/tldr/linux/betterlockscreen +++ b/tldr/linux/betterlockscreen @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # betterlockscreen > Simple, minimal lock screen. -> More information: . +> More information: . - Lock the screen: diff --git a/tldr/linux/checkinstall b/tldr/linux/checkinstall index 26e2a802..43dda80a 100644 --- a/tldr/linux/checkinstall +++ b/tldr/linux/checkinstall @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # checkinstall > Track the local installation of a software package, and produce a binary package which can be used with a system's native package manager. -> More information: . +> More information: . - Create and install a package with default settings: diff --git a/tldr/linux/cpuid b/tldr/linux/cpuid index bbc6e827..7942b6a0 100644 --- a/tldr/linux/cpuid +++ b/tldr/linux/cpuid @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # cpuid > Display detailed information about all CPUs. -> More information: . +> More information: . - Display information for all CPUs: diff --git a/tldr/linux/cpulimit b/tldr/linux/cpulimit index 2595a117..16a4e0fa 100644 --- a/tldr/linux/cpulimit +++ b/tldr/linux/cpulimit @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # cpulimit > A tool to throttle the CPU usage of other processes. -> More information: . +> More information: . - Limit an existing process with PID 1234 to only use 25% of the CPU: diff --git a/tldr/linux/cryptcat b/tldr/linux/cryptcat index 4d223846..c0bf1429 100644 --- a/tldr/linux/cryptcat +++ b/tldr/linux/cryptcat @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # cryptcat > Cryptcat is netcat with encryption capabilities. -> More information: . +> More information: . - [l]isten on a specified [p]ort and print any data received: diff --git a/tldr/linux/daemonize b/tldr/linux/daemonize index f36121cd..df4965e0 100644 --- a/tldr/linux/daemonize +++ b/tldr/linux/daemonize @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # daemonize > Run a command (that does not daemonize itself) as a Unix daemon. -> More information: . +> More information: . - Run a command as a daemon: diff --git a/tldr/linux/datamash b/tldr/linux/datamash index fe795c78..67c4bd23 100644 --- a/tldr/linux/datamash +++ b/tldr/linux/datamash @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # datamash > Perform basic numeric, textual and statistical operations on input textual data files. -> More information: . +> More information: . - Get max, min, mean and median of a single column of numbers: diff --git a/tldr/linux/dirb b/tldr/linux/dirb index f00053f5..ec5305af 100644 --- a/tldr/linux/dirb +++ b/tldr/linux/dirb @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # dirb > Scan HTTP-based webservers for directories and files. -> More information: . +> More information: . - Scan a webserver using the default wordlist: diff --git a/tldr/linux/esa-snap b/tldr/linux/esa-snap index 2cf55f21..da198634 100644 --- a/tldr/linux/esa-snap +++ b/tldr/linux/esa-snap @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # esa snap > Sentinel Application Platform (SNAP) for processing satellite data from the European Space Agency (ESA). -> More information: . +> More information: . - Display all updates: diff --git a/tldr/linux/etckeeper b/tldr/linux/etckeeper index 765e7f31..4c5145bb 100644 --- a/tldr/linux/etckeeper +++ b/tldr/linux/etckeeper @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # etckeeper > Track system configuration files in Git. -> More information: . +> More information: . - Set up a Git repo and perform various setup tasks (run from `/etc`): diff --git a/tldr/linux/ethtool b/tldr/linux/ethtool index d65e88c9..69d0f2dc 100644 --- a/tldr/linux/ethtool +++ b/tldr/linux/ethtool @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # ethtool > Display and modify Network Interface Controller (NIC) parameters. -> More information: . +> More information: . - Display the current settings for an interface: diff --git a/tldr/linux/extundelete b/tldr/linux/extundelete index 6330b5e9..84105ff3 100644 --- a/tldr/linux/extundelete +++ b/tldr/linux/extundelete @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Recover deleted files from ext3 or ext4 partitions by parsing the journal. > See also `date` for Unix time information and `umount` for unmounting partitions. -> More information: . +> More information: . - Restore all deleted files inside partition N on device X: diff --git a/tldr/linux/gbp b/tldr/linux/gbp index bb90ff5e..251450e3 100644 --- a/tldr/linux/gbp +++ b/tldr/linux/gbp @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # gbp > A system to integrate the Debian package build system with Git. -> More information: . +> More information: . - Convert an existing Debian package to gbp: diff --git a/tldr/linux/hlint b/tldr/linux/hlint index 142dd805..69406fec 100644 --- a/tldr/linux/hlint +++ b/tldr/linux/hlint @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # hlint > Suggest improvements to Haskell code. -> More information: . +> More information: . - Display suggestions for a given file: diff --git a/tldr/linux/htpdate b/tldr/linux/htpdate index cd13d4b7..f7257939 100644 --- a/tldr/linux/htpdate +++ b/tldr/linux/htpdate @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # htpdate > Synchronize local date and time via HTTP headers from web servers. -> More information: . +> More information: . - Synchronize date and time: diff --git a/tldr/linux/http_load b/tldr/linux/http_load index 724f4ee6..d1f8e895 100644 --- a/tldr/linux/http_load +++ b/tldr/linux/http_load @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > An HTTP benchmarking tool. > Runs multiple HTTP fetches in parallel to test the throughput of a web server. -> More information: . +> More information: . - Emulate 20 requests based on a given URL list file per second for 60 seconds: diff --git a/tldr/linux/iw b/tldr/linux/iw index 6df15181..736a016d 100644 --- a/tldr/linux/iw +++ b/tldr/linux/iw @@ -6,7 +6,8 @@ source: https://github.com/tldr-pages/tldr.git # iw > Show and manipulate wireless devices. -> More information: . +> See also: `iw dev`. +> More information: . - Scan for available wireless networks: @@ -23,3 +24,19 @@ source: https://github.com/tldr-pages/tldr.git - Show information about the current connection: `iw dev {{wlp}} link` + +- List all physical and logical wireless network interfaces: + +`iw dev` + +- List all wireless capabilities for all physical hardware interfaces: + +`iw phy` + +- List the kernel's current wireless regulatory domain information: + +`iw reg get` + +- Display help for all commands: + +`iw help` diff --git a/tldr/linux/iw-dev b/tldr/linux/iw-dev new file mode 100644 index 00000000..d66133e9 --- /dev/null +++ b/tldr/linux/iw-dev @@ -0,0 +1,38 @@ +--- +syntax: markdown +tags: [tldr, linux] +source: https://github.com/tldr-pages/tldr.git +--- +# iw dev + +> Show and manipulate wireless devices. +> For a list of channels, frequencies and reg information: . +> More information: . + +- Set device to monitor mode (interface must be down first. See also `ip link`): + +`sudo iw dev {{wlp}} set type monitor` + +- Set device to managed mode (interface must be down first): + +`sudo iw dev {{wlp}} set type managed` + +- Set device WiFi channel (device must first be in monitor mode with the interface up): + +`sudo iw dev {{wlp}} set channel {{channel_number}}` + +- Set device WiFi frequency in Mhz (device must first be in monitor mode with the interface up): + +`sudo iw dev {{wlp}} set freq {{freq_in_mhz}}` + +- Show all known station info: + +`iw dev {{wlp}} station dump` + +- Create a virtual interface in monitor mode with a specific MAC address: + +`sudo iw dev {{wlp}} interface add "{{vif_name}}" type monitor addr {{12:34:56:aa:bb:cc}}` + +- Delete virtual interface: + +`sudo iw dev "{{vif_name}}" del` diff --git a/tldr/linux/lndir b/tldr/linux/lndir new file mode 100644 index 00000000..2e0901ec --- /dev/null +++ b/tldr/linux/lndir @@ -0,0 +1,13 @@ +--- +syntax: markdown +tags: [tldr, linux] +source: https://github.com/tldr-pages/tldr.git +--- +# lndir + +> Create a shadow directory of symbolic links to another directory tree. +> More information: . + +- Create a shadow directory in the current directory: + +`lndir {{path/to/directory}}` diff --git a/tldr/linux/numlockx b/tldr/linux/numlockx index 63bb1174..bb5b734f 100644 --- a/tldr/linux/numlockx +++ b/tldr/linux/numlockx @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # numlockx > Control the number lock key status in X11 sessions. -> More information: . +> More information: . - Show the current number lock status: diff --git a/tldr/linux/physlock b/tldr/linux/physlock index b1b2eafe..cfad53cc 100644 --- a/tldr/linux/physlock +++ b/tldr/linux/physlock @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # physlock > Lock all consoles and virtual terminals. -> More information: . +> More information: . - Lock every console (require current user or root to unlock): diff --git a/tldr/linux/pivpn b/tldr/linux/pivpn index 6451adf2..f0eb03b6 100644 --- a/tldr/linux/pivpn +++ b/tldr/linux/pivpn @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Easy security-hardened OpenVPN setup and manager. > Originally designed for the Raspberry Pi, but works on other Linux devices too. -> More information: . +> More information: . - Add a new client device: diff --git a/tldr/linux/postfix b/tldr/linux/postfix index a79b8b2f..1bceff91 100644 --- a/tldr/linux/postfix +++ b/tldr/linux/postfix @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Postfix mail transfer agent (MTA) control program. > See also `dovecot`, a mail delivery agent (MDA) that integrates with Postfix. -> More information: . +> More information: . - Check the configuration: diff --git a/tldr/linux/qjoypad b/tldr/linux/qjoypad index 477e2d7a..cf7fa6ff 100644 --- a/tldr/linux/qjoypad +++ b/tldr/linux/qjoypad @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # qjoypad > Translate input from gamepads or joysticks into keyboard strokes or mouse actions. -> More information: . +> More information: . - Start QJoyPad: diff --git a/tldr/linux/runlim b/tldr/linux/runlim index 0bba5166..1137c133 100644 --- a/tldr/linux/runlim +++ b/tldr/linux/runlim @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # runlim > Sample and limit time and memory usage of a program and its child processes using the proc file system on Linux. -> More information: . +> More information: . - Print the time and memory usage of a command: diff --git a/tldr/linux/script b/tldr/linux/script index 91b41ab3..5c06033d 100644 --- a/tldr/linux/script +++ b/tldr/linux/script @@ -22,4 +22,8 @@ source: https://github.com/tldr-pages/tldr.git - Record timing information (data is outputted to `stderr`): -`script -t 2> {{path/to/timingfile}}` +`script -t 2> {{path/to/timing_file}}` + +- Write out data as soon as it happens: + +`script -f {{path/to/file}}` diff --git a/tldr/linux/speedometer b/tldr/linux/speedometer index 5e513e7a..14a7dbd8 100644 --- a/tldr/linux/speedometer +++ b/tldr/linux/speedometer @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # speedometer > Python script that shows a network traffic graph in the terminal. -> More information: . +> More information: . - Show graph for a specific interface: diff --git a/tldr/linux/udisksctl b/tldr/linux/udisksctl index 8b07b4b7..dea7c648 100644 --- a/tldr/linux/udisksctl +++ b/tldr/linux/udisksctl @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # udisksctl > Interact with `udisksd` to query and manipulate storage devices. -> More information: . +> More information: . - Show high-level information about disk drives and block devices: diff --git a/tldr/mk b/tldr/mk index bff5f6af..61a84626 100644 --- a/tldr/mk +++ b/tldr/mk @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Task runner for targets described in Mkfile. > Mostly used to control the compilation of an executable from source code. -> More information: . +> More information: . - Call the first target specified in the Mkfile (usually named "all"): diff --git a/tldr/mp3info b/tldr/mp3info index ec424ca5..24244a2c 100644 --- a/tldr/mp3info +++ b/tldr/mp3info @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # mp3info > Viewer/editor for ID3v1 (but not ID3v2) tags of MP3 files. -> More information: . +> More information: . - Show all ID3v1 tags of a specific MP3 file: diff --git a/tldr/mpg321 b/tldr/mpg321 index eceb9b92..d9f8e3e3 100644 --- a/tldr/mpg321 +++ b/tldr/mpg321 @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2, and 3. > Mpg321 was written (sometime in 1999) to be a drop-in replacement for the (previously) non-free mpg123 player. -> More information: . +> More information: . - Play an audio source exactly N times (N=0 means forever): diff --git a/tldr/mytop b/tldr/mytop index 16a4be7b..adff42e9 100644 --- a/tldr/mytop +++ b/tldr/mytop @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # mytop > Display MySQL server performance info like `top`. -> More information: . +> More information: . - Start `mytop`: diff --git a/tldr/ocamlfind b/tldr/ocamlfind index 33766033..e338681c 100644 --- a/tldr/ocamlfind +++ b/tldr/ocamlfind @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > The findlib package manager for OCaml. > Simplifies linking executables with external libraries. -> More information: . +> More information: . - Compile a source file to a native binary and link with packages: diff --git a/tldr/offlineimap b/tldr/offlineimap index 7913721a..4acb617e 100644 --- a/tldr/offlineimap +++ b/tldr/offlineimap @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # offlineimap > Synchronize a remote IMAP server with local Maildir folders. -> More information: . +> More information: . - Synchronize once, without enabling autorefresh: diff --git a/tldr/optipng b/tldr/optipng index 3083838c..900b3fcb 100644 --- a/tldr/optipng +++ b/tldr/optipng @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # optipng > PNG file optimization utility. -> More information: . +> More information: . - Compress a PNG with default settings: diff --git a/tldr/osx/base64 b/tldr/osx/base64 index b84f7de2..6471b22f 100644 --- a/tldr/osx/base64 +++ b/tldr/osx/base64 @@ -5,21 +5,29 @@ source: https://github.com/tldr-pages/tldr.git --- # base64 -> Encode and decode using Base64 representation. +> Encode or decode file or `stdin` to/from base64, to `stdout` or another file. > More information: . -- Encode a file: +- Encode a file to `stdout`: -`base64 --input={{plain_file}}` +`base64 {{-i|--input}} {{path/to/file}}` -- Decode a file: +- Encode a file to the specified output file: -`base64 --decode --input={{base64_file}}` +`base64 {{-i|--input}} {{path/to/input_file}} {{-o|--output}} {{path/to/output_file}}` -- Encode from `stdin`: +- Wrap encoded output at a specific width (`0` disables wrapping): -`echo -n "{{plain_text}}" | base64` +`base64 {{-b|--break}} {{0|76|...}} {{path/to/file}}` -- Decode from `stdin`: +- Decode a file to `stdout`: -`echo -n {{base64_text}} | base64 --decode` +`base64 {{-d|--decode}} {{-i|--input}} {{path/to/file}}` + +- Encode from `stdin` to `stdout`: + +`{{command}} | base64` + +- Decode from `stdin` to `stdout`: + +`{{command}} | base64 {{-d|--decode}}` diff --git a/tldr/osx/wacaw b/tldr/osx/wacaw index 522c6b63..a2f8f3be 100644 --- a/tldr/osx/wacaw +++ b/tldr/osx/wacaw @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # wacaw > Capture both still pictures and video from an attached camera. -> More information: . +> More information: . - Take a picture from webcam: diff --git a/tldr/osx/whatis b/tldr/osx/whatis index 822f7c7d..3d8176ce 100644 --- a/tldr/osx/whatis +++ b/tldr/osx/whatis @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # whatis > Search a set of database files for short descriptions of system commands for keywords. -> More information: . +> More information: . - Search for information about keyword: diff --git a/tldr/p7zip b/tldr/p7zip index 9fd947a9..7c2640e9 100644 --- a/tldr/p7zip +++ b/tldr/p7zip @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Wrapper of 7-Zip file archiver with high compression ratio. > Internally executes either 7za or 7zr command. -> More information: . +> More information: . - Archive a file, replacing it with a 7zipped compressed version: diff --git a/tldr/play b/tldr/play index 568845b3..02706070 100644 --- a/tldr/play +++ b/tldr/play @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Audio player of SoX - Sound eXchange. > Plays any audio, with audio formats identified by the extension. -> More information: . +> More information: . - Play the given audio file: diff --git a/tldr/qmmp b/tldr/qmmp index f04388fd..67b6ed43 100644 --- a/tldr/qmmp +++ b/tldr/qmmp @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > An audio player with an interface similar to Winamp or XMMS. > See also: `clementine`, `ncmpcpp`, `cmus`. -> More information: . +> More information: . - Launch the GUI: diff --git a/tldr/rapper b/tldr/rapper index 19a18016..fdfc247d 100644 --- a/tldr/rapper +++ b/tldr/rapper @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > The Raptor RDF parsing utility. > Part of the Raptor RDF Syntax Library. -> More information: . +> More information: . - Convert an RDF/XML document to Turtle: diff --git a/tldr/ropper b/tldr/ropper index fc6e3251..5937a8ba 100644 --- a/tldr/ropper +++ b/tldr/ropper @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # ropper > Find ROP gadgets in binary files. -> More information: . +> More information: . - List gadgets in the binary file: diff --git a/tldr/rtmpdump b/tldr/rtmpdump index 7fa2f053..9cdf8839 100644 --- a/tldr/rtmpdump +++ b/tldr/rtmpdump @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # rtmpdump > Dump media content streamed over the RTMP protocol. -> More information: . +> More information: . - Download a file: diff --git a/tldr/runit b/tldr/runit index 99e5bd56..756f900f 100644 --- a/tldr/runit +++ b/tldr/runit @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # runit > 3-stage init system. -> More information: . +> More information: . - Start runit's 3-stage init scheme: diff --git a/tldr/sbcl b/tldr/sbcl index 3f2dd830..39e1e7f5 100644 --- a/tldr/sbcl +++ b/tldr/sbcl @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # sbcl > High performance Common Lisp compiler. -> More information: . +> More information: . - Start a REPL (interactive shell): diff --git a/tldr/sox b/tldr/sox index dc115894..29a497c8 100644 --- a/tldr/sox +++ b/tldr/sox @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Sound eXchange: play, record and convert audio files. > Audio formats are identified by the extension. -> More information: . +> More information: . - Merge two audio files into one: diff --git a/tldr/sphinx-build b/tldr/sphinx-build index 1ebc6b19..c639bed2 100644 --- a/tldr/sphinx-build +++ b/tldr/sphinx-build @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # sphinx-build > Sphinx documentation generator. -> More information: . +> More information: . - Build documentation: diff --git a/tldr/srm b/tldr/srm index 4006183d..ce661ff6 100644 --- a/tldr/srm +++ b/tldr/srm @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Securely remove files or directories. > Overwrites the existing data one or multiple times. Drop in replacement for rm. -> More information: . +> More information: . - Remove a file after a single-pass overwriting with random data: diff --git a/tldr/svn-changelist b/tldr/svn-changelist index 4aabddc0..ef133a10 100644 --- a/tldr/svn-changelist +++ b/tldr/svn-changelist @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # svn changelist > Associate a changelist with a set of files. -> More information: . +> More information: . - Add files to a changelist, creating the changelist if it does not exist: diff --git a/tldr/swig b/tldr/swig index 67179aca..2e079fa0 100644 --- a/tldr/swig +++ b/tldr/swig @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Generate bindings between C/C++ code and various high level languages such as JavaScript, Python, C#, and more. > It uses special `.i` or `.swg` files to generate the bindings (C/C++ with SWIG directives, then outputs a C/C++ file that contains all the wrapper code needed to build an extension module. -> More information: . +> More information: . - Generate a binding between C++ and Python: diff --git a/tldr/timidity b/tldr/timidity index 11fbe47f..e75b9726 100644 --- a/tldr/timidity +++ b/tldr/timidity @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # timidity > Play and convert MIDI files. -> More information: . +> More information: . - Play a MIDI file: diff --git a/tldr/valgrind b/tldr/valgrind index 3ac3dc4a..0958390b 100644 --- a/tldr/valgrind +++ b/tldr/valgrind @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Wrapper for a set of expert tools for profiling, optimizing and debugging programs. > Commonly used tools include `memcheck`, `cachegrind`, `callgrind`, `massif`, `helgrind`, and `drd`. -> More information: . +> More information: . - Use the (default) Memcheck tool to show a diagnostic of memory usage by `program`: diff --git a/tldr/virtualenvwrapper b/tldr/virtualenvwrapper index 9cc466db..66726e19 100644 --- a/tldr/virtualenvwrapper +++ b/tldr/virtualenvwrapper @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # virtualenvwrapper > Group of simple wrapper commands for Python's `virtualenv` tool. -> More information: . +> More information: . - Create a new Python `virtualenv` in `$WORKON_HOME`: diff --git a/tldr/wait b/tldr/wait index f377d6c2..e13b6cb3 100644 --- a/tldr/wait +++ b/tldr/wait @@ -15,3 +15,7 @@ source: https://github.com/tldr-pages/tldr.git - Wait for all processes known to the invoking shell to finish: `wait` + +- Wait for a job to finish: + +`wait %{{N}}` diff --git a/tldr/windows/pabcnetcclear b/tldr/windows/pabcnetcclear index eed6667b..56d1eea4 100644 --- a/tldr/windows/pabcnetcclear +++ b/tldr/windows/pabcnetcclear @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # pabcnetcclear > Preprocess and compile PascalABC.NET source files. -> More information: . +> More information: . - Compile the specified source file into an executable with the same name: diff --git a/tldr/xml b/tldr/xml index 7de129d2..8a9031e2 100644 --- a/tldr/xml +++ b/tldr/xml @@ -6,8 +6,8 @@ source: https://github.com/tldr-pages/tldr.git # xml > XMLStarlet Toolkit: query, edit, check, convert and transform XML documents. -> Some subcommands such as `validate` have their own usage documentation. -> More information: . +> Some subcommands such as `xml validate` have their own usage documentation. +> More information: . - Display general help, including the list of subcommands: diff --git a/tldr/xml-canonic b/tldr/xml-canonic index 7550b8d8..4f712322 100644 --- a/tldr/xml-canonic +++ b/tldr/xml-canonic @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml canonic > Make XML documents canonical. -> More information: . +> More information: . - Make an XML document canonical, preserving comments: diff --git a/tldr/xml-depyx b/tldr/xml-depyx index a8b261ec..984b6808 100644 --- a/tldr/xml-depyx +++ b/tldr/xml-depyx @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml depyx > Convert a PYX (ESIS - ISO 8879) document to XML format. -> More information: . +> More information: . - Convert a PYX (ESIS - ISO 8879) document to XML format: diff --git a/tldr/xml-edit b/tldr/xml-edit index aa4f277d..f36859d8 100644 --- a/tldr/xml-edit +++ b/tldr/xml-edit @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml edit > Edit an XML document. -> More information: . +> More information: . - Delete elements matching an XPATH from an XML document: diff --git a/tldr/xml-elements b/tldr/xml-elements index b3f9ed30..c23a6b01 100644 --- a/tldr/xml-elements +++ b/tldr/xml-elements @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml elements > Extract elements and display the structure of an XML document. -> More information: . +> More information: . - Extract elements from an XML document (producing XPATH expressions): diff --git a/tldr/xml-escape b/tldr/xml-escape index fe07c69e..f85a074b 100644 --- a/tldr/xml-escape +++ b/tldr/xml-escape @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml escape > Escape special XML characters, e.g. `` → `<a1>`. -> More information: . +> More information: . - Escape special XML characters in a string: diff --git a/tldr/xml-format b/tldr/xml-format index 81397dbf..291a21be 100644 --- a/tldr/xml-format +++ b/tldr/xml-format @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml format > Format an XML document. -> More information: . +> More information: . - Format an XML document, indenting with tabs: diff --git a/tldr/xml-list b/tldr/xml-list index 61b77126..a50371a0 100644 --- a/tldr/xml-list +++ b/tldr/xml-list @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml list > List a directory's contents (like `ls`) in XML format. -> More information: . +> More information: . - Write the current directory's listing to an XML document: diff --git a/tldr/xml-pyx b/tldr/xml-pyx index d9704a1e..a0f886b7 100644 --- a/tldr/xml-pyx +++ b/tldr/xml-pyx @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml pyx > Convert an XML document to PYX (ESIS - ISO 8879) format. -> More information: . +> More information: . - Convert an XML document to PYX format: diff --git a/tldr/xml-select b/tldr/xml-select index f8a4c516..af91018c 100644 --- a/tldr/xml-select +++ b/tldr/xml-select @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Select from XML documents using XPATHs. > Tip: use `xml elements` to display the XPATHs of an XML document. -> More information: . +> More information: . - Select all elements matching "XPATH1" and print the value of their sub-element "XPATH2": diff --git a/tldr/xml-transform b/tldr/xml-transform index 5808a98e..bed1d535 100644 --- a/tldr/xml-transform +++ b/tldr/xml-transform @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml transform > Transform XML documents using XSLT. -> More information: . +> More information: . - Transform an XML document using an XSL stylesheet, passing one XPATH parameter and one literal string parameter: diff --git a/tldr/xml-unescape b/tldr/xml-unescape index 72e93a6c..d20ef375 100644 --- a/tldr/xml-unescape +++ b/tldr/xml-unescape @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml unescape > Unescape special XML characters, e.g. `<a1>` → ``. -> More information: . +> More information: . - Unescape special XML characters from a string: diff --git a/tldr/xml-validate b/tldr/xml-validate index fc3320d3..7c75f1cf 100644 --- a/tldr/xml-validate +++ b/tldr/xml-validate @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # xml validate > Validate XML documents. -> More information: . +> More information: . - Validate one or more XML documents for well-formedness only: diff --git a/tldr/yacas b/tldr/yacas index c5183f5c..095fbc63 100644 --- a/tldr/yacas +++ b/tldr/yacas @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # yacas > Yet Another Computer Algebra System. -> More information: . +> More information: . - Start an interactive `yacas` session: diff --git a/tldr/youtube-dl b/tldr/youtube-dl index afa8a82b..918f54e9 100644 --- a/tldr/youtube-dl +++ b/tldr/youtube-dl @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Download videos from YouTube and other websites. > See also: `yt-dlp`, `ytfzf`, `you-get`. -> More information: . +> More information: . - Download a video or playlist: diff --git a/tldr/zbarimg b/tldr/zbarimg index 3f12fdce..53348810 100644 --- a/tldr/zbarimg +++ b/tldr/zbarimg @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # zbarimg > Scan and decode bar codes from image file(s). -> More information: . +> More information: . - Process an image file: diff --git a/tldr/zmv b/tldr/zmv index 219774a3..5442e8e8 100644 --- a/tldr/zmv +++ b/tldr/zmv @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Move or rename files matching a specified extended glob pattern. > See also `zcp` and `zln`. -> More information: . +> More information: . - Move files using a regular expression-like pattern: