with-umask: New tool. DWISOTT.

[misc] / with-umask.1

diff --git a/with-umask.1 b/with-umask.1
new file mode 100644 (file)
index 0000000..c264331
--- /dev/null
+++ b/with-umask.1
@@ -0,0 +1,52 @@
+.de VS
+.sp 1
+.RS
+.nf
+.ft B
+..
+.de VE
+.ft R
+.fi
+.RE
+.sp 1
+..
+.TH with-umask 1 "5 April 2015" "Edgeware tools"
+.SH NAME
+with-umask \- run a command with a particular umask set
+.SH SYNOPSIS
+.B with-umask
+.I mode
+.I command
+.RI [ arguments ...]
+.SH DESCRIPTION
+The
+.B with-umask
+program sets its umask to
+.I mode
+and then executes
+.I command
+with the given
+.IR arguments .
+.PP
+The
+.I mode
+may be either a literal mask written in octal, where set bits correspond
+to mode bits to be forced clear when creating files, or a symbolic mode
+in
+.BR chmod (1)
+style listing the mode bits to be preserved.  (Other forms may be
+acceptable:
+.B with-umask
+is currently a shell script, and uses
+.BR /bin/sh 's
+.B umask
+built-in to do its work.)
+.PP
+Command line options:
+.TP
+.B "\-h"
+Show very brief help, and exit.
+.SH BUGS
+None known.
+.SH AUTHOR
+Mark Wooding <mdw@distorted.org.uk>