collection of shell utilities, written in bash.

(once they become large or more useful, they will probably get moved to their own repositories)

exes is for doing things like:

$ cd ~/bin
$ for script in `pyscripts`; do head -1 $script; done | sort | uniq -c
     1 #!/usr/bin/env python
     1 #!/usr/bin/env python2
    13 #!/usr/bin/env python3

• if args given, uses those directories instead of current directory
• if args given are files, will end up "filtering"

• accommodates filenames with newlines, but delimits output with them
• probably directories with newlines given as arguments would break
• inefficient if file list given, calls 'find' on each one of them
• bash behavior for readarray with null delimiter might change
  • '-t' not needed for nulls, needed for newlines; inconsistent

select and display particular processes.

proc is a suite of convenience wrapper functions for ps utilities, selecting processes with the requested attributes. It will output using a standard format, without a header line, so the fields must be memorized.

-p can be given to some commands to display only the pids rather than the ps output fields.

invocations:

convenience date wrappers, implemented in datewrap.sh:

now
today
tomorrow
yesterday
thisweek
lastweek
nextweek
thismonth
lastmonth
thisyear

Switches tmux client's focused tty to the one with number or pid.

1. switch the focused window to the right tty with xttypid or xttytty from https://github.com/smemsh/utilx/
2. if you end up in a tmux window, but it's not the right one, use tmuxtty with the tty of some process you're trying to find that has the given controlling tty, or tmuxpid if you know the pid.

Either of these will require appropriate privileges to do everything. In most cases that's just your user but sometimes switching to privileged windows doesn't work without sudo.

• default srcdir ~/src
• default attribute srcdirs.ispublic
• does not handle spaces in repo paths (and newline is OFS)
• works only with non-bare repositories

Shell wrappers for listing files and directories (in lsa.sh). For details of the flags used, it's better to look inside the script.

send signals to groups of processes. implemented in pause.sh

command line encode/decode of urls to clean http refs. implemented in urlcode.sh. Requires php be installed for rawurlencode() and rawurldecode(). Todo: python.

vimcmd: execute given vim commands with its --cmd after redirecting output to stdout, and after which vim will quit.

vimver: use vimcmd to print vim's v:versionlong as a line to stdout.

display file creation dates

show mountpoint and free megabytes of files/dirs from $@

• compares all functions that exist in both source files $1 and $2
• any remaining args restrict comparison to only those function names
• system must support "ctags -x" (ie exuberant, universal)
• outputs universal diff hunks for each differing function, or nothing
• function signature line (the ctags referent line) is not compared
• functions must end on a line with trailing brace in column 0
• only tested with C files

break input into columns by width of its longest word, fill to $COLUMNS

get the cwd of the given pids

initialize environment, fork/exec, setsid/disown, stdout/err to syslog

• performs all the steps daemons do in C programs, but for shell scripts
• use logger to redirect stdout and stderr to syslog using given prefix
• starts daemon with clean environment (only "standard" base env retained)

args:

• arg1: quoted string, will be unquoted to make argv for invoked program
• arg2: prefix to use (less colons) in syslog messages
• (if one arg supplied, log prefix will be invocation name)

find latest regular file in dirtree by mtime, print parsable mtime stdout

todo:

• allow other kinds of times to be tested
• make sure this will handle filenames with newlines
• flags to print the name, the date, or both
• handle other kinds of inodes besides regular files

find files in temporal proximity.

outputs matching files that:

1. are located somewhere within user-specified tree, and
2. have mtimes within specified range of reference file

args:

• arg1: allowed +/- mtime variance
• arg2: mtime reference file
• arg3: match files only in tree rooted here
• argN: [treeN] ...
• if only one arg, use $default_variance and file's parent

todo:

• allow ctime in addition to mtime
• handle case of filenames starting with '-'

todo: look in other places, allow user to specify, getopt

gets a yes or no from the user:

exits success for yes, failure for no

checks if google has indexed the given page

start program as user with green environment (clean but sane)

usage:

• must be invoked as root (use sudo)
• arg1: user to run as
• argN: argument vector for program

desc:

• wraps program invocation as different user via sudo -u
• only basic/minimal sanitized version of environment passed in
• does not involve session layer, pam, etc
• impetus for this program was originally a "gem install" user+wrapper
• beyond that, useful to replace: su -lc "env - ENV=ENV1 ... args" user

note:

• redhat 'runuser' would work, but see debian bug 8700
• waiting for upstream util-linux release
• update: may be deprecated; runuser now is in jessie
• update: debian runuser starts login shell, uses pam?!?! (todo: verify)
• update: sudo uses pam anyways!

todo:

• integrate with ~/.bash/{init,env}
• does not handle spaces in any of the exports
• embeds call to sudo -- NOT GOOD, was whole point of runuser

sets up some LESS term overrides so display is better, and then executes /usr/bin/man

converts markdown file to roff macros, typesets for term and pages

• input file can be optionally compressed (.gz)
• input file can be optionally without .md or .md.gz extension

deps: pandoc

creds: snarfed pandoc invocation: Keith Thompson http://stackoverflow.com/questions/7599447/

todo:

• refactor this, at least 2 factors to reduce on
• does not handle spaces
• barfs if one of the filename variants does not exist

dump contents of heap memory and filter through strings. reads /proc/pid/maps to determine heap mapping, and reads only that.

recursively makes dirs group-owned, setgid, and copies user mode to group

args:

• system group to chgrp given as $1
• all remaining args: trees to be recursively converted

by either stdin or the given files, remove their comments and emit on stdout. knows only very simple comments like hashmarks.

rename.ul replacement with different/better options:

rename [options | <from-string> <to-string>] <file> ...

-p/--prepend <string to add to beginning>
-a/--append <string to add to end>
-P/--unprepend <string to remove from beginning>
-A/--unappend <string to remove from end>

Debian removed rename.ul from its util-linux installation, so we have to write our own. While we're at it, we add a couple options to make it easier to to prepend or append something without needing empty string argument (which only works to append), although we still take one to allow the interface to be used the same way

see also https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=982944

display thesaurus entries using dict -d moby-thesaurus

apt, dpkg convenience wrapper

todo:

• verify names in "also"
• does not handle spaces in package names or other input, as usual

wraps coreutils 'truncate', making all args zero bytes

args: any options and files to give to 'truncate'