#!/usr/bin/env bash ############################################################################### # __ __ # / /_ ____ _____/ /______ # / __ \/ __ \/ ___/ __/ ___/ # / / / / /_/ (__ ) /_(__ ) # /_/ /_/\____/____/\__/____/ # # A program for managing host file entries. # # https://github.com/xwmx/hosts # # Based on Bash Boilerplate: https://github.com/xwmx/bash-boilerplate # # The MIT License (MIT) # # Copyright (c) 2015 William Melody • hi@williammelody.com # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE # SOFTWARE. ############################################################################### ############################################################################### # Strict Mode ############################################################################### set -o nounset set -o errexit set -o pipefail set -o noglob IFS=$'\n\t' ############################################################################### # Environment & Globals ############################################################################### # $_VERSION # # The most recent program version. _VERSION="3.5.1" # $_ME # # This program's basename. _ME="$(basename "${0}")" # $HOSTS_DEFAULT_SUBCOMMAND # # The command to be run by default, when no command name is specified. [[ -n "${HOSTS_DEFAULT_COMMAND:-}" ]] && HOSTS_DEFAULT_SUBCOMMAND="${HOSTS_DEFAULT_COMMAND}" HOSTS_DEFAULT_SUBCOMMAND="${HOSTS_DEFAULT_SUBCOMMAND:-list}" # $HOSTS_PATH # # The path to the hosts file. This will almost always be /etc/hosts HOSTS_PATH="${HOSTS_PATH:-/etc/hosts}" # Space and tab for regular expressions # # sed regular expressions have slightly different behaviors dependending on # the environment, and POSIX [[:space:]] matches whitespace characters other # than just space and tab. These variables provide an easier, portable way to # test for just these two characters. export _TAB_=$'\t' export _SPACE_=$' ' export _TAB_SPACE_="${_TAB_}${_SPACE_}" export _TAB_SPACE_CC_="[${_TAB_SPACE_}]" # $_SED_I_COMMAND # # `sed -i` takes an extension on macOS, but that extension can cause errors in # GNU `sed`. # # NOTE: To use this command, call it with `"${_SED_I_COMMAND[@]}"` # # https://stackoverflow.com/q/43171648 # http://stackoverflow.com/a/16746032 if sed --help >/dev/null 2>&1 then # GNU export _SED_I_COMMAND=(sed -i) else # BSD export _SED_I_COMMAND=(sed -i '') fi # $_REPO # # The / identifier for the git repository. _REPO="xwmx/hosts" # $_REPO_RAW_URL # # The base URL for raw files. _REPO_RAW_URL="https://raw.githubusercontent.com/${_REPO}/master" ############################################################################### # Debug ############################################################################### # _debug() # # Usage: # _debug printf "Debug info. Variable: %s\\n" "$0" # # A simple function for executing a specified command if the `$_USE_DEBUG` # variable has been set. The command is expected to print a message and # should typically be either `echo`, `printf`, or `cat`. __DEBUG_COUNTER=0 _debug() { if [[ "${_USE_DEBUG:-"0"}" -eq 1 ]] then __DEBUG_COUNTER=$((__DEBUG_COUNTER+1)) { # Prefix debug message with "bug (U+1F41B)" printf "🐛 %s " "${__DEBUG_COUNTER}" "${@}" printf "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――\\n" } 1>&2 fi } ############################################################################### # Error Messaging ############################################################################### # _exit_1() # # Usage: # _exit_1 # # Description: # Exit with status 1 after executing the specified with output redirected # to standard error. The command is expected to print a message and should # typically be either `echo`, `printf`, or `cat`. _exit_1() { { printf "%s " "$(tput setaf 1)!$(tput sgr0)" "${@}" } 1>&2 exit 1 } # _return_1() # # Usage: # _return_1 # # Description: # Return with status 1 after executing the specified with output redirected # to standard error. The command is expected to print a message and should # typically be either `echo`, `printf`, or `cat`. _return_1() { { printf "%s " "$(tput setaf 1)!$(tput sgr0)" "${@}" } 1>&2 return 1 } # _warn() # # Usage: # _warn # # Description: # Print the specified command with output redirected to standard error. # The command is expected to print a message and should typically be either # `echo`, `printf`, or `cat`. _warn() { { printf "%s " "$(tput setaf 1)!$(tput sgr0)" "${@}" } 1>&2 } ############################################################################### # Utility Functions ############################################################################### # _contains() # # Usage: # _contains "${item}" "${list[@]}" # # Returns: # 0 If the item is included in the list. # 1 If not. _contains() { local _query="${1:-}" shift if [[ -z "${_query}" ]] || [[ -z "${*:-}" ]] then return 1 fi for __element in "${@}" do [[ "${__element}" == "${_query}" ]] && return 0 done return 1 } # _join() # # Usage: # _join "," a b c # _join "${an_array[@]}" # # Returns: # The list or array of items joined into a string with elements divided by # the optional separator if one is provided. # # More information: # https://stackoverflow.com/a/17841619 _join() { local _delimiter="${1}" shift printf "%s" "${1}" shift printf "%s" "${@/#/${_delimiter}}" | tr -d '[:space:]' } # _print_entries() # # Usage: # _print_entries _print_entries() { local _input="${1:-}" [[ -n "${_input}" ]] || return 0 local _newline=$'\n' if [[ -n "${2:-}" ]] then _input+="${_newline}${2:-}" fi local _max_length=0 while IFS=$'\t ' read -r -a _parts do if [[ "${_parts[0]}" =~ disabled ]] then _parts=("${_parts[@]:1}") fi if [[ "${_max_length}" -lt "${#_parts[0]}" ]] then _max_length="${#_parts[0]}" fi done <<< "${_input}" local _max_tab_equivalent="$((_max_length / 8))" while IFS=$'\t ' read -r -a _parts do if [[ "${_parts[0]}" =~ disabled ]] then _parts=("${_parts[@]:1}") printf "disabled:\\n" fi local _current_tab_equivalent=$((${#_parts[0]} / 8)) local _tab_count=$((_max_tab_equivalent - _current_tab_equivalent + 1)) local _tabs= _tabs="$(printf "%*s" ${_tab_count} | tr " " '\t')" if [[ -n "${_parts[2]:-}" ]] then printf "%s%s %s\t%s\\n" \ "${_parts[0]}" \ "${_tabs}" \ "${_parts[1]}" \ "$(printf "%s" "${_parts[*]:2}" | tr '\r\n' ' ')" else printf "%s%s %s\\n" \ "${_parts[0]}" \ "${_tabs}" \ "${_parts[1]}" fi done <<< "${_input}" } # _verify_write_permissions # # Print a helpful error message when the specified operation can't be # performed due to the lack of write permissions. If `$_AUTO_SUDO` is enabled, # then run the command with sudo and exit with the command's exit value. _verify_write_permissions() { if [[ ! -w "${HOSTS_PATH}" ]] then if ((_AUTO_SUDO)) then local _my_path _my_path="$(cd "$(dirname "$0")"; pwd)/${_ME}" sudo "${_my_path}" "${_SUBCOMMAND}" "${_COMMAND_PARAMETERS[@]:-}" exit $? else _exit_1 printf \ "You don't have permission to perform this operation. Try again with: sudo !!\\n" fi fi } ############################################################################### # desc ############################################################################### # desc() # # Usage: # desc # desc --get # # Options: # --get Print the description for if one has been set. # # Examples: # ``` # desc "list" <. The # text can be passed as the second argument or as standard input. # # To make the text available to other functions, `desc()` assigns # the text to a variable with the format `$___desc_`. # # When the `--get` option is used, the description for is printed, if # one has been set. desc() { _debug printf "desc() \${*}: %s\\n" "$@" [[ -z "${1:-}" ]] && _exit_1 printf "desc(): No command name specified.\\n" if [[ "${1}" == "--get" ]] then # get ------------------------------------------------------------------ [[ -z "${2:-}" ]] && _exit_1 printf "desc(): No command name specified.\\n" local _name="${2:-}" local _desc_var="___desc_${_name}" if [[ -n "${!_desc_var:-}" ]] then printf "%s\\n" "${!_desc_var}" else printf "No additional information for \`%s\`\\n" "${_name}" fi else # set ------------------------------------------------------------------ if [[ -n "${2:-}" ]] then # argument is present read -r -d '' "___desc_${1}" <] Description: Display help information for ${_ME} or a specified command. HEREDOC help() { if [[ -n "${1:-}" ]] then desc --get "${1}" else cat <] ${_ME} add [] ${_ME} backups [create | [compare | delete | restore | show] ] ${_ME} block ... ${_ME} completions (check | install [-d | --download] | uninstall) ${_ME} disable ( | | ) ${_ME} disabled ${_ME} edit ${_ME} enable ( | | ) ${_ME} enabled ${_ME} file ${_ME} list [enabled | disabled | ] ${_ME} search ${_ME} show ( | | ) ${_ME} remove ( | | ) [--force] ${_ME} unblock ... ${_ME} --auto-sudo ${_ME} -h | --help ${_ME} --version Options: --auto-sudo Run write commands with \`sudo\` automatically. -h --help Display this help information. --version Display version information. Help: ${_ME} help [] More Information: https://github.com/xwmx/hosts HEREDOC fi } ############################################################################### # Commands # ========..................................................................... # # Example command group structure: # # desc example "" - Optional. A short description for the command. # example() { : } - The command called by the user. # # # desc example < [] Description: Add a given IP address and hostname pair, along with an optional comment. Exit status: 0 Success. 1 Invalid parameters or entry exists. HEREDOC add() { _debug printf "add() \${1}: %s\\n" "${1:-}" _debug printf "add() \${2}: %s\\n" "${2:-}" _debug printf "add() \${3}: %s\\n" "${3:-}" _verify_write_permissions local _ip="${1:-}" local _hostname="${2:-}" local _comment="${*:3}" local _tabs=$'\t' if [[ -z "${_ip:-}" ]] then help "add" exit 1 elif [[ -z "${_hostname:-}" ]] then printf "Please include a hostname\\n" help "add" exit 1 elif grep \ -e "^${_ip}[[:space:]]\+${_hostname}$" \ -e "^${_ip}[[:space:]]\+${_hostname}[[:space:]]\+.*$" "${HOSTS_PATH}" then _exit_1 printf \ "Duplicate address/host combination, %s unchanged.\\n" \ "${HOSTS_PATH}" else if [[ "${#_ip}" -lt 8 ]] then _tabs=$'\t\t' fi if [[ -n "${_comment:-}" ]] then local _formatted_comment _formatted_comment=$(_join " " "${_comment[@]}") printf "%s%s%s\\t# %s\\n" \ "${_ip}" \ "${_tabs}" \ "${_hostname}" \ "${_formatted_comment}" >> "${HOSTS_PATH}" printf "Added:\\n%s%s%s\\t# %s\\n" \ "${_ip}" \ "${_tabs}" \ "${_hostname}" \ "${_formatted_comment}" else printf "%s%s%s\\n" \ "${_ip}" \ "${_tabs}" \ "${_hostname}" >> "${HOSTS_PATH}" printf "Added:\\n%s%s%s\\n" \ "${_ip}" \ "${_tabs}" \ "${_hostname}" fi fi } # backups ############################################################# backups desc "backups" < ${_ME} backups delete ${_ME} backups restore [--skip-backup] ${_ME} backups show Subcommands: backups List available backups. backups create Create a new backup of the hosts file. backups compare Compare a backup file with the current hosts file. backups delete Delete the specified backup. backups restore Replace the contents of the hosts file with a specified backup. The hosts file is automatically backed up before being overwritten unless the '--skip-backup' flag is specified. backups show Show the contents of the specified backup file. Description: Manage backups. Exit status: 0 Success. 1 Invalid parameters or backup not found. HEREDOC backups() { local _filename= local _hosts_dirname= _hosts_dirname="$(dirname "${HOSTS_PATH}")" local _skip_backup=0 local _subcommand= for __arg in "${@:-}" do case "${__arg}" in --skip-backup) _skip_backup=1 ;; create|compare|delete|restore|show) _subcommand="${__arg}" ;; *) if [[ -z "${_filename:-}" ]] then _filename="${__arg}" fi ;; esac done case "${_subcommand}" in create) _verify_write_permissions local _timestamp _timestamp="$(date +"%Y%m%d%H%M%S")" cp "${HOSTS_PATH}" "${HOSTS_PATH}--backup-${_timestamp}" && \ printf "Backed up to %s--backup-%s\\n" "${HOSTS_PATH}" "${_timestamp}" ;; compare) if [[ -z "${_filename:-}" ]] then help "backups" exit 1 elif [[ ! -e "${_hosts_dirname}/${_filename}" ]] then _exit_1 printf "Backup not found: %s\\n" "${_filename:-}" fi diff -u "${HOSTS_PATH}" "${_hosts_dirname}/${_filename}" ;; delete) if [[ -z "${_filename:-}" ]] then help "backups" exit 1 fi _verify_write_permissions if [[ "${HOSTS_PATH}" != "${_hosts_dirname}/${_filename:-}" ]] && [[ -e "${_hosts_dirname}/${_filename:-}" ]] then rm "${_hosts_dirname}/${_filename:-}" && printf "Backup deleted: %s\\n" "${_hosts_dirname}/${_filename:-}" else _exit_1 printf "Backup not found: %s\\n" "${_filename:-}" fi ;; restore) if [[ -z "${_filename:-}" ]] then help "backups" exit 1 elif [[ ! -e "${_hosts_dirname}/${_filename}" ]] then _exit_1 printf "Backup not found: %s\\n" "${_filename:-}" fi _verify_write_permissions if ! ((_skip_backup)) then backups create fi cat "${_hosts_dirname}/${_filename}" > "${HOSTS_PATH}" && printf "Restored from backup: %s\\n" "${_filename}" ;; show) if [[ -z "${_filename:-}" ]] then help "backups" exit 1 elif [[ ! -e "${_hosts_dirname}/${_filename}" ]] then _exit_1 printf "Backup not found: %s\\n" "${_filename:-}" fi cat "${_hosts_dirname}/${_filename:-}" ;; *) local _filenames=() set +f for __filename in $(cd "${_hosts_dirname}" && ls -1 hosts* 2> /dev/null) do if [[ "${__filename:-}" != "hosts" ]] && [[ ! "${__filename:-}" =~ ^hosts_test..{6}$ ]] then _filenames+=("${__filename:-}") fi done set -f if ((${#_filenames[@]})) then for __filename in "${_filenames[@]:-}" do printf "%s\\n" "${__filename}" done else printf \ "No backups found. Create a new backup:\\n %s backups create\\n" \ "${_ME}" fi ;; esac } # block ################################################################# block desc "block" <... Description: Block one or more hostnames by adding new entries assigned to \`127.0.0.1\` for IPv4 and both \`fe80::1%lo0\` and \`::1\` for IPv6. Exit status: 0 Success. 1 Invalid parameters or entry exists. HEREDOC block() { _verify_write_permissions if [[ -z "${1:-}" ]] then help "block" exit 1 fi for __hostname in "${@}" do add 127.0.0.1 "${__hostname}" # block IPv6 add "fe80::1%lo0" "${__hostname}" add "::1" "${__hostname}" done } # commands ########################################################### commands desc "commands" < | | ) Description: Disable one or more records based on a given ip address, hostname, or search string. Exit status: 0 Success. 1 Invalid parameters or entry not found. HEREDOC disable() { _verify_write_permissions local _search_string="${1:-}" if [[ -z "${_search_string:-}" ]] then help "disable" exit 1 else _debug printf "disable() \${_search_string}: %s\\n" "${_search_string}" local _regex_ip _regex_ip="^\\(${_search_string}[${_TAB_SPACE_}]..*\\)$" local _regex_commented_hostname _regex_commented_hostname="^\\([^#]..*[${_TAB_SPACE_}]${_search_string}[${_TAB_SPACE_}]..*\\)$" local _regex_hostname _regex_hostname="^\\([^#]..*[${_TAB_SPACE_}]${_search_string}\\)$" # Regular Expression Notes # # - Note double periods in regular expression in order to emulate /.+/, # which apparently doesn't work properly with all versions of sed. local _targets _targets=$( sed -n \ -e "s/${_regex_ip}/\\1/p" \ -e "s/${_regex_commented_hostname}/\\1/p" \ -e "s/${_regex_hostname}/\\1/p" \ "${HOSTS_PATH}" ) _debug printf "disable() \${_targets}: %s\\n" "${_targets}" if [[ -z "${_targets:-}" ]] then _exit_1 printf "Not found: %s\\n" "${_search_string}" fi printf "Disabling:\\n%s\\n" "${_targets}" "${_SED_I_COMMAND[@]}" \ -e "s/${_regex_ip}/\\#disabled: \\1/g" \ -e "s/${_regex_commented_hostname}/\\#disabled: \\1/g" \ -e "s/${_regex_hostname}/\\#disabled: \\1/g" \ "${HOSTS_PATH}" fi } # disabled ########################################################### disabled desc "disabled" < | | ) Description: Enable one or more disabled records based on a given ip address, hostname, or search string. Exit status: 0 Success. 1 Invalid parameters or entry not found. HEREDOC enable() { _verify_write_permissions local _search_string="${1:-}" if [[ -z "${_search_string:-}" ]] then help "enable" exit 1 else _debug printf "enable() \${_search_string}: %s\\n" "${_search_string}" # Regular Expression Notes # # - Note double periods in regular expression in order to emulate /.+/, # which apparently doesn't work properly with all versions of sed. local _regex_ip _regex_ip="^\\#disabled: \\(${_search_string}[${_TAB_SPACE_}]..*\\)$" local _regex_commented_hostname _regex_commented_hostname="^\\#disabled: \\(..*[${_TAB_SPACE_}]${_search_string}[${_TAB_SPACE_}]..*\\)$" local _regex_hostname _regex_hostname="^\\#disabled: \\(..*[${_TAB_SPACE_}]${_search_string}\\)$" local _targets _targets=$( sed -n \ -e "s/${_regex_ip}/\\1/p" \ -e "s/${_regex_commented_hostname}/\\1/p" \ -e "s/${_regex_hostname}/\\1/p" \ "${HOSTS_PATH}" ) _debug printf "enable() \${targets}: %s\\n" "${_targets}" if [[ -z "${_targets:-}" ]] then _exit_1 printf "Not found: %s\\n" "${_search_string}" fi printf "Enabling:\\n%s\\n" "${_targets}" "${_SED_I_COMMAND[@]}" \ -e "s/${_regex_ip}/\\1/g" \ -e "s/${_regex_commented_hostname}/\\1/g" \ -e "s/${_regex_hostname}/\\1/g" \ "${HOSTS_PATH}" fi } # enabled ############################################################# enabled desc "enabled" <] Description: List the existing IP / hostname pairs, optionally limited to a specified state. When provided with a seach string, all matching enabled records will be printed. HEREDOC list() { # Get the disabled records up front for the two cases where they are needed. local _disabled_records _disabled_records=$( sed -n "s/^\\#disabled: \\(.*\\)$/\\1/p" "${HOSTS_PATH}" ) if [[ -n "${1:-}" ]] then if [[ "${1}" == "disabled" ]] then _print_entries "${_disabled_records}" elif [[ "${1}" == "enabled" ]] then _print_entries "$(grep -v -e '^$' -e '^\s*\#' "${HOSTS_PATH}")" else show "${1}" fi else # NOTE: use separate expressions since using a | for the or results in # inconsistent behavior. local _enabled_records _enabled_records="$(grep -v -e '^$' -e '^\s*\#' "${HOSTS_PATH}")" _print_entries "${_enabled_records:-}" if [[ -n "${_disabled_records:-}" ]] then [[ -n "${_enabled_records:-}" ]] && printf "\\n" printf "Disabled:\\n" printf "%s\\n" "---------" _print_entries "${_disabled_records}" fi fi } # remove ############################################################### remove desc "remove" < | | ) [--force] ${_ME} remove Options: --force Skip the confirmation prompt. Description: Remove one or more records based on a given IP address, hostname, or search string. If an IP and hostname are both provided, only records matching the IP and hostname pair will be removed. Exit status: 0 Success. 1 Invalid parameters or entry not found. HEREDOC remove() { _verify_write_permissions local _is_search_pair=0 local _force_skip_prompt=0 local _arguments=() local _search_ip= local _search_hostname= local _search_string= _debug printf "remove() \${1}: %s\\n" "${1:-}" _debug printf "remove() \${2}: %s\\n" "${2:-}" for __arg in "${@:-}" do case "${__arg}" in --force) _force_skip_prompt=1 ;; *) _arguments+=("${__arg}") ;; esac done _debug printf "remove() \${arguments[1]}: %s\\n" "${_arguments[0]:-}" _debug printf "remove() \${arguments[2]}: %s\\n" "${_arguments[1]:-}" if [[ -z "${_arguments[0]:-}" ]] then help "remove" exit 1 elif [[ -n "${_arguments[1]:-}" ]] then _search_ip="${_arguments[0]}" _search_hostname="${_arguments[1]}" _is_search_pair=1 _debug printf "remove() \${_is_search_pair}: %s\\n" "${_is_search_pair}" else _search_string="${_arguments[0]:-}" _debug printf "remove() \${_search_string}: %s\\n" "${_search_string}" fi # Regular Expression Notes # # Note double periods in regular expression in order to emulate /.+/, # which apparently doesn't work properly with all versions of sed. # # IP / Hostname pair regular expressions: local _regex_ip_hostname_commented _regex_ip_hostname_commented="^\\(${_search_ip}[${_TAB_SPACE_}]*${_search_hostname}[${_TAB_SPACE_}]..*\\)$" local _regex_ip_hostname _regex_ip_hostname="^\\(${_search_ip}[${_TAB_SPACE_}]*${_search_hostname}\\)$" # Search string regular expressions: local _regex_ip _regex_ip="^\\(${_search_string}[${_TAB_SPACE_}]..*\\)$" local _regex_commented_hostname _regex_commented_hostname="^\\(..*[${_TAB_SPACE_}]${_search_string}[${_TAB_SPACE_}]..*\\)$" local _regex_hostname _regex_hostname="^\\(..*[${_TAB_SPACE_}]${_search_string}\\)$" local _target_records if ((_is_search_pair)) then _target_records=$( sed -n \ -e "s/${_regex_ip_hostname_commented}/\\1/p" \ -e "s/${_regex_ip_hostname}/\\1/p" \ "${HOSTS_PATH}" ) else _target_records=$( sed -n \ -e "s/${_regex_ip}/\\1/p" \ -e "s/${_regex_commented_hostname}/\\1/p" \ -e "s/${_regex_hostname}/\\1/p" \ "${HOSTS_PATH}" ) fi if [[ -z "${_target_records:-}" ]] then _exit_1 printf "No matching records found.\\n" fi if ! ((_force_skip_prompt)) then printf "Removing the following records:\\n%s\\n" "${_target_records}" while true do read -r -p "Are you sure you want to proceed? [y/N] " _yn case "${_yn}" in [Yy]* ) break ;; * ) printf "Exiting...\\n" exit 0 ;; esac done fi if ((_is_search_pair)) then "${_SED_I_COMMAND[@]}" \ -e "/${_regex_ip_hostname_commented}/d" \ -e "/${_regex_ip_hostname}/d" \ "${HOSTS_PATH}" else "${_SED_I_COMMAND[@]}" \ -e "/${_regex_ip}/d" \ -e "/${_regex_commented_hostname}/d" \ -e "/${_regex_hostname}/d" \ "${HOSTS_PATH}" fi printf "Removed:\\n%s\\n" "${_target_records}" } desc "delete" "$(desc --get 'remove')" delete() { remove "${@}"; } # search ############################################################### search desc "search" < Description: Search entries for . HEREDOC search() { if [[ -z "${1:-}" ]] then help "search" exit 1 fi list "$@" } # show ################################################################### show desc "show" < | | ) Description: Print entries matching a given IP address, hostname, or search string. Exit status: 0 Success. 1 Invalid parameters or entry not found. HEREDOC show() { if [[ -n "${1:-}" ]] then # Run `sed` before `grep` to avoid conflict that supresses `sed` output. local _disabled_records _disabled_records="$( sed -n "s/^\\#disabled: \\(.*${1}.*\\)$/\\1/p" "${HOSTS_PATH}" )" local _enabled_records _enabled_records="$( grep --invert-match "^#" "${HOSTS_PATH}" | grep "${1}" || true )" if [[ -z "${_disabled_records}" ]] && [[ -z "${_enabled_records}" ]] then _return_1 printf "No matching entries.\\n" fi _print_entries "${_enabled_records}" if [[ -n "${_disabled_records}" ]] then [[ -n "${_enabled_records}" ]] && printf "\\n" printf "Disabled:\\n" printf "%s\\n" "---------" _print_entries "${_disabled_records}" fi else help show exit 1 fi } # unblock ############################################################# unblock desc "unblock" <... Description: Unblock one or more hostnames by removing the entries from the hosts file. Exit status: 0 Success. 1 Invalid parameters or entry not found. HEREDOC unblock() { _verify_write_permissions if [[ -z "${1:-}" ]] then help unblock exit 1 fi for __hostname in "${@}" do remove 127.0.0.1 "${__hostname}" --force # unblock IPv6 remove "fe80::1%lo0" "${__hostname}" --force remove "::1" "${__hostname}" --force done } # version ############################################################# version desc "version" <