doc/user/ping_offline.sh.org

   1 * ping_offline.sh documentation
   2
   3 #+TITLE: ping_offline.sh documentation
   4 #+AUTHOR: Steven Baltakatei Sandoval
   5 #+DATE:2023-02-20
   6 #+EMAIL:baltakatei@gmail.com
   7 #+LANGUAGE: en
   8 #+OPTIONS: toc:nil
   9
  10 Created by [[https://baltakatei.com][Steven Baltakatei Sandoval]] on
  11 2023-02-20T22:27+00
  12 under a [[https://creativecommons.org/licenses/by-sa/4.0/][CC BY-SA 4.0]] (🅭🅯🄎4.0) license and last updated on
  13 2023-02-20T22:34+00
  14
  15 ** Summary
  16
  17 ~ping_offline.sh~ is a small Bash script meant to indicate when the
  18 machine it runs on is able to ping a remote server.
  19
  20 ** Versions
  21 | Version | Description             |
  22 |---------+-------------------------|
  23 |   0.0.1 | Initial working script. |
  24
  25 ** Background
  26 Sometimes, my machines are on a network that is temporarily
  27 disconnected for various reasons. I'd like to know approximately when
  28 they come back online by pinging a remote server; once a successful
  29 ping is established, I can stop further pings. However, the ~ping~
  30 executable available (provided by the package ~iputils-ping~) on my
  31 Pop!_OS 22.04 LTS machine throws an error if the machine is completely
  32 offline; therefore, I wrote the script to regularly try the command
  33 until it succeeds at least once.
  34
  35 ** Dependencies
  36 - ~iputils-ping~ package (Version: 3:20211215-1)
  37
  38 ** References