From 692469016e62d4410ec92a8f29272e447046a0d2 Mon Sep 17 00:00:00 2001 From: Emily Grace Seville Date: Mon, 14 Feb 2022 03:21:43 -0800 Subject: [PATCH] osx/*: update page (#7665) --- pages/common/oathtool.md | 16 ++++++++++++++++ pages/{osx => common}/rubocop.md | 1 + pages/osx/afinfo.md | 8 ++++---- pages/osx/airport.md | 6 +++--- pages/osx/appsleepd.md | 1 + pages/osx/arch.md | 2 +- pages/osx/avbdeviced.md | 1 + pages/osx/base64.md | 2 +- pages/osx/bird.md | 1 + pages/osx/bless.md | 4 ++-- pages/osx/bnepd.md | 1 + pages/osx/brightness.md | 1 + pages/osx/caffeinate.md | 2 +- pages/osx/cfprefsd.md | 1 + pages/osx/cloudphotod.md | 1 + pages/osx/codesign.md | 4 ++-- pages/osx/csshx.md | 2 +- pages/osx/date.md | 4 ++-- pages/osx/defaults.md | 10 +++++----- pages/osx/distnoted.md | 1 + pages/osx/dmesg.md | 1 + pages/osx/duti.md | 2 +- pages/osx/emond.md | 2 +- pages/osx/fdesetup.md | 2 +- pages/osx/filecoordinationd.md | 1 + pages/osx/icalbuddy.md | 4 ++-- pages/osx/lldb.md | 6 +++--- pages/osx/locate.md | 2 +- pages/osx/look.md | 2 +- pages/osx/mas.md | 4 ++-- pages/osx/md5.md | 2 +- pages/osx/mdfind.md | 4 ++-- pages/osx/nettop.md | 3 ++- pages/osx/networksetup.md | 2 +- pages/osx/notifyd.md | 1 + pages/osx/oathtool.md | 15 --------------- pages/osx/ocspd.md | 1 + pages/osx/open.md | 3 ++- pages/osx/opensnoop.md | 3 ++- pages/osx/osascript.md | 6 +++--- pages/osx/pbcopy.md | 1 + pages/osx/pbpaste.md | 1 + pages/osx/photoanalysisd.md | 1 + pages/osx/photolibraryd.md | 1 + pages/osx/ping.md | 13 +++++++------ pages/osx/pkgutil.md | 1 + pages/osx/plutil.md | 1 + pages/osx/pod.md | 1 + pages/osx/qlmanage.md | 1 + pages/osx/reboot.md | 1 + pages/osx/rename.md | 1 + pages/osx/route.md | 11 ++++++----- pages/osx/safeejectgpu.md | 2 +- pages/osx/say.md | 8 ++++---- pages/osx/secd.md | 1 + pages/osx/securityd.md | 1 + pages/osx/shuf.md | 7 ++++--- pages/osx/shutdown.md | 2 +- pages/osx/sips.md | 9 +++++---- pages/osx/sntpd.md | 1 + pages/osx/softwareupdate.md | 9 +++++---- pages/osx/spctl.md | 2 +- pages/osx/split.md | 1 + pages/osx/system_profiler.md | 2 +- pages/osx/systemsetup.md | 2 +- pages/osx/tmutil.md | 2 +- pages/osx/universalaccessd.md | 1 + pages/osx/uptime.md | 1 + pages/osx/usernoted.md | 1 + pages/osx/vpnd.md | 1 + pages/osx/wacaw.md | 6 +++--- pages/osx/wc.md | 2 +- pages/osx/whence.md | 11 ++++++----- pages/osx/xcode-select.md | 8 ++++---- pages/osx/xed.md | 5 +++-- pages/osx/xip.md | 1 + pages/osx/xsltproc.md | 2 +- pages/osx/yaa.md | 1 + 78 files changed, 151 insertions(+), 107 deletions(-) create mode 100644 pages/common/oathtool.md rename pages/{osx => common}/rubocop.md (86%) delete mode 100644 pages/osx/oathtool.md diff --git a/pages/common/oathtool.md b/pages/common/oathtool.md new file mode 100644 index 0000000000..25089253ee --- /dev/null +++ b/pages/common/oathtool.md @@ -0,0 +1,16 @@ +# oathtool + +> OATH one-time password tool. +> More information: . + +- Generate TOTP token (behaves like Google Authenticator): + +`oathtool --totp --base32 "{{secret}}"` + +- Generate a TOTP token for a specific time: + +`oathtool --totp --now "{{2004-02-29 16:21:42}}" --base32 "{{secret}}"` + +- Validate a TOTP token: + +`oathtool --totp --base32 "{{secret}}" "{{token}}"` diff --git a/pages/osx/rubocop.md b/pages/common/rubocop.md similarity index 86% rename from pages/osx/rubocop.md rename to pages/common/rubocop.md index fb4e31f61e..dc2b9ebeca 100644 --- a/pages/osx/rubocop.md +++ b/pages/common/rubocop.md @@ -1,6 +1,7 @@ # rubocop > Lint Ruby files. +> More information: . - Check all files in the current directory (including subdirectories): diff --git a/pages/osx/afinfo.md b/pages/osx/afinfo.md index f09e239c13..5f0756b42b 100644 --- a/pages/osx/afinfo.md +++ b/pages/osx/afinfo.md @@ -10,15 +10,15 @@ - Print a one line description of the audio file: -`afinfo -b {{path/to/file}}` +`afinfo --brief {{path/to/file}}` - Print metadata info and contents of the audio file's InfoDictionary: -`afinfo -i {{path/to/file}}` +`afinfo --info {{path/to/file}}` - Print output in XML format: -`afinfo -x {{path/to/file}}` +`afinfo --xml {{path/to/file}}` - Print warnings for the audio file if any: @@ -26,4 +26,4 @@ - Display help for full usage: -`afinfo -h` +`afinfo --help` diff --git a/pages/osx/airport.md b/pages/osx/airport.md index 99a05458ac..a41c152114 100644 --- a/pages/osx/airport.md +++ b/pages/osx/airport.md @@ -5,7 +5,7 @@ - Show current wireless status information: -`airport -I` +`airport --getinfo` - Sniff wireless traffic on channel 1: @@ -13,8 +13,8 @@ - Scan for available wireless networks: -`airport -s` +`airport --scan` - Disassociate from current airport network: -`sudo airport -z` +`sudo airport --disassociate` diff --git a/pages/osx/appsleepd.md b/pages/osx/appsleepd.md index 85e3bf5410..3c4fec25d4 100644 --- a/pages/osx/appsleepd.md +++ b/pages/osx/appsleepd.md @@ -2,6 +2,7 @@ > Provides app sleep services. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/arch.md b/pages/osx/arch.md index 7a33973cd9..85bd5b81ac 100644 --- a/pages/osx/arch.md +++ b/pages/osx/arch.md @@ -10,4 +10,4 @@ - Run a command using x86_64: -`arch -x86_64 {{command}}` +`arch -x86_64 "{{command}}"` diff --git a/pages/osx/avbdeviced.md b/pages/osx/avbdeviced.md index 93baec10f9..78855640eb 100644 --- a/pages/osx/avbdeviced.md +++ b/pages/osx/avbdeviced.md @@ -2,6 +2,7 @@ > A service for managing Audio Video Bridging (AVB) devices. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/base64.md b/pages/osx/base64.md index 2f17ffa578..941b325b3b 100644 --- a/pages/osx/base64.md +++ b/pages/osx/base64.md @@ -13,7 +13,7 @@ - Encode from stdin: -`echo -n {{plain_text}} | base64` +`echo -n "{{plain_text}}" | base64` - Decode from stdin: diff --git a/pages/osx/bird.md b/pages/osx/bird.md index 7d8faac1b4..6435a3c462 100644 --- a/pages/osx/bird.md +++ b/pages/osx/bird.md @@ -2,6 +2,7 @@ > This supports the syncing of iCloud and iCloud Drive. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/bless.md b/pages/osx/bless.md index 3fe915ddde..59d5a503eb 100644 --- a/pages/osx/bless.md +++ b/pages/osx/bless.md @@ -5,11 +5,11 @@ - Bless a volume with only Mac OS X or Darwin, and create the BootX and `boot.efi` files as needed: -`bless --folder "{{/Volumes/Mac OS X/System/Library/CoreServices}}" --bootinfo --bootefi` +`bless --folder {{/Volumes/Mac OS X/System/Library/CoreServices}} --bootinfo --bootefi` - Set a volume containing either Mac OS 9 and Mac OS X to be the active volume: -`bless --mount "{{/Volumes/Mac OS}}" --setBoot` +`bless --mount {{/Volumes/Mac OS}} --setBoot` - Set the system to NetBoot and broadcast for an available server: diff --git a/pages/osx/bnepd.md b/pages/osx/bnepd.md index 8b670c0846..87f638e8d5 100644 --- a/pages/osx/bnepd.md +++ b/pages/osx/bnepd.md @@ -2,6 +2,7 @@ > A service that handles all Bluetooth network connections. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/brightness.md b/pages/osx/brightness.md index 1949b35a6f..2835b17979 100644 --- a/pages/osx/brightness.md +++ b/pages/osx/brightness.md @@ -1,6 +1,7 @@ # brightness > Get and set the brightness level of all internal and certain external displays. +> More information: . - Show current brightness: diff --git a/pages/osx/caffeinate.md b/pages/osx/caffeinate.md index 0a2751f47e..03d60a6067 100644 --- a/pages/osx/caffeinate.md +++ b/pages/osx/caffeinate.md @@ -9,7 +9,7 @@ - Prevent from sleeping until a command completes: -`caffeinate -s {{command}}` +`caffeinate -s "{{command}}"` - Prevent from sleeping until you type Ctrl-C: diff --git a/pages/osx/cfprefsd.md b/pages/osx/cfprefsd.md index 43e5b40f60..ddc7da0bef 100644 --- a/pages/osx/cfprefsd.md +++ b/pages/osx/cfprefsd.md @@ -2,6 +2,7 @@ > Provides preferences services (`CFPreferences`, `NSUserDefaults`). > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/cloudphotod.md b/pages/osx/cloudphotod.md index 0fe9cccfa5..eb9259f97e 100644 --- a/pages/osx/cloudphotod.md +++ b/pages/osx/cloudphotod.md @@ -2,6 +2,7 @@ > This synchronizes iCloud Photos. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/codesign.md b/pages/osx/codesign.md index abc3f163a1..b0dcf10f2f 100644 --- a/pages/osx/codesign.md +++ b/pages/osx/codesign.md @@ -5,8 +5,8 @@ - Sign an application with a certificate: -`codesign -s "{{My Company Name}}" {{path/to/App.app}}` +`codesign --sign "{{My Company Name}}" {{path/to/App.app}}` - Verify the certificate of an application: -`codesign -v {{path/to/App.app}}` +`codesign --verify {{path/to/App.app}}` diff --git a/pages/osx/csshx.md b/pages/osx/csshx.md index 712dbb00c4..a65a46e7c2 100644 --- a/pages/osx/csshx.md +++ b/pages/osx/csshx.md @@ -9,7 +9,7 @@ - Connect to multiple hosts with a given SSH key: -`csshX {{user@hostname1}} {{user@hostname2}} '--ssh_args' '-i {{path/to/ssh_key.pem}}'` +`csshX {{user@hostname1}} {{user@hostname2}} --ssh_args "-i {{path/to/ssh_key.pem}}"` - Connect to a pre-defined cluster from `/etc/clusters`: diff --git a/pages/osx/date.md b/pages/osx/date.md index 3b962bcaed..f02378beb8 100644 --- a/pages/osx/date.md +++ b/pages/osx/date.md @@ -5,11 +5,11 @@ - Display the current date using the default locale's format: -`date +"%c"` +`date +%c` - Display the current date in UTC and ISO 8601 format: -`date -u +"%Y-%m-%dT%H:%M:%SZ"` +`date -u +%Y-%m-%dT%H:%M:%SZ` - Display the current date as a Unix timestamp (seconds since the Unix epoch): diff --git a/pages/osx/defaults.md b/pages/osx/defaults.md index 4d75c3ac8a..5fe32f0ac9 100644 --- a/pages/osx/defaults.md +++ b/pages/osx/defaults.md @@ -5,19 +5,19 @@ - Read system defaults for an application option: -`defaults read {{application}} {{option}}` +`defaults read "{{application}}" "{{option}}"` - Read default values for an application option: -`defaults read -app {{application}} {{option}}` +`defaults read -app "{{application}}" "{{option}}"` - Search for a keyword in domain names, keys, and values: -`defaults find {{keyword}}` +`defaults find "{{keyword}}"` - Write the default value of an application option: -`defaults write {{application}} {{option}} {{-type}} {{value}}` +`defaults write "{{application}}" "{{option}}" {{-type}} {{value}}` - Speed up Mission Control animations: @@ -25,4 +25,4 @@ - Delete all defaults of an application: -`defaults delete {{application}}` +`defaults delete "{{application}}"` diff --git a/pages/osx/distnoted.md b/pages/osx/distnoted.md index 1ea1df44dd..6d8b7439cb 100644 --- a/pages/osx/distnoted.md +++ b/pages/osx/distnoted.md @@ -2,6 +2,7 @@ > Provides distributed notification services. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/dmesg.md b/pages/osx/dmesg.md index 5478d302d6..6f27439df1 100644 --- a/pages/osx/dmesg.md +++ b/pages/osx/dmesg.md @@ -1,6 +1,7 @@ # dmesg > Write the kernel messages to standard output. +> More information: . - Show kernel messages: diff --git a/pages/osx/duti.md b/pages/osx/duti.md index 781ff1519f..c7644048df 100644 --- a/pages/osx/duti.md +++ b/pages/osx/duti.md @@ -13,7 +13,7 @@ - Set Finder as the default handler for the ftp:// URL scheme: -`duti -s {{com.apple.Finder}} {{ftp}}` +`duti -s {{com.apple.Finder}} "{{ftp}}"` - Display information about the default application for a given extension: diff --git a/pages/osx/emond.md b/pages/osx/emond.md index 50a3c7023e..9dfdb24c84 100644 --- a/pages/osx/emond.md +++ b/pages/osx/emond.md @@ -2,7 +2,7 @@ > Event Monitor service that accepts events from various services, runs them through a simple rules engine, and takes action. > The actions can run commands, send email, or SMS messages. -> More information: . +> More information: . - Start the daemon: diff --git a/pages/osx/fdesetup.md b/pages/osx/fdesetup.md index f664c15979..ed81df0e66 100644 --- a/pages/osx/fdesetup.md +++ b/pages/osx/fdesetup.md @@ -1,7 +1,7 @@ # fdesetup > Set and retrieve FileVault related information. -> Main information: . +> More information: . - List current FileVault enabled users: diff --git a/pages/osx/filecoordinationd.md b/pages/osx/filecoordinationd.md index 5d0140cf6f..3abbcb36ae 100644 --- a/pages/osx/filecoordinationd.md +++ b/pages/osx/filecoordinationd.md @@ -2,6 +2,7 @@ > Coordinates access to files by multiple processes (`NSFileCoordinator`, `NSFilePresenter`). > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/icalbuddy.md b/pages/osx/icalbuddy.md index 03ba88c0a7..e09a28ab3a 100644 --- a/pages/osx/icalbuddy.md +++ b/pages/osx/icalbuddy.md @@ -17,8 +17,8 @@ - Show tasks for a specified number of days: -`icalBuddy -n tasksDueBefore:today+{{days}}` +`icalBuddy -n "tasksDueBefore:today+{{days}}"` - Show events in a time range: -`icalBuddy eventsFrom:'{{start_date}}' to:'{{end_date}}'` +`icalBuddy eventsFrom:{{start_date}} to:{{end_date}}` diff --git a/pages/osx/lldb.md b/pages/osx/lldb.md index 8795ddce4c..e06333940a 100644 --- a/pages/osx/lldb.md +++ b/pages/osx/lldb.md @@ -1,11 +1,11 @@ # lldb > The LLVM Low-Level Debugger. -> More information: . +> More information: . - Debug an executable: -`lldb {{executable}}` +`lldb "{{executable}}"` - Attach `lldb` to a running process with a given PID: @@ -13,4 +13,4 @@ - Wait for a new process to launch with a given name, and attach to it: -`lldb -w -n {{process_name}}` +`lldb -w -n "{{process_name}}"` diff --git a/pages/osx/locate.md b/pages/osx/locate.md index c93e848858..406b8b2bfe 100644 --- a/pages/osx/locate.md +++ b/pages/osx/locate.md @@ -5,7 +5,7 @@ - Look for pattern in the database. Note: the database is recomputed periodically (usually weekly or daily): -`locate {{pattern}}` +`locate "{{pattern}}"` - Look for a file by its exact filename (a pattern containing no globbing characters is interpreted as `*pattern*`): diff --git a/pages/osx/look.md b/pages/osx/look.md index 6c16fc2308..fc69771d64 100644 --- a/pages/osx/look.md +++ b/pages/osx/look.md @@ -9,4 +9,4 @@ - Look for lines ignoring case: -`look -f {{prefix}} {{file}}` +`look --ignore-case {{prefix}} {{file}}` diff --git a/pages/osx/mas.md b/pages/osx/mas.md index dccbf773b4..517d01967e 100644 --- a/pages/osx/mas.md +++ b/pages/osx/mas.md @@ -5,7 +5,7 @@ - Sign into the Mac App Store for the first time: -`mas signin {{user@example.com}}` +`mas signin "{{user@example.com}}"` - Show all installed applications and their product identifiers: @@ -13,7 +13,7 @@ - Search for an application, displaying the price alongside the results: -`mas search {{application}} --price` +`mas search "{{application}}" --price` - Install or update an application: diff --git a/pages/osx/md5.md b/pages/osx/md5.md index 2176a31962..d710a16f72 100644 --- a/pages/osx/md5.md +++ b/pages/osx/md5.md @@ -17,4 +17,4 @@ - Print a checksum of the given string: -`md5 -s {{string}}` +`md5 -s "{{string}}"` diff --git a/pages/osx/mdfind.md b/pages/osx/mdfind.md index 692e607bb2..2b26e7d975 100644 --- a/pages/osx/mdfind.md +++ b/pages/osx/mdfind.md @@ -9,8 +9,8 @@ - Find a file by its content: -`mdfind {{query}}` +`mdfind "{{query}}"` - Find a file containing a string, in a given directory: -`mdfind -onlyin {{directory}} {{query}}` +`mdfind -onlyin {{directory}} "{{query}}"` diff --git a/pages/osx/nettop.md b/pages/osx/nettop.md index 9b85de78d5..4894046a0c 100644 --- a/pages/osx/nettop.md +++ b/pages/osx/nettop.md @@ -1,6 +1,7 @@ # nettop > Display updated information about the network. +> More information: . - Monitor TCP and UDP sockets from all interfaces: @@ -12,7 +13,7 @@ - Monitor a specific process: -`nettop -p {{process_id|process_name}}` +`nettop -p "{{process_id|process_name}}"` - Display a per-process summary: diff --git a/pages/osx/networksetup.md b/pages/osx/networksetup.md index a871b236ce..ede3d5069e 100644 --- a/pages/osx/networksetup.md +++ b/pages/osx/networksetup.md @@ -17,4 +17,4 @@ - Connect to a particular Wi-Fi network: -`networksetup -setairportnetwork {{en0}} "{{Airport Network SSID}}" {{password}}` +`networksetup -setairportnetwork {{en0}} {{Airport Network SSID}} {{password}}` diff --git a/pages/osx/notifyd.md b/pages/osx/notifyd.md index 92ee734f39..d2fbd5a31b 100644 --- a/pages/osx/notifyd.md +++ b/pages/osx/notifyd.md @@ -2,6 +2,7 @@ > Notification server. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/oathtool.md b/pages/osx/oathtool.md deleted file mode 100644 index af56427661..0000000000 --- a/pages/osx/oathtool.md +++ /dev/null @@ -1,15 +0,0 @@ -# oathtool - -> OATH one-time password tool. - -- Generate TOTP token (behaves like Google Authenticator): - -`oathtool --totp --base32 {{secret}}` - -- Generate a TOTP token for a specific time: - -`oathtool --totp --now {{2004-02-29 16:21:42}} --base32 {{secret}}` - -- Validate a TOTP token: - -`oathtool --totp --base32 {{secret}} {{token}}` diff --git a/pages/osx/ocspd.md b/pages/osx/ocspd.md index 8b3157524e..1bbb4ba15d 100644 --- a/pages/osx/ocspd.md +++ b/pages/osx/ocspd.md @@ -2,6 +2,7 @@ > This retrieves and caches Certificate Revocation Lists (CRLs) and Online Certificate Status Protocol (OCSP) responses for certificate verification. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/open.md b/pages/osx/open.md index 294d4dda4b..2126054f84 100644 --- a/pages/osx/open.md +++ b/pages/osx/open.md @@ -1,6 +1,7 @@ # open > Opens files, directories and applications. +> More information: . - Open a file with the associated application: @@ -8,7 +9,7 @@ - Run a graphical macOS application: -`open -a {{Application}}` +`open -a "{{Application}}"` - Run a graphical macOS app based on the bundle identifier (refer to `osascript` for an easy way to get this): diff --git a/pages/osx/opensnoop.md b/pages/osx/opensnoop.md index e54bfd5706..224366b685 100644 --- a/pages/osx/opensnoop.md +++ b/pages/osx/opensnoop.md @@ -1,6 +1,7 @@ # opensnoop > Tool that tracks file opens on your system. +> More information: . - Print all file opens as they occur: @@ -8,7 +9,7 @@ - Track all file opens by a process by name: -`sudo opensnoop -n {{process_name}}` +`sudo opensnoop -n "{{process_name}}"` - Track all file opens by a process by PID: diff --git a/pages/osx/osascript.md b/pages/osx/osascript.md index 25a8f4ce0d..9deba60a57 100644 --- a/pages/osx/osascript.md +++ b/pages/osx/osascript.md @@ -5,11 +5,11 @@ - Run an AppleScript command: -`osascript -e '{{say "Hello world"}}'` +`osascript -e "{{say 'Hello world'}}"` - Run multiple AppleScript commands: -`osascript -e '{{say "Hello"}}' -e '{{say "world"}}'` +`osascript -e "{{say 'Hello'}}" -e "{{say 'world'}}"` - Run a compiled (`*.scpt`), bundled (`*.scptd`), or plaintext (`*.applescript`) AppleScript file: @@ -21,7 +21,7 @@ - Run a JavaScript command: -`osascript -l JavaScript -e '{{console.log("Hello world");}}'` +`osascript -l JavaScript -e "{{console.log('Hello world');}}"` - Run a JavaScript file: diff --git a/pages/osx/pbcopy.md b/pages/osx/pbcopy.md index ed297e941b..28b2cbd4d6 100644 --- a/pages/osx/pbcopy.md +++ b/pages/osx/pbcopy.md @@ -1,6 +1,7 @@ # pbcopy > Place standard output in the clipboard. +> More information: . - Place the contents of a file in the clipboard: diff --git a/pages/osx/pbpaste.md b/pages/osx/pbpaste.md index b4cfb31552..0c093da3f8 100644 --- a/pages/osx/pbpaste.md +++ b/pages/osx/pbpaste.md @@ -1,6 +1,7 @@ # pbpaste > Send the contents of the clipboard to standard output. +> More information: . - Write the contents of the clipboard to a file: diff --git a/pages/osx/photoanalysisd.md b/pages/osx/photoanalysisd.md index 11c9a76587..ecae3513cd 100644 --- a/pages/osx/photoanalysisd.md +++ b/pages/osx/photoanalysisd.md @@ -2,6 +2,7 @@ > This analyzes photo libraries for Memories, People, and scene or object based search. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/photolibraryd.md b/pages/osx/photolibraryd.md index 94e2916f6a..0f57370b0c 100644 --- a/pages/osx/photolibraryd.md +++ b/pages/osx/photolibraryd.md @@ -2,6 +2,7 @@ > This handles all photo library requests. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/ping.md b/pages/osx/ping.md index 0a47a2828f..ac73c48e38 100644 --- a/pages/osx/ping.md +++ b/pages/osx/ping.md @@ -1,27 +1,28 @@ # ping > Send ICMP ECHO_REQUEST packets to network hosts. +> More information: . - Ping the specified host: -`ping {{host}}` +`ping "{{hostname}}"` - Ping a host a specific number of times: -`ping -c {{count}} {{host}}` +`ping -c {{count}} "{{host}}"` - Ping `host`, specifying the interval in `seconds` between requests (default is 1 second): -`ping -i {{seconds}} {{host}}` +`ping -i {{seconds}} "{{host}}"` - Ping `host` without trying to lookup symbolic names for addresses: -`ping -n {{host}}` +`ping -n "{{host}}"` - Ping `host` and ring the bell when a packet is received (if your terminal supports it): -`ping -a {{host}}` +`ping -a "{{host}}"` - Ping `host` and prints the time a packet was received (this option is an Apple addition): -`ping --apple-time {{host}}` +`ping --apple-time "{{host}}"` diff --git a/pages/osx/pkgutil.md b/pages/osx/pkgutil.md index f8de4587ed..fc860c7705 100644 --- a/pages/osx/pkgutil.md +++ b/pages/osx/pkgutil.md @@ -1,6 +1,7 @@ # pkgutil > Query and manipulate Mac OS X Installer packages and receipts. +> More information: . - List package IDs for all installed packages: diff --git a/pages/osx/plutil.md b/pages/osx/plutil.md index cc5b560c1e..d88fa172d3 100644 --- a/pages/osx/plutil.md +++ b/pages/osx/plutil.md @@ -1,6 +1,7 @@ # plutil > View, convert, validate, or edit property list ("plist") files. +> More information: . - Display the contents of one or more plist files in human-readable format: diff --git a/pages/osx/pod.md b/pages/osx/pod.md index 62584dcea1..31beda5b98 100644 --- a/pages/osx/pod.md +++ b/pages/osx/pod.md @@ -1,6 +1,7 @@ # pod > Dependency manager for Swift and Objective-C Cocoa projects. +> More information: . - Create a Podfile for the current project with the default contents: diff --git a/pages/osx/qlmanage.md b/pages/osx/qlmanage.md index 6c79409378..e34c8e2035 100644 --- a/pages/osx/qlmanage.md +++ b/pages/osx/qlmanage.md @@ -1,6 +1,7 @@ # qlmanage > QuickLook server tool. +> More information: . - Display QuickLook for one or multiple files: diff --git a/pages/osx/reboot.md b/pages/osx/reboot.md index cc946093fb..2a861069af 100644 --- a/pages/osx/reboot.md +++ b/pages/osx/reboot.md @@ -1,6 +1,7 @@ # reboot > Reboot the system. +> More information: . - Reboot immediately: diff --git a/pages/osx/rename.md b/pages/osx/rename.md index c52144323e..c3ffb3576f 100644 --- a/pages/osx/rename.md +++ b/pages/osx/rename.md @@ -1,6 +1,7 @@ # rename > Rename a file or group of files with a regular expression. +> More information: . - Replace `from` with `to` in the filenames of the specified files: diff --git a/pages/osx/route.md b/pages/osx/route.md index 0bea78c1ef..fe9588d829 100644 --- a/pages/osx/route.md +++ b/pages/osx/route.md @@ -2,18 +2,19 @@ > Manually manipulate the routing tables. > Necessitates to be root. +> More information: . - Add a route to a destination through a gateway: -`sudo route add {{dest_ip_address}} {{gateway_address}}` +`sudo route add "{{destination_ip_address}}" "{{gateway_address}}"` - Add a route to a /24 subnet through a gateway: -`sudo route add {{subnet_ip_address}}/24 {{gateway_address}}` +`sudo route add "{{subnet_ip_address}}/24" "{{gateway_address}}"` - Run in test mode (does not do anything, just print): -`sudo route -t add {{dest_ip_address}}/24 {{gateway_address}}` +`sudo route -t add "{{destination_ip_address}}/24" "{{gateway_address}}"` - Remove all routes: @@ -21,8 +22,8 @@ - Delete a specific route: -`sudo route delete {{dest_ip_address}}/24` +`sudo route delete "{{destination_ip_address}}/24"` - Lookup and display the route for a destination (hostname or IP address): -`sudo route get {{destination}}` +`sudo route get "{{destination}}"` diff --git a/pages/osx/safeejectgpu.md b/pages/osx/safeejectgpu.md index 3db5cc1df4..d23b349f01 100644 --- a/pages/osx/safeejectgpu.md +++ b/pages/osx/safeejectgpu.md @@ -1,7 +1,7 @@ # SafeEjectGPU > Eject a GPU safely. -> Visit the man page for more info. +> More information: . - Eject all GPUs: diff --git a/pages/osx/say.md b/pages/osx/say.md index 61f45d3ba4..49af20f114 100644 --- a/pages/osx/say.md +++ b/pages/osx/say.md @@ -9,16 +9,16 @@ - Read a file aloud: -`say -f {{filename.txt}}` +`say --input-file={{filename.txt}}` - Say a phrase with a custom voice and speech rate: -`say -v {{voice}} -r {{words_per_minute}} "{{I'm sorry Dave, I can't let you do that.}}"` +`say --voice={{voice}} --rate={{words_per_minute}} "{{I'm sorry Dave, I can't let you do that.}}"` - List the available voices: -`say -v "?"` +`say --voice="?"` - Create an audio file of the spoken text: -`say -o {{filename.aiff}} "{{Here's to the Crazy Ones.}}"` +`say --output-file={{filename.aiff}} "{{Here's to the Crazy Ones.}}"` diff --git a/pages/osx/secd.md b/pages/osx/secd.md index b9ecf88b3c..c152b7f265 100644 --- a/pages/osx/secd.md +++ b/pages/osx/secd.md @@ -2,6 +2,7 @@ > Controls access to and modification of keychain items. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/securityd.md b/pages/osx/securityd.md index c6a3cd5d1b..0e28802613 100644 --- a/pages/osx/securityd.md +++ b/pages/osx/securityd.md @@ -3,6 +3,7 @@ > This manages security contexts and cryptographic operations. > Works with secd for keychain access. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/shuf.md b/pages/osx/shuf.md index 8452e60f34..14398493bb 100644 --- a/pages/osx/shuf.md +++ b/pages/osx/shuf.md @@ -1,6 +1,7 @@ # shuf > Generate random permutations. +> More information: . - Randomize the order of lines in a file and output the result: @@ -8,12 +9,12 @@ - Only output the first 5 entries of the result: -`shuf -n {{5}} {{filename}}` +`shuf --head-count={{5}} {{filename}}` - Write output to another file: -`shuf {{filename}} -o {{output_filename}}` +`shuf {{filename}} --output={{output_filename}}` - Generate random numbers in range 1-10: -`shuf -i {{1-10}}` +`shuf --input-range={{1-10}}` diff --git a/pages/osx/shutdown.md b/pages/osx/shutdown.md index 6b8cd44f58..41b80f1c51 100644 --- a/pages/osx/shutdown.md +++ b/pages/osx/shutdown.md @@ -17,7 +17,7 @@ - Reboot in 5 minutes: -`shutdown -r +{{5}}` +`shutdown -r "+{{5}}"` - Power off (halt) at 1:00 pm (Uses 24h clock): diff --git a/pages/osx/sips.md b/pages/osx/sips.md index 0c6768a745..12b118680f 100644 --- a/pages/osx/sips.md +++ b/pages/osx/sips.md @@ -2,6 +2,7 @@ > Apple Scriptable Image Processing System. > Raster/Query images and ColorSync ICC Profiles. +> More information: . - Specify an output directory so that originals do not get modified: @@ -9,11 +10,11 @@ - Resample image at specified size, Image aspect ratio may be altered: -`sips -z {{1920}} {{300}} {{image.ext}}` +`sips --resampleHeightWidth {{1920}} {{300}} {{image.ext}}` - Resample image so height and width aren't greater than specified size (notice the capital Z): -`sips -Z {{1920}} {{300}} {{image.ext}}` +`sips --resampleHeightWidthMax {{1920}} {{300}} {{image.ext}}` - Resample all images in a directory to fit a width of 960px (honoring aspect ratio): @@ -21,8 +22,8 @@ - Convert an image from CMYK to RGB: -`sips --matchTo '/System/Library/ColorSync/Profiles/Generic RGB Profile.icc' {{path/to/image.ext}} {{path/to/out_dir}}` +`sips --matchTo "/System/Library/ColorSync/Profiles/Generic RGB Profile.icc" {{path/to/image.ext}} {{path/to/out_dir}}` - Remove ColorSync ICC profile from an image: -`sips -d profile --deleteColorManagementProperties {{path/to/image.ext}}` +`sips --deleteProperty profile --deleteColorManagementProperties {{path/to/image.ext}}` diff --git a/pages/osx/sntpd.md b/pages/osx/sntpd.md index 791480d64e..eb8dc7aa81 100644 --- a/pages/osx/sntpd.md +++ b/pages/osx/sntpd.md @@ -2,6 +2,7 @@ > An SNTP server. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/softwareupdate.md b/pages/osx/softwareupdate.md index 42b0fd991f..daf1f4dc2e 100644 --- a/pages/osx/softwareupdate.md +++ b/pages/osx/softwareupdate.md @@ -1,19 +1,20 @@ # softwareupdate > A tool for updating macOS App Store apps via the command-line. +> More information: . - List all available updates: -`softwareupdate -l` +`softwareupdate --list` - Download and install all updates: -`softwareupdate -ia` +`softwareupdate --install --all` - Download and install all recommended updates: -`softwareupdate -ir` +`softwareupdate --install --req` - Download and install a specific app: -`softwareupdate -i {{update_name}}` +`softwareupdate --install {{update_name}}` diff --git a/pages/osx/spctl.md b/pages/osx/spctl.md index 8dc00c4738..a516ba2d9d 100644 --- a/pages/osx/spctl.md +++ b/pages/osx/spctl.md @@ -10,7 +10,7 @@ - Add a rule to allow an application to run (labeling of rule is optional): -`spctl --add --label "{{rule_name}}" {{path/to/file}}` +`spctl --add --label {{rule_name}} {{path/to/file}}` - Turn on Gatekeeper: diff --git a/pages/osx/split.md b/pages/osx/split.md index 3cfc857cfb..43bffa05b4 100644 --- a/pages/osx/split.md +++ b/pages/osx/split.md @@ -1,6 +1,7 @@ # split > Split a file into pieces. +> More information: . - Split a file, each split having 10 lines (except the last split): diff --git a/pages/osx/system_profiler.md b/pages/osx/system_profiler.md index d645ef276b..cb5be6f087 100644 --- a/pages/osx/system_profiler.md +++ b/pages/osx/system_profiler.md @@ -13,4 +13,4 @@ - Print the system serial number: -`system_profiler SPHardwareDataType|grep "Serial Number (system)" |awk '{print $4}'` +`system_profiler SPHardwareDataType|grep "Serial Number (system)" | awk '{ print $4 }'` diff --git a/pages/osx/systemsetup.md b/pages/osx/systemsetup.md index 9b9667aeab..c029acc3f3 100644 --- a/pages/osx/systemsetup.md +++ b/pages/osx/systemsetup.md @@ -9,7 +9,7 @@ - Specify timezone, NTP Server and enable network time: -`systemsetup -settimezone {{US/Pacific}} -setnetworktimeserver {{us.pool.ntp.org}} -setusingnetworktime on` +`systemsetup -settimezone "{{US/Pacific}}" -setnetworktimeserver {{us.pool.ntp.org}} -setusingnetworktime on` - Make the machine never sleep and automatically restart on power failure or kernel panic: diff --git a/pages/osx/tmutil.md b/pages/osx/tmutil.md index e4d61b6d38..fcd237b196 100644 --- a/pages/osx/tmutil.md +++ b/pages/osx/tmutil.md @@ -9,7 +9,7 @@ - Set an APF share or SMB share as the backup destination: -`sudo tmutil setdestination {{protocol://user[:password]@host/share}}` +`sudo tmutil setdestination "{{protocol://user[:password]@host/share}}"` - Append the given destination to the list of destinations: diff --git a/pages/osx/universalaccessd.md b/pages/osx/universalaccessd.md index 13c0c22208..7b57d92535 100644 --- a/pages/osx/universalaccessd.md +++ b/pages/osx/universalaccessd.md @@ -2,6 +2,7 @@ > Provides universal access services. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/uptime.md b/pages/osx/uptime.md index f00fd39f3a..39e52c2839 100644 --- a/pages/osx/uptime.md +++ b/pages/osx/uptime.md @@ -1,6 +1,7 @@ # uptime > Tell how long the system has been running and other information. +> More information: . - Print current time, uptime, number of logged-in users and other information: diff --git a/pages/osx/usernoted.md b/pages/osx/usernoted.md index 60defbae92..d6c142c7dc 100644 --- a/pages/osx/usernoted.md +++ b/pages/osx/usernoted.md @@ -2,6 +2,7 @@ > Provides notification services. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/vpnd.md b/pages/osx/vpnd.md index 1f5a44da51..fc60ab2f60 100644 --- a/pages/osx/vpnd.md +++ b/pages/osx/vpnd.md @@ -2,6 +2,7 @@ > Listens for incoming VPN connections. > It should not be invoked manually. +> More information: . - Start the daemon: diff --git a/pages/osx/wacaw.md b/pages/osx/wacaw.md index 132b0b691c..95e733e6c5 100644 --- a/pages/osx/wacaw.md +++ b/pages/osx/wacaw.md @@ -9,11 +9,11 @@ - Record a video: -`wacaw --video {{filename}} -D {{duration_in_seconds}}` +`wacaw --video {{filename}} --duration {{duration_in_seconds}}` - Take a picture with custom resolution: -`wacaw -x {{width}} -y {{height}} {{filename}}` +`wacaw --width {{width}} --height {{height}} {{filename}}` - Copy image just taken to clipboard: @@ -21,4 +21,4 @@ - List the devices available: -`wacaw -L` +`wacaw --list-devices` diff --git a/pages/osx/wc.md b/pages/osx/wc.md index d98bf638e5..bacf84c720 100644 --- a/pages/osx/wc.md +++ b/pages/osx/wc.md @@ -1,7 +1,7 @@ # wc > Count lines, words, or bytes. -> More information: . +> More information: . - Count lines in file: diff --git a/pages/osx/whence.md b/pages/osx/whence.md index c1aa98f07c..534b728673 100644 --- a/pages/osx/whence.md +++ b/pages/osx/whence.md @@ -1,23 +1,24 @@ # whence > A zsh builtin to indicate how a given command would be interpreted. +> More information: . - Interpret {{command}}, with expansion if defined as an `alias` (similar to the `command -v` builtin): -`whence {{command}}` +`whence "{{command}}"` - Display type of {{command}}, with location if defined as a function, or binary (equivalent to the `type` and `command -V` builtins): -`whence -v {{command}}` +`whence -v "{{command}}"` - Same as above, except display content of shell functions instead of location (equivalent to `which` builtin): -`whence -c {{command}}` +`whence -c "{{command}}"` - Same as above, but show all occurrences on command path (equivalent to the `where` builtin): -`whence -ca {{command}}` +`whence -ca "{{command}}"` - Search only the `PATH` for {{command}}, ignoring builtins, aliases or shell functions (equivalent to the `where` command): -`whence -p {{command}}` +`whence -p "{{command}}"` diff --git a/pages/osx/xcode-select.md b/pages/osx/xcode-select.md index 8d85ec14cb..759f74ba27 100644 --- a/pages/osx/xcode-select.md +++ b/pages/osx/xcode-select.md @@ -10,16 +10,16 @@ - Select a given path as the active developer directory: -`xcode-select -s {{path/to/Xcode.app/Contents/Developer}}` +`xcode-select --switch {{path/to/Xcode.app/Contents/Developer}}` - Select a given Xcode instance and use its developer directory as the active one: -`xcode-select -s {{path/to/Xcode.app}}` +`xcode-select --switch {{path/to/Xcode.app}}` - Print the currently selected developer directory: -`xcode-select -p` +`xcode-select --print-path` - Discard any user-specified developer directory so that it will be found via the default search mechanism: -`sudo xcode-select -r` +`sudo xcode-select --reset` diff --git a/pages/osx/xed.md b/pages/osx/xed.md index 157b4140b8..b910f68679 100644 --- a/pages/osx/xed.md +++ b/pages/osx/xed.md @@ -1,6 +1,7 @@ # xed > Opens files for editing in Xcode. +> More information: . - Open file in Xcode: @@ -8,8 +9,8 @@ - Open file(s) in Xcode, create if it doesn't exist: -`xed -c {{filename1}}` +`xed --create {{filename1}}` - Open a file in Xcode and jump to line number 75: -`xed -l 75 {{filename}}` +`xed --line 75 {{filename}}` diff --git a/pages/osx/xip.md b/pages/osx/xip.md index d666df29cd..69b00e1bea 100644 --- a/pages/osx/xip.md +++ b/pages/osx/xip.md @@ -2,6 +2,7 @@ > Create or expand compressed files in a secure xip archive. > Only archives signed by Apple are trusted, so this tool should not be used to create archives. +> More information: . - Expand the archive into the current working directory: diff --git a/pages/osx/xsltproc.md b/pages/osx/xsltproc.md index 37e72ba6e9..606c8a31eb 100644 --- a/pages/osx/xsltproc.md +++ b/pages/osx/xsltproc.md @@ -9,4 +9,4 @@ - Pass a value to a parameter in the stylesheet: -`xsltproc --output {{output.html}} --stringparam {{name}} {{value}} {{stylesheet.xslt}} {{xmlfile.xml}}` +`xsltproc --output {{output.html}} --stringparam "{{name}}" "{{value}}" {{stylesheet.xslt}} {{xmlfile.xml}}` diff --git a/pages/osx/yaa.md b/pages/osx/yaa.md index ddf1d6f333..580595f58e 100644 --- a/pages/osx/yaa.md +++ b/pages/osx/yaa.md @@ -1,6 +1,7 @@ # yaa > Create and manipulate YAA archives. +> More information: . - Create an archive from a directory: