From d8d46880be6ed10c16382d8d2f9ed6de34c1df14 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 2 Dec 2015 05:07:05 +0100 Subject: add man page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/man/exec-as.1 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 doc/man/exec-as.1 (limited to 'doc/man/exec-as.1') diff --git a/doc/man/exec-as.1 b/doc/man/exec-as.1 new file mode 100644 index 0000000..27c4481 --- /dev/null +++ b/doc/man/exec-as.1 @@ -0,0 +1,61 @@ +.TH EXEC-AS 1 EXEC-AS +.SH NAME +exec-as - passphrase strength evaluator +.SH SYNOPSIS +.B exec-as +.I FILE +.I ARGV0 +.RI [ ARGV ]... +.SH DESCRIPTION +.B exec-as +shall spawn the program +.IR FILE , +using +.BR execvp (3), +using +.I ARGV0 +as the value for +.BR argv[0] , +and the following arguments for the following values in +.BR argv . +.SH NOTES +At least two arguments is required. Since this is not +a builtin function, it cannot be used as +.BR exec (1) +without arguments to set file descriptors. +.PP +Because this is not a builtin function, running this +program would normally do an fork–exec rather than +just an exec. To just perform an exec, you need to +use +.BR exec (1) +too: +.B exec exec-as +.SH EXAMPLES +.B exec-as bash -bash +will run the first program in +.B $PATH +named +.BR bash , +and set +.B argv[0] +to +.B \-bash +(making it a login shell.) You can add addition argument as needed. +.SH "SEE ALSO" +.BR exec (1), +.BR exec (3) +.SH AUTHORS +Principal author, Mattias Andrée. See the COPYING file for the full +list of authors. +.SH LICENSE +Copyright \(co 2015 Mattias Andrée +.br +License GPLv3+: GNU GPL version 3 or later . +.br +This is free software: you are free to change and redistribute it. +.br +There is NO WARRANTY, to the extent permitted by law. +.SH BUGS +Please report bugs to https://github.com/maandree/exec-as/issues or to +maandree@member.fsf.org -- cgit v1.2.3-70-g09d2