aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/exec-as.1
blob: f66bb9d2157d734e849e8e9185c3b2ee12744f08 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
.TH EXEC-AS 1 EXEC-AS
.SH NAME
exec-as - passphrase strength evaluator
.SH SYNOPSIS
.B exec-as
.I FILE
.RI [ 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 one argument 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 <http://gnu.org/licenses/gpl.html>.
.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