aboutsummaryrefslogtreecommitdiff
path: root/man/man1/9.1
blob: 24ce0226ee00db6f0d6029157f296a49651d4a97 (plain)
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
62
.TH 9 1
.SH NAME
9 \- run Plan 9 commands
.SH SYNOPSIS
.B 9
.I cmd
[
.I args
\&...
]
.PP
.B .
.B 9
.SH DESCRIPTION
Because Plan 9 supplies commands with the same name as but different
behavior than many basic Unix system commands
(e.g.,
.BR grep ,
.BR sed ,
.BR mkdir ,
.BR rm ),
it is not recommended to run with the Plan 9 bin directory
ahead of the system directories.
.PP
.I 9
is a shell script that sets up a Plan 9 environment and runs
.I cmd .
It sets
.B $PLAN9
and adds
.B $PLAN9/bin
to the beginning of
.B $PATH
before running
.IR cmd .
.PP
If run with no arguments,
.B 9
does not do anything.  This is so that it can be invoked from
.IR sh -style
shells using
.B .
.B 9
in order to make the current shell start running in the Plan 9 environment.
.SH EXAMPLES
Search for greek in the password file:
.IP
.EX
$ 9 grep '[α-ζ]' /etc/passwd
.EE
.PP
Start an
.IR rc (1)
with the Plan 9 commands in the path before the system commands.
.IP
.EX
9 rc
.EE
.SH SOURCE
.B \*9/bin/9
.SH SEE ALSO
.IR intro (1)