From ccd85577c45519fd00a3ccc5bd40a111a9b3e12a Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 2 Dec 2015 04:57:15 +0100 Subject: improve readme MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 31 ++++++++++++++++++++++++------- 1 file changed, 24 insertions(+), 7 deletions(-) diff --git a/README b/README index 692ac67..a1fce3f 100644 --- a/README +++ b/README @@ -1,12 +1,29 @@ -A command that lets you start another command with any argv[0]. +NAME + exec-as - exec(1) with explicit argv[0] +SYNOPSIS + exec-as FILE ARGV0 [ARGV]... -`exec-as bash -bash` will run the first program in $PATH -named bash, and set argv[0] to -bash (making it a login -shell.) You can add addition argument as needed. +DESCRIPTION + exec-as shall spawn the program FILE, using execvp(3), + using ARGV0 as the value for argv[0], and the following + arguments for the following values in argv. +NOTES + At least two arguments is required. Since this is not + a builtin function, it cannot be used as exec(1) without + arguments to set file descriptors. -Note that to actually exec rather than then fork–exec:ing -you need to type `exec exec-as` instead of `exec-as`, as -the shell would otherwise fork first. + 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 exec(1) too: exec exec-as + +EXAMPLES + 'exec-as bash -bash' will run the first program in + $PATH named bash, and set argv[0] to -bash (making it + a login shell.) You can add addition argument as needed. + +SEE ALSO + exec(1), exec(3) -- cgit v1.2.3-70-g09d2