From a5f9ff62b2d70a5b75efe8e4f993aec10f209095 Mon Sep 17 00:00:00 2001
From: rsc <devnull@localhost>
Date: Sun, 23 Jan 2005 22:41:44 +0000
Subject: document searchpath(3)

---
 man/man3/searchpath.3 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 man/man3/searchpath.3

(limited to 'man/man3')

diff --git a/man/man3/searchpath.3 b/man/man3/searchpath.3
new file mode 100644
index 00000000..e0709b2e
--- /dev/null
+++ b/man/man3/searchpath.3
@@ -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
-- 
cgit v1.2.3