sbase/which.1

.Dd April 27, 2015
.Dt WHICH 1
.Os sbase
.Sh NAME
.Nm which
.Nd locate programs in the path
.Sh SYNOPSIS
.Nm
.Op Fl a
.Ar name ...
.Sh DESCRIPTION
.Nm
looks for each
.Ar name
in the
.Ev PATH
directories, stopping at the first match and printing
the full path to stdout.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a
Don't stop at the first match and search all
.Ev PATH
directories.
.El
.Sh EXIT STATUS
.Bl -tag -width Ds
.It 0
Each
.Ar name
was found.
.It 1
At least one
.Ar name
was not found.
.It 2
No
.Ar name
was found.
.It 3
An error occurred.
.El
.Sh SEE ALSO
.Xr environ 7
add which 2015-04-27 10:24:43 -04:00			`.Dd April 27, 2015`
			`.Dt WHICH 1`
			`.Os sbase`
			`.Sh NAME`
			`.Nm which`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`.Nd locate programs in the path`
add which 2015-04-27 10:24:43 -04:00			`.Sh SYNOPSIS`
			`.Nm`
			`.Op Fl a`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`.Ar name ...`
add which 2015-04-27 10:24:43 -04:00			`.Sh DESCRIPTION`
			`.Nm`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`looks for each`
			`.Ar name`
			`in the`
add which 2015-04-27 10:24:43 -04:00			`.Ev PATH`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`directories, stopping at the first match and printing`
			`the full path to stdout.`
			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
			`.It Fl a`
			`Don't stop at the first match and search all`
			`.Ev PATH`
			`directories.`
			`.El`
add which 2015-04-27 10:24:43 -04:00			`.Sh EXIT STATUS`
			`.Bl -tag -width Ds`
			`.It 0`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`Each`
			`.Ar name`
			`was found.`
add which 2015-04-27 10:24:43 -04:00			`.It 1`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`At least one`
			`.Ar name`
			`was not found.`
add which 2015-04-27 10:24:43 -04:00			`.It 2`
Refactor and audit which(1) Use the *at functions instead of building paths manually. We do still have path-building in recurse() and other areas, but the long-term goal is to rid most interfaces of that for practical and security reasons. In this case, it's more or less trivial. Also, refactor the manpage to be more consistent with the others. BUGFIX: Return exit status 3 on error. 2015-04-27 14:01:30 -04:00			`No`
			`.Ar name`
			`was found.`
			`.It 3`
			`An error occurred.`
add which 2015-04-27 10:24:43 -04:00			`.El`
			`.Sh SEE ALSO`
			`.Xr environ 7`