2 # Copyright (C) 2019 Ian Kelling
3 # SPDX-License-Identifier: AGPL-3.0-or-later
4 # this gets sourced. shebang is just for file mode detection
6 # Use source ~/.bashrc instead of doing bash -l when running a script
7 # so this can set extdebug and avoid the bash debugger.
8 if [[ -s /a
/bin
/errhandle
/err
]]; then
9 source /a
/bin
/errhandle
/err
10 elif [[ -s $bashrc_dir/err
]]; then
11 # shellcheck source=/a/bin/errhandle/err
12 source $bashrc_dir/err
15 # In t8, it runs clear_console for login shells by default. I don't want
16 # my console cleared. And linux ttys get cleared without this.
17 if shopt login_shell
>/dev
/null
&& [[ -e ~
/.bash_logout
]]; then
21 # if [[ -s /usr/share/bash-completion/completions/git ]]; then
22 # source /usr/share/bash-completion/completions/git
24 # if [[ -s /usr/share/bash-completion/completions/gitk ]]; then
25 # source /usr/share/bash-completion/completions/gitk
28 # for testing error catching:
44 # remove all aliases. aliases provided by the system tend to get in the way,
45 # for example, error happens if I try to define a function the same name as an alias
48 # remove gnome keyring warning messages
49 # there is probably a more proper way, but I didnt find any easily on google
50 # now using xfce+xmonad instead of vanilla xmonad, so disabling this
51 #unset GNOME_KEYRING_CONTROL
53 # use extra globing features.
55 # include .files when globbing, but ignore files name . and ..
56 # setting this also sets dotglob.
57 export GLOBIGNORE
="*/.:*/.."
59 # Useful info. see man bash.
63 # broken with bash_completion package. Saw a bug for this once. dont anymore.
64 # still broken in wheezy
65 # still buggered in latest stable from the web, version 2.1
66 # perhaps its fixed in newer git version, which fails to make for me
67 # this note is from 6-2014.
68 # still broken in flidas.
71 # make tab on an empty line do nothing
72 shopt -s no_empty_cmd_completion
74 # fix spelling errors for cd, only in interactive shell
76 # append history instead of overwritting it
78 # for compatibility, per gentoo/debian bashrc
80 # attempt to save multiline single commands as single history entries.
87 if [[ $LC_INSIDE_EMACS ]]; then
88 # EMACS is used by bash on startup, but we dont need it anymore.
89 # plus I hit a bug in a makefile which inherited it
91 export LC_INSIDE_EMACS
94 # scp completion does not work, but this doesnt fix it. todo, figure this out
95 #complete -r scp &> /dev/null
96 # todo, remote file completion fails, figure out how to turn it off
97 export NODE_DISABLE_COLORS
=1
98 # This gets rid of ugly terminal escape chars in node repl
99 # sometime, Id like to have completion working in emacs shell for node
100 # the offending chars can be found in lib/readline.js,
101 # things that do like:
102 # stream.write('\x1b[' + (x + 1) + 'G');
103 # We can remove them and keep readline, for example by doing this
105 #!/usr/bin/env nodejs
106 # var readline = require('readline');
107 # readline.cursorTo = function(a,b,c) {};
108 # readline.clearScreenDown = function(a) {};
109 # const repl = require('repl');
110 # var replServer = repl.start('');
112 # no prompt, or else readline complete seems to be confused, based
113 # on our column being different? node probably needs to send
114 # different kind of escape sequence that is not ugly. Anyways,
115 # completion doesnt work yet even with the ugly prompt, so whatever
117 export NODE_NO_READLINE
=1
121 export SSH_CONFIG_FILE_OVERRIDE
=/root
/.ssh
/confighome
123 # emacs has a different default search path than the info command. This
124 # adds the info defaults to emacs, but not the reverse, because I dun
125 # care much about the cli. The search path is only on the cli if you run
126 # "info xxx", or in emacs if you run '(info xxx)', so not that
127 # important, but might as well fix it.
129 # info info says this path is what was compiled, and its not documented
130 # anywhere. Through source grepping, i found it in filesys.h of the info
131 # source in trisquel flidas.
133 # Traling : means for emacs to add its own stuff on to the end.
135 export INFOPATH
=$PATH:/usr
/local
/info
:/usr
/info
:/usr
/local
/lib
/info
:/usr
/lib
/info
:/usr
/local
/gnu
/info
:/usr
/local
/gnu
/lib
/info
:/usr
/gnu
/info
:/usr
/gnu
/lib
/info
:/opt
/gnu
/info
:/usr
/share
/info
:/usr
/share
/lib
/info
:/usr
/local
/share
/info
:/usr
/local
/share
/lib
/info
:/usr
/gnu
/lib
/emacs
/info
:/usr
/local
/gnu
/lib
/emacs
/info
:/usr
/local
/lib
/emacs
/info
:/usr
/local
/emacs
/info
:.
:
137 # for openwrt system that has no stty, this is easier than
138 # guarding every time i use it.
139 if ! type -p stty
>/dev
/null
; then
145 if [[ $
- == *i
* ]]; then
146 # for readline-complete.el
147 if [[ $LC_INSIDE_EMACS ]]; then
148 # all for readline-complete.el
150 bind 'set horizontal-scroll-mode on'
151 bind 'set print-completions-horizontally on'
152 bind '"\C-i": self-insert'
156 if [[ $TERM != dumb
]] && test -t 1; then
160 if [[ $KONSOLE_PROFILE_NAME ]]; then
164 if [[ $TERM == alacritty
&& ! -e /usr
/share
/terminfo
/a
/alacritty
]]; then
165 # todo: we should try installing the alacritty terminfo if it is not found
166 # https://github.com/alacritty/alacritty/issues/2838
170 # copying from the alacritty example above,
171 if [[ $TERM == xterm-kitty
]]; then
172 if [[ ! -e /usr
/share
/terminfo
/x
/xterm-kitty
]]; then
175 if [[ -e /a
/opt
/kitty
/shell-integration
/bash
/kitty.bash
]]; then
176 KITTY_SHELL_INTEGRATION
=t
177 source /a
/opt
/kitty
/shell-integration
/bash
/kitty.bash
182 # todo: not sure this works in sakura
184 #bind "\C-w": kill-region
185 # sakura == xterm-256color
187 if [[ $TERM != xterm-kitty
&& $TERM == xterm
* ]]; then
188 # control + arrow keys. for other terminals, see http://unix.stackexchange.com/questions/10806/how-to-change-previous-next-word-shortcut-in-bash
189 bind '"\e[1;5C": shell-forward-word' 2>/dev
/null
190 bind '"\e[1;5D": shell-backward-word' 2>/dev
/null
192 # make ctrl-backspace work. for konsole, i fixed it through
193 # /home/iank/.local/share/konsole/default.keytab
195 bind '"\eOc": shell-forward-word'
196 bind '"\eOd": shell-backward-word'
198 # i cant remember why i did this, probably to free up some keys to bind
199 # to other things in bash.
200 # other than C-c and C-z, the rest defined by stty -a are, at least in
201 # gnome-terminal, overridden by bash, or disabled by the system
202 stty lnext undef stop undef start undef
208 # fixup broken backspace in chroots
209 xterm-kitty|alacritty
)
211 TERM
=xterm-256color
command chroot
"$@"
216 export BC_LINE_LENGTH
=0
219 export PROFILE_TASKS_TASK_OUTPUT_LIMIT
=100
221 # note, if I use a machine I dont want files readable by all users, set
222 # umask 077 # If fewer than 4 digits are entered, leading zeros are assumed
224 # i for insensitive. the rest from
225 # X means dont remove the current screenworth of output upon exit
226 # R means to show colors n things
227 # a useful flag is -F aka --quit-if-one-screen
229 export SYSTEMD_LESS
=$LESS
231 export NNN_COLORS
=2136
233 export SL_FILES_DIR
=/b
/ds
/sl
/.iank
234 export SL_INFO_DIR
=/p
/sshinfo
239 if [[ -s $bashrc_dir/path-add-function
]]; then
240 source $bashrc_dir/path-add-function
241 if [[ $SSH_CLIENT ]]; then
242 if grep -qF /home
/iank
/.iank
/e
/e
/etc
/exports
&>/dev
/null
; then
243 export EMACSDIR
=/home
/iank
/.iank
/e
/e
249 # if someone exported $SOE (stop on error), catch errors.
251 # Note, on debian this results in the following warning when in ssh,
252 # hich I haven't figured out how to fix. It doesn't happen if we source
253 # after the shell has started
255 # bash: /usr/share/bashdb/bashdb-main.inc: No such file or directory
256 # bash: warning: cannot start debugger; debugging mode disabled
258 if [[ -e /a
/bin
/errhandle
/err
]]; then
259 source /a
/bin
/errhandle
/err
271 if [[ -s $path ]]; then
273 elif [[ -s $bashrc_dir/$file ]]; then
274 source $bashrc_dir/$file
279 mysrc
/a
/bin
/small-misc-bash
/ll-function
280 mysrc
/a
/bin
/distro-functions
/src
/package-manager-abstractions
282 # things to remember:
283 # ALT-C - cd into the selected directory
284 # CTRL-T - Paste the selected file path into the command line
286 # good guide to some of its basic features is the readme file
287 # https://github.com/junegunn/fzf
289 # if [[ -s /usr/share/doc/fzf/examples/key-bindings.bash ]]; then
290 # source /usr/share/doc/fzf/examples/key-bindings.bash
295 ### begin FSF section ###
297 # Comments before functions are meant to be good useful
298 # documentation. If they fail at that, please improve them or send Ian a
301 ## copy bash completion
302 # Usage: ORIGINAL_COMMAND TARGET_COMMAND...
304 # It copies how the bash completion works from one command to other
310 if ! c
=$
(complete
-p $src 2>/dev
/null
); then
311 _completion_loader
$src &>/dev
/null ||
:
312 c
=$
(complete
-p $src 2>/dev
/null
) ||
return 0
320 ## directory history tracking and navigation.
322 # cd becomes a function, also aliased to c. b to go back, f to go
323 # forward, cl to list recent directories and choose one.
325 # The finer details you may want to skip:
327 # We also define bl to print the list of back and forward directories.
329 # We keep 2 stacks, forward and back. Unlike with a web browser, the
330 # forward stack is not erased when going somewhere new.
332 # Recent directories are stored in ~/.cdirs.
334 declare -a _dir_forward _dir_back
336 # normally, the top of _dir_back is our current dir. if it isn't,
337 # put it on there, except we don't want to do that when we
338 # just launched a shell
339 if [[ $OLDPWD ]]; then
340 if (( ${#_dir_back[@]} == 0 )) ||
[[ ${_dir_back[-1]} != "$PWD" ]]; then
345 if (( ${#_dir_back[@]} == 0 )) ||
[[ ${_dir_back[-1]} != "$PWD" ]]; then
348 echo "$PWD" >> ~
/.cdirs
355 if (( ${#_dir_back[@]} == 0 )); then
356 echo "nothing left to go back to" >&2
359 top_back
="${_dir_back[-1]}"
361 if [[ $top_back == "$PWD" ]] && (( ${#_dir_back[@]} == 1 )); then
362 echo "already on last back entry" >&2
367 if [[ $top_back == "$PWD" ]]; then
368 # add to dirf if not already there
369 if (( ${#_dir_forward[@]} == 0 )) ||
[[ ${_dir_forward[-1]} != "$top_back" ]]; then
370 _dir_forward
+=("$top_back")
372 unset "_dir_back[-1]"
373 command cd "${_dir_back[-1]}"
375 if (( ${#_dir_forward[@]} == 0 )) ||
[[ ${_dir_forward[-1]} != "$PWD" ]]; then
376 _dir_forward
+=("$PWD")
378 command cd "$top_back"
381 # Interesting feature, not sure I want it.
382 # give us a peek at what is next in the list
383 # if (( ${#_dir_back[@]} >= 2 )); then
384 # printf "%s\n" "${_dir_back[-2]}"
388 # c/b/f Implementation notes:
390 # The top of the back is $PWD
391 # as long as the last directory change was due to c,b,or cl.
393 # Example of stack changes:
419 if (( ${#_dir_forward[@]} == 0 )); then
420 echo "no forward dir left" >&2
423 top_forward
="${_dir_forward[-1]}"
424 unset "_dir_forward[-1]"
427 # give us a peek at what is next in the list
428 # if (( ${#_dir_forward[@]} )); then
429 # printf "%s\n" "${_dir_forward[-1]}"
434 local i line input start
435 local -A buttondirs alines
436 local -a buttons
dirs lines
437 buttons
=( {a..z
} {2.
.9} )
438 if [[ ! -s ~
/.cdirs
]]; then
439 echo nothing
in ~
/.cdirs
445 mapfile
-t lines
<~
/.cdirs
446 start
=$
(( ${#lines[@]} - 1 ))
448 # we have ~33 buttons as of this writing, so lets
449 # prune down the history every once in a while.
450 if (( start
> 500 )); then
451 tac ~
/.cdirs |
awk '!seen[$0]++' |
head -n 200 |
tac | sponge ~
/.cdirs ||
[[ $?
== 141 ]]
454 for (( j
=$start; j
>= 0; j--
)); do
456 if [[ ! $line ||
${alines[$line]} ||
! -d "$line" ||
$line == "$PWD" || line
== "$HOME" ]]; then
460 buttondirs
[${buttons[i]}]="$line"
461 printf "%s %s\n" ${buttons[i]} "$line"
462 if (( i
== ${#buttons[@]} - 1 )); then
468 if (( i
== 0 )); then
469 echo "no dirs in ~/.cdirs"
473 if [[ $input != $
'\n' ]]; then
474 c
"${buttondirs[$input]}"
481 start
=$
(( ${#_dir_back[@]} - 1 ))
483 # cleanup possible repeating of pwd
484 if (( start
>= 0 )) && [[ ${_dir_back[$start]} == "$PWD" ]]; then
485 start
=$
(( start
- 1 ))
488 if (( start
>= 0 )); then
489 for (( i
=$start; i
>= 0 ; i--
)); do
490 printf "%s %s\n" $j ${_dir_back[i]}
492 if (( j
>= max
)); then
499 start
=$
(( ${#_dir_forward[@]} - 1 ))
501 # cleanup possible repeating of pwd
502 if (( start
>= 0 )) && [[ ${_dir_forward[$start]} == "$PWD" ]]; then
503 start
=$
(( start
- 1 ))
505 if (( start
< 0 )); then
510 for (( i
=$start; i
>= 0 ; i--
)); do
511 printf "%s %s\n" $j ${_dir_forward[i]}
513 if (( j
>= max
)); then
519 # pee do. run args as a command with output copied to syslog.
521 # Usage: pd [-t TAG] COMMAND...
523 # -t TAG Override the tag in the syslog. The default is COMMAND with
524 # any path part is removed, eg. for /bin/cat the tag is cat.
526 # You can view the log via "journalctl -t TAG"
532 -t) tag
="$2"; shift 2 ;;
534 echo "PWD=$PWD command: $*" | logger
-t $tag
535 "$@" |
& pee
cat "logger -t $tag" || ret
=$?
536 echo "exited with status=$ret" | pee
cat "logger -t $tag"
537 # this avoids any err-catch
538 (( $ret == 0 )) ||
return $ret
542 # jdo = journal do. Run command as transient systemd service, tailing
543 # its output in the journal until it completes.
545 # Usage: jdo COMMAND...
547 # Compared to pd: commands recognize this is a non-interactive shell.
548 # The service is unaffected if our ssh connection dies, no need to run
551 # Note: The last few lines of any existing entries for a unit by that
552 # name will be output first, and there will be a few second delay at the
553 # start of the command, and a second or so at the end.
555 # Note: Functions and aliases obviously won't work, we resolve the
558 # Note: requires running as root.
560 local cmd cmd_name jr_pid ret
564 if [[ $EUID != 0 ]]; then
565 echo "jdo: error: rerun as root"
569 if [[ $cmd != /* ]]; then
570 cmd
=$
(type -P "$cmd")
573 journalctl
-qn2 -f -u "$cmd_name" &
574 # Trial and error of time needed to avoid missing initial lines.
575 # .5 was not reliable. 1 was not reliable. 2 was not reliable
578 systemd-run
--unit "$cmd_name" --wait --collect "$cmd" "$@" || ret
=$?
579 # The sleep lets the journal output its last line
580 # before the prompt comes up.
582 kill $jr_pid &>/dev
/null ||
:
585 # this avoids any err-catch
586 (( $ret == 0 )) ||
return $ret
594 ....
() { c ..
/..
/..
; }
595 .....
() { c ..
/..
/..
/..
; }
596 ......
() { c ..
/..
/..
/..
/..
; }
601 path
=$
(readlink
-e "$f")
602 echo "cat >$path <<'EOF'"
609 # file cut copy and paste, like the text buffers :)
610 # I havnt tested these.
611 _fbufferinit
() { # internal use
612 ! [[ $my_f_tempdir ]] && my_f_tempdir
=$
(mktemp
-d)
613 rm -rf "${my_f_tempdir:?}"/*
617 cp "$@" "$my_f_tempdir"/
621 mv "$@" "$my_f_tempdir"/
623 fpst
() { # file paste
624 [[ $2 ]] && { echo too many arguments
; return 1; }
626 cp "$my_f_tempdir"/* "$target"
630 local host ip port
file key
631 read -r host ip port
< <(timeout
-s 9 2 ssh -oBatchMode=yes -oControlMaster=no
-oControlPath=/ -v $1 |
& sed -rn "s/debug1: Connecting to ([^ ]+) \[([^\]*)] port ([0-9]+).*/\1 \2 \3/p" ||
: )
632 file=$
(readlink
-f ~
/.ssh
/known_hosts
)
634 echo "khfix: ssh failed"
637 if [[ $port != 22 ]]; then
638 ip_entry
="[$ip]:$port"
639 host_entry
="[$host]:$port"
645 if [[ $host != $ip ]]; then
646 key
=$
(ssh-keygen
-F "$host_entry" -f $file |
sed -r 's/^.*([^ ]+ +[^ ]+) *$/\1/')
648 grep -Fv "$key" "$file" | sponge
"$file"
651 key
=$
(ssh-keygen
-F "$ip_entry" -f $file |
sed -r 's/^.*([^ ]+ +[^ ]+) *$/\1/')
653 grep -Fv "$key" "$file" | sponge
"$file"
655 ll ~
/.ssh
/known_hosts
658 khfix
() { # known hosts fix
659 _khfix_common
"$@" ||
return 1
667 # ya, hacky hardcoded hostnames in 2023. we could do better
669 local -a failed_hosts
670 for host in kd x3.office.fsf.org syw
; do
672 if ! scp
/b
/fai
/fai
/config
/files
/usr
/local
/bin
/hssh
/IANK root@
$host:/usr
/local
/bin
/hssh
; then
673 failed_hosts
+=($host)
676 if (( ${#failed_hosts[@]} >= 1 )); then
677 echo failed_hosts
=${failed_hosts[*]}
684 x
=$
(readlink
-nf "${1:-$PWD}")
685 # yes, its kinda dumb that xclip/xsel cant do this in one invocation
686 echo -n "$x" | xclip
-selection clipboard
690 # a1 = awk {print $1}
691 for field
in {1.
.20}; do
692 eval a
$field"() { awk '{print \$$field}'; }"
695 for num
in {1.
.9}; do
696 eval h
$num"() { head -n$num; }"
701 printf '%d.%d.%d.%d\n' $
(echo $1 |
sed 's/../0x& /g')
705 local f out outdir
in fname origdir skip1
709 while [[ $1 == -* ]]; do
711 # if we got interrupted after 1st phase
723 # first pass only uses about 1 cpu, so run in parallel
727 if [[ $f == /* ]]; then
732 out
="$origdir/$outdir/$fname"
733 mkdir
-p /tmp
/vp
9/$fname
735 if ! $skip1 && [[ ! -s ffmpeg2pass-0.log
]]; then
736 # -nostdin or else wait causes ffmpeg to go into stopped state. dunno why, random stackoverflow answer.
737 m ffmpeg
-nostdin -hide_banner -loglevel error
-i $in -g 192 -vcodec libvpx-vp9
-vf scale
=-1:720 -max_muxing_queue_size 9999 -b:v
750K
-pass 1 -an -f null
/dev
/null
739 if [[ -e $out ]]; then rm -f $out; fi
740 m ffmpeg
-nostdin -hide_banner -loglevel error
-y -i $in -g 192 -vcodec libvpx-vp9
-tile-rows 2 -vf scale
=-1:720 -max_muxing_queue_size 9999 -b:v
750K
-pass 2 -c:a libvorbis
-qscale:a
5 $out
747 utcl
() { # utc 24 hour time to local hour 24 hour time
748 echo "print( ($1 $(date +%z | sed -r 's/..$//;s/^(-?)0*/\1/')) % 24)"|python3
756 # for running in a fai rescue. iank specific.
758 d
=vgata-Samsung_SSD_850_EVO_2TB_S2RLNX0J502123D
759 for f
in $d vgata-Samsung_SSD_870_QVO_8TB_S5VUNG0N900656V
; do
760 cryptsetup luksOpen
--key-file /p
/dev
/$f/root crypt-
$f-root
761 cryptsetup luksOpen
--key-file /p
/dev
/$f/o crypt-
$f-o
763 mount
-o subvol
=root_trisquelaramo
/dev
/mapper
/crypt-
$d-root /mnt
764 mount
-o subvol
=a
/dev
/mapper
/crypt-
$d-root /mnt
/a
765 mount
-o subvol
=o
/dev
/mapper
/crypt-
$d-o /mnt
/o
766 mount
-o subvol
=boot_trisquelaramo
/dev
/sda2
/mnt
/boot
774 c4
() { c
/var
/log
/exim4
; }
776 caa
() { git commit
--amend --no-edit -a; }
787 # shellcheck disable=SC2033
788 find -L "$@" -type f
-not \
( -name .svn
-prune -o -name .git
-prune \
789 -o -name .hg
-prune -o -name .editor-backups
-prune \
790 -o -name .undo-tree-history
-prune \
) \
791 -exec bash
-c '. ~/.bashrc; hr; echo "$1"; hr; cat "$1"' _
{} \
; 2>/dev
/null
796 calc
() { echo "scale=3; $*" |
bc -l; }
797 # no having to type quotes, but also no command history:
801 echo "scale=3; $x" |
bc -l
808 ccat
() { # config cat. see a config without extra lines.
809 sed -r '/^[[:space:]]*([;#]|--|\/\/|$)/d' "$@"
815 # dev/pts needed for pacman signature check
816 for d
in dev proc sys dev
/pts
; do
818 if ! mountpoint
$d &>/dev
/null
; then
819 m s mount
-o bind /$d $d
825 # dev/pts needed for pacman signature check
826 for d
in dev
/pts dev proc sys
; do
828 if mountpoint
$d &>/dev
/null
; then
836 # join options which are continued to multiples lines onto one line
838 while IFS
= read -r line
; do
839 # remove leading spaces/tabs. assumes extglob
840 if [[ $line == "[ ]*" ]]; then
846 elif [[ $line == *=* ]]; then
847 echo "$pastline" >> "$2"
850 pastline
="$pastline $line"
852 done < <(grep -vE '^([ \t]*#|^[ \t]*$)' "$1")
853 echo "$pastline" >> "$2"
858 # setup for format of postfix, eg:
861 local pastline unified f1 f2
865 _cdiff-prep
"$1" "$f1"
866 _cdiff-prep
"$2" "$f2"
867 cat "$f1" "$f2" |
grep -Po '^[^=]+=' |
sort |
uniq > "$unified"
868 while IFS
= read -r line
; do
869 # the default bright red / blue doesnt work in emacs shell
870 dwdiff
-cblue,red
-A best
-d " ," <(grep "^$line" "$f1" ||
echo ) <(grep "^$line" "$f2" ||
echo ) | colordiff
878 # shellcheck disable=SC2030
879 inotifywait
-m "$dir" -e create
-e moved_to | \
880 while read -r filedir _
file; do
883 calc $
((SECONDS
- start
)) / 60
890 s chown
-R $USER:$USER "$@"
893 # shellcheck disable=SC2032
895 # makes it so chown -R symlink affects the symlink and its target.
896 if [[ $1 == -R ]]; then
898 command chown
-h "$@"
899 command chown
-R "$@"
910 d
() { builtin bg "$@"; }
913 # f would be more natural, but i already am using it for something
914 z
() { builtin fg "$@"; }
917 x
() { builtin kill %%; }
920 diff --strip-trailing-cr -w "$@" # diff content
928 safe_rename
"$x" "$y"
933 # usage: dfp MOUNTPOINT [SECOND_INTERVAL]
934 # SECOND_INTERVAL defaults to 90
937 local a b mp interval
941 echo "dfp: error, missing 1st arg" >&2
945 a
=$
(df
--output=used
$mp |
tail -n1)
947 b
=$
(df
--output=used
$mp |
tail -n1)
948 printf "used mib: %'d mib/min: %s\n" $
(( b
/1000 )) $
(( (b-a
) / (interval
* 1000 / 60 ) ))
952 # get ipv4 ip from HOST. or if it is already a number, return that
960 getent ahostsv4
"$host" |
awk '{ print $1 }' |
head -n1
966 command dig +nostats
+nocmd
"$@"
968 # Output with sections sorted, and removal of query id, so 2 dig outputs can be diffed.
972 dig +nordflag
"$@" |
sed -r 's/^(;; ->>HEADER<<-.*), id: .*/\1/' |
while read -r l
; do
973 if [[ $l == [^\
;]* ]]; then
977 printf "%s" "$sec" |
sort
985 # compare digs to the 2 servers
986 # usage: digdiff @server1 @server2 DIG_ARGS
987 # note: only the soa master nameserver will respond with
988 # ra "recursive answer" flag. That difference is meaningless afaik.
995 digsort
$s1 "$@" |
tee /tmp
/digdiff
996 diff -u /tmp
/digdiff
<(digsort
$s2 "$@")
999 # date in a format i like reading
1001 date "+%A, %B %d, %r" "$@"
1006 # date with all digits in a format i like
1010 ccomp
date dt dtr dtd
1012 dus
() { # du, sorted, default arg of
1013 du
-sh ${@:-*} |
sort -h
1018 e
() { printf "%s\n" "$*"; }
1026 printf "%qEOL\n" "${arg}"
1027 printf "%s" "${arg}" |
& hexdump -C
1031 # echo variables. print var including escapes, etc, like xxd for variable
1037 if [[ -v $arg ]]; then
1038 printf "%qEOL\n" "${!arg}"
1039 printf "%s" "${!arg}" |
& hexdump -C
1041 echo arg
$arg is
unset
1047 [[ ${#@} == 2 ]] ||
{ echo "error: ediff requires 2 arguments"; return 1; }
1048 emacs
--eval "(ediff-files \"$1\" \"$2\")"
1054 tail -F /var
/log
/exim
4/mainlog
/var
/log
/exim
4/*main
/var
/log
/exim
4/paniclog
/var
/log
/exim
4/*panic
-n 200 "$@"
1058 tail -F /var
/log
/exim
4/mainlog
-n 200 "$@"
1061 tail -F /var
/log
/exim
4/mymain
-n 200 "$@"
1063 ccomp
tail etail etail2
1065 # ran into this online, trying it out
1067 ( "$@" &>/dev
/null
& disown )
1071 ssh "$@" cat .ssh
/authorized_keys
{,2}
1075 # print exim old pids
1077 local configtime pid piduptime now daemonpid
1078 printf -v now
'%(%s)T' -1
1079 configtime
=$
(stat
-c%Y
/var
/lib
/exim
4/config.autogenerated
)
1080 if [[ -s /run
/exim
4/exim.pid
]]; then
1081 daemonpid
=$
(cat /run
/exim
4/exim.pid
)
1083 for pid
in $
(pgrep
-f '^/usr/sbin/exim4( |$)'); do
1084 # the daemonpid gets reexeced on HUP (service reloads), keeping its same old timestamp
1085 if [[ $pid == $daemonpid ]]; then
1088 piduptime
=$
(awk -v ticks
="$(getconf CLK_TCK)" 'NR==1 { now=$1; next } END { printf "%9.0f\n", now - ($20/ticks) }' /proc
/uptime RS
=')' /proc
/$pid/stat
) ||
: # sometimes pids disappear pretty fast
1089 if (( configtime
> now
- piduptime
)); then
1095 # exim tail but only watch lines from new pids
1098 for pid
in $
(eoldpids
); do
1101 if [[ $oldpids ]]; then
1102 etail |
awk '$3 !~ /^\[('"${oldpids%|}"')\]$/'
1107 # exim watch as old pids go away
1109 local configtime pid piduptime now
1114 oldpids
=($
(eoldpids
))
1115 if (( ! ${#oldpids[@]} )); then
1118 # print the date every 20 iterations
1119 if (( ! count
% 20 )); then
1123 ps
-f -p "${oldpids[*]}"
1129 less /var
/log
/exim
4/mainlog
1133 exiqgrep
-ir.\
* -o 60 |
while read -r i
; do
1136 hlm exigrep
$i /var
/log
/exim
4/mainlog |
cat ||
:
1140 # other ways to get the list of message ids:
1141 # exim -bp | awk 'NF == 4 {print $3}'
1142 # # this is slower 160ms, vs 60.
1144 exiqgrep
-ir.\
* |
xargs exim
-Mrm
1149 mkdir
-p /tmp
/edev
/etc
1150 cp -ra /etc
/exim4
/tmp
/edev
/etc
1151 cp -ra /etc
/alias* /tmp
/edev
/etc
1152 find /tmp
/edev
/etc
/exim4
-type f
-execdir sed -i "s,/etc/,/tmp/edev/etc/,g" '{}' +
1156 update-exim4.conf
-d /tmp
/edev
/etc
/exim4
-o /tmp
/edev
/e.conf
1160 # show important information about incoming mail in the exim log
1162 sed -rn '/testignore|jtuttle|eximbackup/!s/^[^ ]+ ([^ ]+) [^ ]+ [^ ]+ <= ([^ ]+).*T="(.*)" from (<[^ ]+> .*$)/\1 \4\n \3/p' <${1:-/var/log/exim4/mainlog}
1165 # 2nd line is message-id:
1167 sed -rn '/testignore|jtuttle|eximbackup/!s/^[^ ]+ ([^ ]+) [^ ]+ [^ ]+ <= ([^ ]+).* id=([^ ]+) T="(.*)" from (<[^ ]+> .*$)/\1 \5\n \3\n \4/p' <${1:-/var/log/exim4/mainlog}
1170 tail -F /var
/log
/exim
4/mainlog |
sed -rn '/testignore|jtuttle|eximbackup/!s/^[^ ]+ ([^ ]+) [^ ]+ [^ ]+ <= ([^ ]+).*T="(.*)" from (<[^ ]+> .*$)/\1 \4\n \3/p'
1177 # find array. make an array of file names found by find into $x
1178 # argument: find arguments
1179 # return: find results in an array $x
1180 while read -rd ''; do
1182 done < <(find "$@" -print0);
1185 faf
() { # find all files. use -L to follow symlinks
1186 find "$@" -not \
( -name .svn
-prune -o -name .git
-prune \
1187 -o -name .hg
-prune -o -name .editor-backups
-prune \
1188 -o -name .undo-tree-history
-prune \
) -type f
2>/dev
/null
1191 # usage ffconcat FILES_TO_CONCAT OUTPUT_FILE
1195 printf "file '%s'\n" "$1" >$tmpf
1196 while (( $# > 1 )); do
1198 printf "file '%s'\n" "$1" >>$tmpf
1200 # https://trac.ffmpeg.org/wiki/Concatenate
1201 ffmpeg
-f concat
-safe 0 -i $tmpf -c copy
"$1"
1206 if (( $# == 0 )); then
1207 echo ffremux error expected args
>&2
1212 tmpf
=$tmpd/"${f##*/}"
1213 ffmpeg
-i "$f" -c:v copy
-c:a copy
$tmpf
1221 # absolute path of file/dir without resolving symlinks.
1223 # Most of the time, I want this where I would normally use readlink.
1224 # This is what realpath -s does in most cases, but sometimes it
1225 # actually resolves symlinks, at least when they are in /.
1227 # Note, if run on a dir, if the final component is relative, it won't
1228 # resolve that. Use the below fpd for that.
1230 # note: we could make a variation of this which
1231 # assigns to a variable name using eval, so that we don't have to do
1232 # x=$(fp somepath), which might save subshell overhead and look nice,
1233 # but I'm not going to bother.
1235 local initial_oldpwd initial_pwd dir base
1236 initial_oldpwd
="$OLDPWD"
1238 if [[ $1 == */* ]]; then
1241 # CDPATH because having it set will cause cd to possibly print output
1243 printf "%s%s\n" "$PWD" "$base"
1244 CDPATH
= cd "$initial_pwd"
1245 OLDPWD
="$initial_oldpwd"
1247 printf "%s/%s\n" "$PWD" "$1"
1250 # full path of directory without resolving symlinks
1252 local initial_oldpwd initial_pwd dir
1253 initial_oldpwd
="$OLDPWD"
1257 printf "%s%s\n" "$PWD" "$base"
1259 OLDPWD
="$initial_oldpwd"
1266 sudo mailq |gr frozen|
awk '{print $3}' |
while read -r id
; do
1272 echo -e '\n\n##############################\n'
1273 done |
tee -a /tmp
/frozen
1277 while read -r line
; do
1278 printf '%s\n' "$line"
1279 ids
+=($
(printf '%s\n' "$line" |gr frozen|
awk '{print $3}'))
1281 echo "sleeping for 2 in case you change your mind"
1283 sudo exim
-Mrm "${ids[@]}"
1287 # like -e for functions. returns on error.
1288 # at the end of the function, disable with:
1290 trap 'echo "${BASH_COMMAND:+BASH_COMMAND=\"$BASH_COMMAND\" }
1291 ${FUNCNAME:+FUNCNAME=\"$FUNCNAME\" }${LINENO:+LINENO=\"$LINENO\" }\$?=$?"
1297 local help="Usage: getdir [--help] PATH
1298 Output the directory of PATH, or just PATH if it is a directory."
1299 if [[ $1 == --help ]]; then
1303 if [[ $# -ne 1 ]]; then
1304 echo "getdir error: expected 1 argument, got $#"
1307 if [[ -d $1 ]]; then
1311 dir
="$(dirname "$1")"
1312 if [[ -d $dir ]]; then
1315 echo "getdir error: directory does not exist"
1321 git_empty_branch
() { # start an empty git branch. carefull, it deletes untracked files.
1322 [[ $# == 1 ]] ||
{ echo 'need a branch name!'; return 1;}
1324 root
=$
(gitroot
) ||
return 1 # function to set gitroot
1326 git symbolic-ref HEAD refs
/heads
/$1
1331 # shellcheck disable=SC2120
1333 local help="Usage: gitroot [--help]
1334 Print the full path to the root of the current git repo
1336 Handles being within a .git directory, unlike git rev-parse --show-toplevel,
1337 and works in older versions of git which did not have that."
1338 if [[ $1 == --help ]]; then
1343 p
=$
(git rev-parse
--git-dir) ||
{ echo "error: not in a git repo" ; return 1; }
1344 [[ $p != /* ]] && p
=$PWD
1350 # todo: patch emacs so it will look elsewhere. this is kinda sad:
1351 # https://emacs.stackexchange.com/questions/4253/how-to-start-emacs-with-a-custom-user-emacs-directory
1353 local args gdb
=false
1355 if [[ $EMACSDIR ]]; then
1356 path-add
"$EMACSDIR/lib-src" "$EMACSDIR/src"
1359 if [[ $DISPLAY ]]; then
1363 if (( $# == 0 )); then
1366 # duplicate -c, but oh well
1367 if ! pgrep
-u $EUID emacsclient
; then
1368 if (( $# == 0 )) && type -p gdb
&>/dev
/null
; then
1374 if [[ $EMACSDIR ]]; then
1375 # Alter the path here, otherwise the nfs mount gets triggered on the
1376 # first path lookup when emacs is not being used.
1377 PATH
="$EMACSDIR/lib-src:$EMACSDIR/src:$PATH" EHOME
=$HOME HOME
=$EMACSDIR m emacsclient
-a "" $args "$@"
1380 # due to a bug, we cant debug from the start unless we get a new gdb
1381 # https://sourceware.org/bugzilla/show_bug.cgi?id=24454
1382 # m gdb -ex="set follow-fork-mode child" -ex=r -ex=quit --args emacs --daemon
1383 m emacsclient
-a "" $args "$@"
1385 cd /a
/opt
/emacs-$
(distro-name
)$
(distro-num
)
1386 s gdb
-p $
(pgrep
-f 'emacs --daemon') -ex c
1389 m emacsclient
-a "" $args "$@"
1394 # force terminal version
1400 # quit will prompt if the program crashes.
1401 gdb
-ex=r
-ex=quit
--args emacs
"$@"; r
;
1405 # kill the emacs daemon
1410 grep -iIP --color=auto
"$@" ||
return $?
1412 grr
() { # grep recursive
1413 # Don't return 1 on nonmatch because this is meant to be
1414 # interactive, not in a conditional.
1415 if [[ ${#@} == 1 ]]; then
1416 grep --exclude-dir='*.emacs.d' --exclude-dir='*.git' -riIP --color=auto
"$@" . ||
[[ $?
== 1 ]]
1418 grep --exclude-dir='*.emacs.d' --exclude-dir='*.git' -riIP --color=auto
"$@" ||
[[ $?
== 1 ]]
1426 # recursive everything. search for files/dirs and lines. rs = easy chars to press
1430 find "$@" -not \
( -name .svn
-prune -o -name .git
-prune \
1431 -o -name .hg
-prune -o -name .editor-backups
-prune \
1432 -o -name .undo-tree-history
-prune \
) 2>/dev
/null |
grep -iP --color=auto
"$query"
1436 # horizontal row. used to break up output
1439 # 180 is long enough.
1440 blocks
=██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
1441 printf "%s\n" "$(tput setaf 5 2>/dev/null ||:)${blocks:0:${COLUMNS:-180}}$(tput sgr0 2>/dev/null||:)"
1445 local col input_len
=0
1447 input_len
=$
((input_len
+ 1 + ${#arg}))
1449 col=$
((60 - input_len
))
1450 printf "\e[1;97;41m%s" "$*"
1451 if (( col > 0 )); then
1452 printf "\e[1;97;41m \e[0m%.0s" $
(eval echo "{1..${col}}")
1456 hlm
() { hl
"$*"; "$@"; }
1458 hrcat
() { local f
; for f
; do [[ -f $f ]] ||
continue; hr
; echo "$f"; cat "$f"; done }
1461 # get latest hub and run it
1462 # main command to use:
1463 # hub pull-request --no-edit
1464 # --no-edit means to use the first commit\'s message as the pull request message.
1465 # If that fails, try doing
1466 # hub pull-request --no-edit -b UPSTREAM_OWNER:branch
1467 # where branch is usually master. it does the pr against your current branch.
1469 # On first use, you input username/pass and it gets an oath token so you dont have to repeat
1470 # it\'s at ~/.config/hub
1472 local up uptar updir p v
1473 # example https://github.com/github/hub/releases/download/v2.14.2/hub-linux-amd64-2.14.2.tgz
1474 up
=$
(wget
-q -O- https
://api.github.com
/repos
/github
/hub
/releases
/latest | jq
-r .assets
[].browser_download_url |
grep linux-amd64
)
1476 if [[ ! $up ||
$up == $re ]]; then
1477 echo "failed to get good update url. got: $up"
1481 if [[ ! -e /a
/opt
/$updir ]]; then
1482 rm -rf /a
/opt
/hub-linux-amd64
*
1484 tar -C /a
/opt
-zxf /a
/opt
/$uptar
1487 if ! which hub
&>/dev
/null
; then
1488 sudo
/a
/opt
/$updir/install
1491 # save token across computers
1492 if [[ ! -L ~
/.config
/hub
]]; then
1493 if [[ -e ~
/.config
/hub
]]; then
1494 mv ~
/.config
/hub
/p
/c
/subdir_files
/.config
/
1496 if [[ -e /p
/c
/subdir_files
/.config
/hub
]]; then
1510 # cvs update -C FILE
1515 # potentially useful command translation
1516 # https://fling.seas.upenn.edu/~giesen/dynamic/wordpress/equivalent-commands-for-git-svn-and-cvs/
1518 # importing cvs repo into git using git-cvs package:
1519 # /f/www $ /usr/lib/git-core/git-cvsimport -C /f/www-git
1535 find -L "$@" -not \
( -name .svn
-prune -o -name .git
-prune \
1536 -o -name .hg
-prune -o -name .editor-backups
-prune \
1537 -o -name .undo-tree-history
-prune \
) -iname "*$glob*" 2>/dev
/null
1541 # insensitive find here. args are combined into the search string.
1542 # -L = follow symlinks
1543 find -L .
-not \
( -name .svn
-prune -o -name .git
-prune \
1544 -o -name .hg
-prune -o -name .editor-backups
-prune \
1545 -o -name .undo-tree-history
-prune \
) -iname "*$**" 2>/dev
/null
1549 # insensitive find directory
1550 find -L .
-type d
-not \
( -name .svn
-prune -o -name .git
-prune \
1551 -o -name .hg
-prune -o -name .editor-backups
-prune \
1552 -o -name .undo-tree-history
-prune \
) -iname "*$**" 2>/dev
/null
1557 sudo iptables
-A INPUT
-s $1 -j DROP
1562 grep -Il "" "$@" &>/dev
/null
1570 journalctl
-n 10000 -f "$@"
1572 jr
() { journalctl
"$@" ; }
1573 jrf
() { journalctl
-f "$@" ; }
1575 journalctl
-u exim4 _SYSTEMD_INVOCATION_ID
=$
(systemctl show
-p InvocationID
--value $1)
1581 if [[ $PWD == /[iap
] ]]; then
1582 command ls -A --color=auto
-I lost
+found
"$@"
1584 command ls -A --color=auto
"$@"
1588 lcn
() { locate -i "*$**"; }
1590 lg
() { LC_COLLATE
=C.UTF-8 ll
--group-directories-first "$@"; }
1592 lt
() { ll
-tr "$@"; }
1594 lld
() { ll
-d "$@"; }
1596 ccomp
ls l lg lt lld ll
1602 for dirs in false true
; do
1604 if [[ -d $f ]]; then
1606 # reverse the order to rename the nested dirs first.
1607 # note: 0 element is the dir itself
1608 for ((i
=${#all[@]}-1; i
>=1; i--
)); do
1610 if $dirs && [[ -d $a ]]; then
1611 # e dirs low "$a" # debug
1613 elif ! $dirs && [[ ! -d $a && -e $a ]]; then
1615 # e not dirs low "$a" # debug
1620 # just rename all the top level args on the second pass
1622 # e final dirs low "$f" # debug
1629 low
() { # make filenames lowercase, remove bad chars
1632 arg
="${arg%%+(/)}" # remove trailing slashes. assumes we have extglob on.
1634 if (( ${#dir} == ${#arg} )); then
1638 new
="${f,,}" # downcase
1639 new
="${new//[^a-zA-Z0-9._-]/_}" # sub bad chars
1640 new
="${new#"${new%%[[:alnum:]]*}"}" # remove leading/trailing non-alnum
1641 new
="${new%"${new##*[[:alnum:]]}"}"
1642 # remove bad underscores, like __ and _._
1643 new
=$
(echo $new |
sed -r 's/__+/_/g;s/_+([.-])|([.-])_+/\1/g')
1644 safe_rename
"$dir/$f" "$dir/$new" ||
return 1
1649 lower
() { # make first letter of filenames lowercase.
1652 if [[ ${x::1} == [A-Z
] ]]; then
1653 y
=$
(tr '[:upper:]' '[:lower:]' <<<"${x::1}")"${x:1}"
1654 safe_rename
"$x" "$y" ||
return 1
1660 k
() { # history search
1661 grep -iP --binary-files=text
"$@" ${HISTFILE:-~/.bash_history} |
tail -n 80 ||
[[ $?
== 1 ]];
1663 ks
() { # history search with context
1664 # args are an extended regex used by sed
1665 history |
sed -nr "h;s/^\s*(\S+\s+){4}//;/$*/{g;p}" |
tail -n 80 ||
[[ $?
== 1 ]];
1667 ksu
() { # history search unique
1668 grep -P --binary-files=text
"$@" ${HISTFILE:-~/.bash_history} |
uniq ||
[[ $?
== 1 ]];
1671 # todo: id like to do maybe a daily or hourly cronjob to
1672 # check that my history file size is increasing. Ive had it
1673 # inexplicably truncated in the past.
1676 HISTTIMEFORMAT
= history |
awk -v IGNORECASE
=1 '{ a=$1; sub(/^ *[^ ]+ */, "") }; /'"$*"'/'
1677 read -r -p "press anything but contrl-c to delete"
1678 for entry
in $
(HISTTIMEFORMAT
= history |
awk -v IGNORECASE
=1 '{ a=$1; sub(/^ *[^ ]+ */, "") }; /'"$*"'/ { print a }' |
tac); do
1684 ccomp
grep k ks ksu histrm
1688 # show make targets, via http://stackoverflow.com/questions/3063507/list-goals-targets-in-gnu-make
1689 make -qp |
awk -F':' '/^[a-zA-Z0-9][^$#\/\t=]*:([^=]|$)/ {split($1,A,/ /);for(i in A)print A[i]}'
1701 # mkdir the last arg, cp the rest into it
1704 cp "${@:1:$#-1}" "${@: -1}"
1708 mv "${@:1:$#-1}" "${@: -1}"
1711 mkt
() { # mkdir and touch file
1713 mkdir
-p "$(dirname "$path")"
1717 # shellcheck disable=SC2032
1718 mkdir
() { command mkdir
-p "$@"; }
1721 # https://github.com/HenriWahl/Nagstamon/issues/357
1722 if ! pgrep
-f /usr
/lib
/notification-daemon
/notification-daemon
>/dev
/null
; then
1723 /usr
/lib
/notification-daemon
/notification-daemon
&
1725 /usr
/bin
/nagstamon
&
1729 # cant use s because sudo -i doesnt work for passwordless sudo command
1732 sudo nmtui-connect
"$@"
1742 if shopt nullglob
>/dev
/null
; then
1756 # shellcheck disable=SC2024
1758 for f
in /var
/log
/exim
4/paniclog
/var
/log
/exim
4/*panic
; do
1760 if [[ -s $f ]]; then
1761 echo ================== $f =============
1762 s
tee -a /var
/log
/exim
4/$base-archive <$f
1770 ping() { command ping -O "$@"; }
1771 p8
() { ping "$@" 8.8.8.8; }
1772 p6
() { ping6
"$@" 2001:4860:4860::8888; }
1774 pkx
() { # package extract
1775 local pkg cached tmp f
1778 # shellcheck disable=SC2012
1779 cached
=$
(ls -t /var
/cache
/apt
/archives
/$pkg* |
tail -n1 2>/dev
/null
) ||
:
1780 if [[ $cached ]]; then
1783 aptitude download
$pkg ||
return 1
1785 tmp
=(*); f
=${tmp[0]} # only 1 expected
1793 pid
=($
(pgrep
-f "$*"))
1796 # shellcheck disable=SC2128
1802 0) echo "no pid found" ;;
1811 help="Usage: psg [--help] GREP_ARGS
1812 grep ps and output in a nice format"
1813 if [[ $1 == --help ]]; then
1818 # final grep is because some commands tend to have a lot of trailing spaces
1819 y
=$
(echo "$x" |
grep -iP "$@" |
grep -o '.*[^ ]') ||
:
1821 echo "$x" |
head -n 1 ||
[[ $?
== 141 ]]
1826 pubip
() { curl
-4s https
://icanhazip.com
; }
1827 pubip6
() { curl
-6s https
://icanhazip.com
; }
1828 whatismyip
() { pubip
; }
1831 q
() { # start / launch a program in the backround and redir output to null
1835 # shellcheck disable=SC2120
1837 if [[ $HISTFILE ]]; then
1838 history -a # save history
1840 trap ERR
# this avoids a segfault
1842 # i had this redir, not sure why
1843 # exit "$@" 2>/dev/null
1846 # scp is insecure and deprecated.
1848 rsync
-Pt --inplace "$@"
1853 # available high ports are 1024-65535,
1854 # but lets skip things that are more likely to be in use
1857 print(secrets.SystemRandom().randrange(10002,65500))
1872 # rsync, root is required to keep permissions right.
1873 # rsync --archive --human-readable --verbose --itemize-changes --checksum \(-ahvic\) \
1874 # --no-times --delete
1875 # basically, make an exact copy, use checksums instead of file times to be more accurate
1876 rsync
-ahvic --delete "$@"
1879 # like rlu, but dont delete files on the target end which
1880 # do not exist on the original end.
1884 # rl without preserving modification time.
1885 rsync
-ahvic --delete --no-t "$@"
1887 # [RSYNC_OPTS] HOST PATH
1889 # eg. rsu -opts frodo /testpath
1890 # relative paths will expanded with readlink -f.
1891 opts
=("${@:1:$#-2}") # 1 to last -2
1892 path
="${*:$#}" # last
1893 host="${*:$#-1:1}" # last -1
1894 if [[ $path == .
* ]]; then
1895 path
=$
(readlink
-f $path)
1897 m rsync
-ahvi --relative --no-implied-dirs "${opts[@]}" "$path" "root@$host:/";
1899 ccomp rsync rsd rsa rst rsu
1901 # find programs listening on a port
1904 # to figure out these args, i had to look at the man page from git version, as of 2022-04.
1905 s ss
-lpn state listening sport
= $port
1910 if [[ $
(systemctl is-active nscd ||
:) != inactive
]]; then
1915 hr
; s ss
-lpn sport
= 53
1916 if systemctl is-enabled dnsmasq
&>/dev
/null ||
[[ $
(systemctl is-active dnsmasq ||
:) != inactive
]]; then
1917 # this will fail is dnsmasq is failed
1918 hr
; m ser status dnsmasq |
cat ||
:
1920 hr
; echo $f:; ccat
$f
1921 hr
; m grr
'^ *(servers-file|server) *=|^ *no-resolv *$' /etc
/dnsmasq.conf
/etc
/dnsmasq.d
1922 f
=/etc
/dnsmasq-servers.conf
1923 hr
; echo $f:; ccat
$f
1926 echo /etc
/nsswitch.conf
:
1927 grep '^ *hosts:' /etc
/nsswitch.conf
1928 if systemctl is-enabled systemd-resolved
&>/dev
/null ||
[[ $
(systemctl is-active systemd-resolved ||
:) != inactive
]]; then
1929 hr
; m ser status systemd-resolved |
cat ||
:
1930 hr
; m resolvectl status |
cat
1938 if [[ $
(systemctl is-active nscd ||
:) != inactive
]]; then
1942 m sudo nscd
-i hosts
1944 if [[ $
(systemctl is-active dnsmasq ||
:) != inactive
]]; then
1945 m sudo systemctl restart dnsmasq
1947 if [[ $
(systemctl is-active systemd-resolved ||
:) != inactive
]]; then
1948 m sudo systemctl restart systemd-resolved
1950 if type -P resolvectl
&>/dev
/null
; then
1951 resolvectl flush-caches
1955 # add annoyingly long argument which should be the default
1957 sed -i --follow-symlinks "$@"
1961 ssh fencepost
head -n 300 /gd
/gnuorg
/EventAndTravelInfo
/rms-current-trips.txt |
less
1970 command sudo
"$@" ||
return $?
1975 # I use a function because otherwise we cant use in a script,
1976 # cant assign to variable.
1978 # note: gksudo is recommended for X apps because it does not set the
1979 # home directory to the same, and thus apps writing to ~ fuck things up
1980 # with root owned files.
1982 if [[ $EUID != 0 ||
$1 == -* ]]; then
1983 # shellcheck disable=SC2034
1984 SUDOD
="$PWD" command sudo
-i "$@"
1990 sb
() { # sudo bash -c
1991 # use sb instead of s is for sudo redirections,
1992 # eg. sb 'echo "ok fine" > /etc/file'
1993 # shellcheck disable=SC2034
1995 sudo
-i bash
-c "$@"
1998 se
() { s urun
0077 "$@"; }
2001 safe_rename
() { # warn and dont rename if file exists.
2002 # mv -n exists, but it\'s silent
2003 if [[ $# != 2 ]]; then
2004 echo safe_rename error
: $# args
, need
2 >2
2007 if [[ $1 != "$2" ]]; then # yes, we want to silently ignore this
2008 if [[ -e $2 ||
-L $2 ]]; then
2009 echo "Cannot rename $1 to $2 as it already exists."
2018 sudo
dd status
=none of
="$1"
2022 if type -p systemctl
&>/dev
/null
; then
2025 if (( $# >= 3 )); then
2026 echo iank
: ser expected
2 or
less arguments
2033 systemctl
-n 40 status
"$@"
2036 seru
() { systemctl
--user "$@"; }
2037 # like restart, but do nothing if its not already started
2040 if [[ $
(s systemctl
--no-pager show
-p ActiveState
$service ) == ActiveState
=active
]]; then
2041 systemctl restart
$service
2045 setini
() { # set a value in a .ini style file
2046 key
="$1" value
="$2" section
="$3" file="$4"
2047 if [[ -s $file ]]; then
2048 sed -ri -f - "$file" <<EOF
2049 # remove existing keys
2050 / *\[$section\]/,/^ *\[[^]]+\]/{/^\s*$key[[:space:]=]/d}
2052 /^\s*\[$section\]/a $key=$value
2053 # from section to eof, do nothing
2054 /^\s*\[$section\]/,\$b
2055 # on the last line, if we haven't found section yet, add section and key
2067 sgo
() { # service go
2069 ser restart
$service ||
return 1
2070 if type -p systemctl
&>/dev
/null
; then
2076 # ignore services that dont exist
2077 if systemctl
cat $service &>/dev
/null
; then
2079 ser disable
$service
2085 systemctl list-unit-files | rg
"$@"
2092 # disable a warning with:
2093 # shellcheck disable=SC2206 # reasoning
2095 # see bash-template/style-guide.md for justifications
2098 quotes
=2048,2068,2086,2206
2099 others
=2029,2033,2054,2164
2100 shellcheck
-W 999 -x -e $quotes,$others "$@" ||
return $?
2104 # sl: ssh, but firsh rsync our bashrc and related files to a special
2105 # directory on the remote host if needed.
2107 # Some environment variables and files need to be setup for this to work
2108 # (mine are set at the beginning of this file)
2110 # SL_FILES_DIR: Environment variable. Path to folder which should at
2111 # least have a .bashrc file or symlink. This dir will be rsynced to ~ on
2112 # remote hosts (top level symlinks are resolved) unless the host already
2113 # has a $SL_FILES_DIR/.bashrc. In that case, we assume it is a host you
2114 # control and sync files to separately and already has the ~/.bashrc you
2115 # want. The remote bash will also take its .inputrc config from this
2116 # folder (default of not existing is fine). Mine looks like this:
2117 # https://iankelling.org/git/?p=distro-setup;a=tree;f=sl/.iank
2119 # SL_INFO_DIR: Environment variable. This folder stores info about what
2120 # we detected on the remote system and when we last synced. It will be created
2121 # if it does not exist. Sometimes you may want to forget about a
2122 # remote system, you can use sl --rsync, or the function for that slr
2125 # SL_TEST_CMD: Env var. Meant to be used to vary the files synced
2126 # depending on the remote host. Run this string on the remote host the
2127 # first time sl is run (or if we run slr). The result is passed to
2128 # SL_TEST_HOOK. For example,
2129 # export SL_TEST_CMD=". /etc/os-release ; echo \${VERSION//[^a-zA-Z0-9]/}"
2131 # SL_TEST_HOOK: Env var. It is run as $SL_TEST_HOOK. This can set
2132 # $SL_FILES_DIR to vary the files synced.
2134 # SL_RSYNC_ARGS: Env var. String of arguments passed to rsync. For
2135 # example to exclude files within a directory. Note, excluded
2136 # files wont be deleted on rsync, you can add --delete-excluded
2137 # to the rsync command if that is desired.
2139 # SL_SSH_ARGS: Env var. Default arguments passed to ssh.
2141 # For when ~/.bashrc is already customized on the remote server, you
2142 # might find it problematic that ~/.bashrc is sourced for ALL ssh
2143 # commands, even in scripts. This paragraph is all about that. bash
2144 # scripts dont source ~/.bashrc, but call ssh in scripts and you get
2145 # ~/.bashrc. You dont want this. .bashrc is meant for interactive shells
2146 # and if you customize it, probably has bugs from time to time. This is
2147 # bad. Here's how I fix it. I have a special condition to "return" in my
2148 # .bashrc for noninteractive ssh shells (copy that code). Then use this
2149 # function or similar that passes LC_USEBASHRC=t when sshing and I want
2150 # my bashrc. Also, I don't keep most of my bashrc in .bashrc, i source a
2151 # separate file because even if I return early on, the whole file gets
2152 # parsed which can fail if there is a syntax error.
2154 # Background on LC_USEBASHRC var (no need to read if you just want to
2155 # use this function): env variables sent across ssh are strictly
2156 # limited, but we get LC_* at least in debian based machines, so we
2157 # just make that * be something no normal program would use. Note, on
2158 # hosts that dont allow LC_* I start an inner shell with LC_USEBASHRC
2159 # set, and the inner shell also allows running a nondefault
2160 # .bashrc. This means the outer shell still ran the default .bashrc,
2161 # but that is the best we can do.
2163 local now args remote dorsync haveinfo tmpa sshinfo tmp tmp2
type info_sec force_rsync \
2164 sync_dirname testcmd extra_info testbool files_sec sl_test_cmd sl_test_hook
2165 declare -a args tmpa
2169 # ssh [-1246Antivivisectionist] [-b bind_address] [-c cipher_spec] [-D [bind_address:]port]
2170 # [-E log_file] [-e escape_char] [-F configfile] [-I pkcs11] [-i identity_file] [-L address]
2171 # [-l login_name] [-m mac_spec] [-O ctl_cmd] [-o option] [-p port] [-Q query_option]
2172 # [-R address] [-S ctl_path] [-W host:port] [-w local_tun[:remote_tun]] [user@]hostname
2175 # ssh [-46AaCfGgKkMNnqsTtVvXxYy] [-b bind_address] [-c cipher_spec]
2176 # [-D [bind_address:]port] [-E log_file] [-e escape_char]
2177 # [-F configfile] [-I pkcs11] [-i identity_file]
2178 # [-J [user@]host[:port]] [-L address] [-l login_name] [-m mac_spec]
2179 # [-O ctl_cmd] [-o option] [-p port] [-Q query_option] [-R address]
2180 # [-S ctl_path] [-W host:port] [-w local_tun[:remote_tun]]
2183 if [[ $1 == --rsync ]]; then
2188 sl_test_cmd
=$SL_TEST_CMD
2189 sl_test_hook
=$SL_TEST_HOOK
2190 sl_rsync_args
=$SL_RSYNC_ARGS
2217 # note we dont support things like -4oOption
2218 -[46AaCfGgKkMNnqsTtVvXxYy
]*)
2221 -[bcDEeFIiJLlmOopQRSWw
]*)
2222 # -oOption etc is valid
2223 if (( ${#1} >= 3 )); then
2226 args
+=("$1" "$2"); shift 2
2235 if [[ ! $remote ]]; then
2236 echo $0: error hostname required
>&2
2241 if [[ ! $SL_INFO_DIR ]]; then
2242 echo error
: missing
'$SL_INFO_DIR' env var
>&2
2248 tmpa
=($SL_INFO_DIR/???????????
"$remote")
2250 if [[ -e $sshinfo ]]; then
2251 if $force_rsync; then
2258 tmp
=${sshinfo[0]##*/}
2261 extra_info
=$
(cat $sshinfo)
2263 # we test for string to know ssh succeeded
2264 testbool
="test -e $SL_FILES_DIR/.bashrc -a -L .bashrc -a -v LC_USEBASHRC"
2265 testcmd
="if $testbool; then printf y; else printf n; fi"
2266 if ! tmp
=$
(LC_USEBASHRC
=y
command ssh "${args[@]}" "$remote" "$testcmd; $sl_test_cmd"); then
2267 echo failed sl
test. doing plain
ssh -v
2268 command ssh -v "${args[@]}" "$remote"
2270 if [[ $tmp == y
* ]]; then
2276 extra_info
="${tmp:1}"
2278 if [[ $sl_test_hook ]]; then
2279 RSYNC_RSH
="ssh ${args[*]}" $sl_test_hook "$extra_info" "$remote"
2282 if $haveinfo && [[ $type == b
]]; then
2284 read files_sec _
< <(find -L $SL_FILES_DIR -printf "%T@ %p\n" |
sort -nr ||
[[ $?
== 141 ||
${PIPESTATUS[0]} == 32 ]] )
2285 files_sec
=${files_sec%%.*}
2286 if (( files_sec
> info_sec
)); then
2292 sync_dirname
=${SL_FILES_DIR##*/}
2294 if [[ ! $SL_FILES_DIR ]]; then
2295 echo error
: missing
'$SL_FILES_DIR' env var
>&2
2300 RSYNC_RSH
="ssh ${args[*]}" m rsync
-rptL --delete $sl_rsync_args $SL_FILES_DIR "$remote":
2302 if $dorsync ||
! $haveinfo; then
2303 sshinfo
=$SL_INFO_DIR/$EPOCHSECONDS$type"$remote"
2304 [[ -e $SL_INFO_DIR ]] || mkdir
-p $SL_INFO_DIR
2305 printf "%s\n" "$extra_info" >$sshinfo
2308 if [[ $type == b
]]; then
2309 if (( ${#@} )); then
2310 # Theres a couple ways to pass arguments, im not sure whats best,
2311 # but relying on bash 4.4+ escape quoting seems most reliable.
2312 command ssh "${args[@]}" "$remote" \
2313 LC_USEBASHRC
=t bash
-c '.\ '$sync_dirname'/.bashrc\;"\"\$@\""' bash
${@@Q}
2314 elif [[ ! -t 0 ]]; then
2315 # This case is when commands are being piped to ssh.
2316 # Normally, no bashrc gets sourced.
2317 # But, since we are doing all this, lets source it because we can.
2318 cat <(echo .
$sync_dirname/.bashrc
) - |
command ssh "${args[@]}" "$remote" LC_USEBASHRC
=t bash
2320 command ssh -t "${args[@]}" "$remote" LC_USEBASHRC
=t INPUTRC
=$sync_dirname/.inputrc bash
--rcfile $sync_dirname/.bashrc
2324 LC_USEBASHRC
=t
command ssh "${args[@]}" "$remote" ${@@Q}
2326 command ssh "${args[@]}" "$remote" LC_USEBASHRC
=t bash
2329 # this function inspired from https://github.com/Russell91/sshrc
2336 sl
-oControlMaster=no
-oControlPath=/ "$@"
2338 # kill off old shared socket then ssh
2340 m
ssh -O exit "$@" ||
[[ $?
== 255 ]]
2343 ccomp
ssh sl slr sss ssk
2346 if [[ $TERM == alacritty ||
$TERM == xterm-kitty
]]; then
2347 TERM
=xterm-256color LC_USEBASHRC
=t
command ssh "$@"
2349 LC_USEBASHRC
=t
command ssh "$@"
2355 # log with script. timing is $1.t and script is $1.s
2356 # -l to save to ~/typescripts/
2357 # -t to add a timestamp to the filenames
2358 local logdir do_stamp arg_base
2359 (( $# >= 1 )) ||
{ echo "arguments wrong"; return 1; }
2362 while getopts "lt" option
2365 l
) arg_base
=$logdir ;;
2366 t
) do_stamp
=true
;;
2369 shift $
((OPTIND
- 1))
2371 [[ -e $logdir ]] || mkdir
-p $logdir
2372 $do_stamp && arg_base
+=$
(date +%F.
%T
%z
)
2373 script -t $arg_base.s
2> $arg_base.t
2375 splay
() { # script replay
2376 #logRoot="$HOME/typescripts/"
2377 #scriptreplay "$logRoot$1.t" "$logRoot$1.s"
2378 scriptreplay
"$1.t" "$1.s"
2382 # sudo redo. be aware, this command may not work right on strange distros or earlier software
2383 if [[ $# == 0 ]]; then
2384 sudo
-E bash
-c -l "$(history -p '!!')"
2386 echo this
command redos last
history item. no argument is accepted
2391 # with -ll, less secure but faster.
2392 command srm
-ll "$@"
2397 ssh $1 /tmp
/${2##*/} $
(printf "%q\n" "${@:2}")
2409 tclock
() { # terminal clock
2414 # this goes to full width
2415 #len=${1:-$((COLUMNS -7))}
2418 if (( x
== len
)); then
2420 d
="$(date +%l:%_M) "
2423 d
=$
(date +%l
:%M
:%_S
)
2427 for ((i
=0; i
<x
; i
++)); do
2428 if (( i
% 6 )); then
2446 # test existence / exists
2449 [[ -e "$x" ||
-L "$x" ]] || ret
=1
2455 # normally, i would just execute these commands in the function.
2456 # however, DEBUG is not inherited, so we need to run it outside a function.
2457 # And we want to run set -x afterwards to avoid spam, so we cram everything
2458 # in here, and then it will run after this function is done.
2459 PROMPT_COMMAND
='trap DEBUG; unset PROMPT_COMMAND; PS1="\w \$ "'
2462 PROMPT_COMMAND
=prompt-command
2463 if [[ $TERM == *(screen
*|xterm
*|rxvt
*) ]]; then
2464 trap 'settitle "$BASH_COMMAND"' DEBUG
2468 # prometheus node curl
2471 host=${1:-127.0.0.1}
2472 s curl
--cert-type PEM
--cert /etc
/prometheus
/ssl
/prometheus_cert.pem
--key /etc
/prometheus
/ssl
/prometheus_key.pem
--cacert /etc
/prometheus
/ssl
/prom_node_cert.pem
--resolve prom_node
:9100:$host -v https
://prom_node
:9100/metrics
2475 tx
() { # toggle set -x, and the prompt so it doesnt spam
2476 if [[ $
- == *x
* ]]; then
2485 # show all processes in the network namespace $1.
2486 # blank entries appear to be subprocesses/threads
2490 sudo
find -L /proc
/[1-9]*/task
/*/ns
/net
-samefile /run
/netns
/$netns | cut
-d/ -f5 | \
2492 x
=$
(ps
-w --no-headers -p $l);
2493 if [[ $x ]]; then echo "$x"; else echo $l; fi;
2497 if ! s ip netns list |
grep -Fx nonet
&>/dev
/null
; then
2498 s ip netns add nonet
2500 sudo
-E env
/sbin
/ip netns
exec nonet sudo
-E -u iank
/bin
/bash
2503 m
() { printf "%s\n" "$*"; "$@"; }
2505 # update file. note: duplicated in mail-setup
2507 local tmp tmpdir dest
="$1"
2508 local base
="${dest##*/}"
2509 local dir
="${dest%/*}"
2510 if [[ $dir != "$base" ]]; then
2511 # dest has a directory component
2516 cat >$tmpdir/"$base"
2517 tmp
=$
(rsync
-ic $tmpdir/"$base" "$dest")
2519 printf "%s\n" "$tmp"
2521 if [[ $dest == /etc
/systemd
/system
/* ]]; then
2530 if type -p uprecords
&>/dev
/null
; then
2538 for x
in "$@"; do virsh destroy
"$x"; virsh undefine
"$x"; done
2546 sudo virsh dumpxml
$vm |
sed -r "s/(<listen.*address=')([^']+)/\1$ip/" | \
2547 sed -r "s/listen='[^']+/listen='$ip/"> $t
2548 sudo virsh undefine
$vm
2549 sudo virsh define
$t
2554 vm-set-listen
$1 0.0.0.0
2559 vm-set-listen
$1 127.0.0.1
2563 # find input, copy to pattern space, when we find the first field, print the copy in different order without newlines.
2564 # instead of using labels, we could just match a line and group, eg: /signal:/,{s/signal:(.*)/\1/h}
2565 sudo iw dev wls1 scan |
sed -rn "
2566 s/^\Wcapability: (.*)/\1/;Ta;h;b
2567 :a;s/^\Wsignal: -([^.]+).*/\1/;Tb;H;b
2568 # padded to min width of 20
2569 :b;s/\WSSID: (.*)/\1 /;T;s/^(.{20}(.*[^ ])?) */\1/;H;g;s/(.*)\n(.*)\n(.*)/\2 \3 \1/gp;b
2573 # Run script by copying it to a temporary location first,
2574 # and changing directory, so we don't have any open
2575 # directories or files that could cause problems when
2592 # spark 1 5 22 13 53
2596 # Copyright (c) Zach Holman, https://zachholman.com
2597 # https://github.com/holman/spark
2599 # As of 2022-10-28, I reviewed github forks that had several newer
2600 # commits, none had anything interesting. I did a little refactoring
2601 # mostly to fix emacs indent bug.
2603 # Generates sparklines.
2606 if [ "X$1" = "X-n" ]; then
2620 # find min/max values
2621 local min
=0xffffffff max
=0
2625 # on Linux (or with bash4) we could use `printf %.0f $n` here to
2626 # round the number but that doesn't work on OS X (bash3) nor does
2627 # `awk '{printf "%.0f",$1}' <<< $n` work, so just cut it off
2629 (( n
< min
)) && min
=$n
2630 (( n
> max
)) && max
=$n
2631 numbers
=$numbers${numbers:+ }$n
2635 local ticks
=(▁ ▂ ▃ ▄ ▅ ▆ ▇ █
)
2637 # use a high tick if data is constant
2638 (( min
== max
)) && ticks
=(▅ ▆
)
2641 f
=$
(( ( (max-min
) <<8)/( tc - 1) ))
2646 _spark_echo -n ${ticks[$(( ((($n-$min)<<8)/$f) ))]}
2651 pdfwc() { local f; for f; do echo "$f" $(pdfinfo "$f" | awk '/^Pages:/ {print $2}'); done }
2656 if $use_color && type -p tput &>/dev/null; then
2657 term_bold="$(tput bold)"
2658 term_red="$(tput setaf 1)"
2659 term_green="$(tput setaf 2)"
2660 term_yellow="$(tput setaf 3)"
2661 term_purple="$(tput setaf 5)"
2662 term_nocolor="$(tput sgr0)" # no font attributes
2664 # unused so far. commented for shellcheck
2665 # term_underl="$(tput smul)"
2666 # term_blue="$(tput setaf 4)"
2667 # term_cyan="$(tput setaf 6)"
2669 # Try to keep environment pollution down, EPA loves us.
2670 unset safe_term match_lhs use_color
2675 if [[ $- == *i* ]]; then
2680 if [[ $EUID == 1000 ]]; then
2687 # this needs to come before next ps1 stuff
2688 # this stuff needs bash 4, feb 2009,
2689 # old enough to no longer condition on $BASH_VERSION anymore
2693 if [[ $- == *i* ]] && [[ ! $LC_INSIDE_EMACS ]]; then
2695 bind -m vi-command B:shell-backward-word
2696 bind -m vi-command W:shell-forward-word
2699 if [[ $SSH_CLIENT || $SUDO_USER ]]; then
2700 unset PROMPT_DIRTRIM
2704 # emacs terminal has problems if this runs slowly,
2705 # so I've thrown a bunch of things at the wall to speed it up.
2707 local return=$? # this MUST COME FIRST
2708 local ps_char ps_color
2711 if [[ $HISTFILE ]]; then
2712 history -a # save history
2716 0) ps_color="$term_purple"
2719 *) ps_color="$term_green"
2720 ps_char="$return \\$"
2723 if [[ ! -O . ]]; then # not owner
2724 if [[ -w . ]]; then # writable
2725 ps_color="$term_bold$term_red"
2727 ps_color="$term_bold$term_green"
2731 # faster than sourceing the file im guessing
2732 if [[ -e /dev/shm/iank-status && ! -e /tmp/quiet-status ]]; then
2733 eval $(< /dev/shm/iank-status)
2735 if [[ $MAIL_HOST && $MAIL_HOST != "$HOSTNAME" ]]; then
2736 ps_char="@ $ps_char"
2739 if [[ $(jobs -p) ]]; then
2742 # We could test if sudo is active with sudo -nv
2743 # but then we get an email and log of lots of failed sudo commands.
2744 # We could turn those off, but seems better not to.
2745 if [[ $EUID != 0 ]] && [[ $DID_SUDO ]]; then
2746 psudo="\[$term_bold$term_red\]s\[$term_nocolor\] "
2748 if [[ ! $HISTFILE ]]; then
2749 ps_char="NOHIST $ps_char"
2751 PS1="${PS1%"${PS1#*[wW]}"} $jobs_char$psudo\[$ps_color\]$ps_char\[$term_nocolor\] "
2753 # set titlebar. instead, using more advanced
2755 #echo -ne "$_title_escape $HOSTNAME ${PWD/#$HOME/~} \007"
2757 PROMPT_COMMAND=prompt-command
2759 if [[ $TERM == screen* ]]; then
2760 _title_escape="\033]..2;"
2762 # somme sites recommend this, i dunno what the diff is.
2763 #_title_escape="\033]30;"
2764 _title_escape="\033]0;"
2767 # make the titlebar be the last command and the current directory.
2771 # These are some checks to help ensure we dont set the title at
2772 # times that the debug trap is running other than the case we
2773 # want. Some of them might not be needed.
2774 if (( ${#FUNCNAME[@]} != 1 || ${#BASH_ARGC[@]} != 2 || $BASH_SUBSHELL != 0 )); then
2777 if [[ $1 == prompt-command ]]; then
2780 echo -ne "$_title_escape ${PWD/#$HOME/~} "
2785 # note, this wont work:
2786 # x=$(mktemp); cp a $x
2787 # I havnt figured out why, bigger fish to fry.
2790 # condition from the screen man page i think.
2791 # note: duplicated in tx()
2792 if [[ $TERM == *(screen*|xterm*|rxvt*) ]]; then
2793 trap 'settitle "$BASH_COMMAND"' DEBUG
2800 # * stuff that makes sense to be at the end
2806 # shellcheck disable=SC1090
2807 [[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm" # Load RVM into a shell session *as a function*
2809 # I had this idea to start a bash shell which would run an initial
2810 # command passed through this env variable, then continue on
2811 # interactively. But the use case I had in mind went away.
2813 # if [[ $MY_INIT_CMD ]]; then
2814 # "${MY_INIT_CMD[@]}"
2818 # ensure no bad programs appending to this file will have an affect