feat(user/ping_offline.sh):Add script to ping until it succeeds once

[BK-2020-03.git] / doc / user / ping_offline.sh.org

* ping_offline.sh documentation

#+TITLE: ping_offline.sh documentation
#+AUTHOR: Steven Baltakatei Sandoval
#+DATE:2023-02-20
#+EMAIL:baltakatei@gmail.com
#+LANGUAGE: en
#+OPTIONS: toc:nil

Created by [[https://baltakatei.com][Steven Baltakatei Sandoval]] on
2023-02-20T22:27+00
under a [[https://creativecommons.org/licenses/by-sa/4.0/][CC BY-SA 4.0]] (🅭🅯🄎4.0) license and last updated on
2023-02-20T22:34+00

** Summary

~ping_offline.sh~ is a small Bash script meant to indicate when the
machine it runs on is able to ping a remote server.

** Versions
| Version | Description             |
|---------+-------------------------|
|   0.0.1 | Initial working script. |

** Background
Sometimes, my machines are on a network that is temporarily
disconnected for various reasons. I'd like to know approximately when
they come back online by pinging a remote server; once a successful
ping is established, I can stop further pings. However, the ~ping~
executable available (provided by the package ~iputils-ping~) on my
Pop!_OS 22.04 LTS machine throws an error if the machine is completely
offline; therefore, I wrote the script to regularly try the command
until it succeeds at least once.

** Dependencies
- ~iputils-ping~ package (Version: 3:20211215-1)

** References