tdocument searchpath(3) - plan9port - [fork] Plan 9 from user space (HTM) git clone git://src.adamsgaard.dk/plan9port (DIR) Log (DIR) Files (DIR) Refs (DIR) README (DIR) LICENSE --- (DIR) commit a5f9ff62b2d70a5b75efe8e4f993aec10f209095 (DIR) parent 4a6237114063e9cc3d7a3b544f9477d93738c1a0 (HTM) Author: rsc <devnull@localhost> Date: Sun, 23 Jan 2005 22:41:44 +0000 document searchpath(3) Diffstat: A man/man3/searchpath.3 | 61 +++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+), 0 deletions(-) --- (DIR) diff --git a/man/man3/searchpath.3 b/man/man3/searchpath.3 t@@ -0,0 +1,61 @@ +.TH SEARCHPATH 3 +.SH NAME +search \- search for named executable +.SH SYNOPSIS +.B #include <u.h> +.br +.B #include <libc.h> +.PP +.B +char* searchpath(char *name) +.SH DESCRIPTION +.I Searchpath +searches for the executable +.I name +in the same way that +.IR sh (1) +and +.IR rc (1) +do. +.PP +The environment variable +.B $PATH +is treated as a colon-separated list of directories in which to look for +.IR name . +An empty string in the list is treated as the current directory. +If an executable named +.I name +is found in one of the directories, +.I searchpath +returns a pointer to a malloced string containing a path +.IB \fR( dir / name \fR, +or simply +.IR name ) +suitable for use in +.IR open (3) +or +.IR exec (3). +.PP +If +.I name +begins with +.B ./ , +.B ../ , +or +.B / , +then the search path is ignored. +If +.I name +exists and is an executable, then +.I searchpath +returns a malloced string containing name. +.PP +The returned buffer should be freed when no longer needed. +If +.I name +is not found, +.I searchpath +returns nil. +.PP +.SH SOURCE +.B \*9/src/lib9/searchpath.c