1 3940506b 2005-01-13 devnull .TH 9 1
  2 3940506b 2005-01-13 devnull .SH NAME
  3 9f827afd 2005-03-06 devnull 9, 9.rc, u, u.rc \- run Plan 9 or Unix commands
  4 3940506b 2005-01-13 devnull .SH SYNOPSIS
  5 3940506b 2005-01-13 devnull .B 9
  6 3940506b 2005-01-13 devnull .I cmd
  7 3940506b 2005-01-13 devnull [
  8 3940506b 2005-01-13 devnull .I args
  9 3940506b 2005-01-13 devnull \&...
 10 3940506b 2005-01-13 devnull ]
 11 93aa30a8 2005-01-14 devnull .PP
 12 93aa30a8 2005-01-14 devnull .B .
 13 93aa30a8 2005-01-14 devnull .B 9
 14 67075c36 2005-01-14 devnull (from
 15 d32deab1 2020-08-16 rsc .MR sh (1) )
 16 67075c36 2005-01-14 devnull .PP
 17 67075c36 2005-01-14 devnull .B 9.rc
 18 67075c36 2005-01-14 devnull .I cmd
 19 67075c36 2005-01-14 devnull [
 20 67075c36 2005-01-14 devnull .I args
 21 67075c36 2005-01-14 devnull \&...
 22 67075c36 2005-01-14 devnull ]
 23 67075c36 2005-01-14 devnull .PP
 24 67075c36 2005-01-14 devnull .B .
 25 67075c36 2005-01-14 devnull .B 9.rc
 26 67075c36 2005-01-14 devnull (from
 27 d32deab1 2020-08-16 rsc .MR rc (1) )
 28 9f827afd 2005-03-06 devnull .PP
 29 9f827afd 2005-03-06 devnull .B u
 30 9f827afd 2005-03-06 devnull .I cmd
 31 9f827afd 2005-03-06 devnull [
 32 9f827afd 2005-03-06 devnull .I args
 33 9f827afd 2005-03-06 devnull \&...
 34 9f827afd 2005-03-06 devnull ]
 35 9f827afd 2005-03-06 devnull .PP
 36 9f827afd 2005-03-06 devnull .B .
 37 9f827afd 2005-03-06 devnull .B u
 38 9f827afd 2005-03-06 devnull (from
 39 d32deab1 2020-08-16 rsc .MR sh (1) )
 40 9f827afd 2005-03-06 devnull .PP
 41 9f827afd 2005-03-06 devnull .B u.rc
 42 9f827afd 2005-03-06 devnull .I cmd
 43 9f827afd 2005-03-06 devnull [
 44 9f827afd 2005-03-06 devnull .I args
 45 9f827afd 2005-03-06 devnull \&...
 46 9f827afd 2005-03-06 devnull ]
 47 9f827afd 2005-03-06 devnull .PP
 48 9f827afd 2005-03-06 devnull .B .
 49 9f827afd 2005-03-06 devnull .B u.rc
 50 9f827afd 2005-03-06 devnull (from
 51 d32deab1 2020-08-16 rsc .MR rc (1) )
 52 3940506b 2005-01-13 devnull .SH DESCRIPTION
 53 93aa30a8 2005-01-14 devnull Because Plan 9 supplies commands with the same name as but different
 54 93aa30a8 2005-01-14 devnull behavior than many basic Unix system commands
 55 93aa30a8 2005-01-14 devnull (e.g.,
 56 93aa30a8 2005-01-14 devnull .BR grep ,
 57 93aa30a8 2005-01-14 devnull .BR sed ,
 58 93aa30a8 2005-01-14 devnull .BR mkdir ,
 59 93aa30a8 2005-01-14 devnull .BR rm ),
 60 93aa30a8 2005-01-14 devnull it is not recommended to run with the Plan 9 bin directory
 61 93aa30a8 2005-01-14 devnull ahead of the system directories.
 62 93aa30a8 2005-01-14 devnull .PP
 63 93aa30a8 2005-01-14 devnull .I 9
 64 93aa30a8 2005-01-14 devnull is a shell script that sets up a Plan 9 environment and runs
 65 93aa30a8 2005-01-14 devnull .I cmd .
 66 93aa30a8 2005-01-14 devnull It sets
 67 93aa30a8 2005-01-14 devnull .B $PLAN9
 68 3a9ee635 2005-01-14 devnull if necessary
 69 93aa30a8 2005-01-14 devnull and adds
 70 93aa30a8 2005-01-14 devnull .B $PLAN9/bin
 71 93aa30a8 2005-01-14 devnull to the beginning of
 72 93aa30a8 2005-01-14 devnull .B $PATH
 73 93aa30a8 2005-01-14 devnull before running
 74 93aa30a8 2005-01-14 devnull .IR cmd .
 75 93aa30a8 2005-01-14 devnull .PP
 76 93aa30a8 2005-01-14 devnull If run with no arguments,
 77 93aa30a8 2005-01-14 devnull .B 9
 78 3a9ee635 2005-01-14 devnull does not do anything, so it can be invoked from
 79 93aa30a8 2005-01-14 devnull .IR sh -style
 80 93aa30a8 2005-01-14 devnull shells using
 81 93aa30a8 2005-01-14 devnull .B .
 82 93aa30a8 2005-01-14 devnull .B 9
 83 93aa30a8 2005-01-14 devnull in order to make the current shell start running in the Plan 9 environment.
 84 67075c36 2005-01-14 devnull .PP
 85 67075c36 2005-01-14 devnull .I 9.rc
 86 67075c36 2005-01-14 devnull is the same as
 87 67075c36 2005-01-14 devnull .I 9
 88 3a9ee635 2005-01-14 devnull but written for use by the shell
 89 d32deab1 2020-08-16 rsc .MR rc (1) .
 90 9f827afd 2005-03-06 devnull .PP
 91 9f827afd 2005-03-06 devnull .I U
 92 9f827afd 2005-03-06 devnull and
 93 9f827afd 2005-03-06 devnull .I u.rc
 94 9f827afd 2005-03-06 devnull are the inverse of
 95 9f827afd 2005-03-06 devnull .I 9
 96 9f827afd 2005-03-06 devnull and
 97 9f827afd 2005-03-06 devnull .IR 9.rc :
 98 9f827afd 2005-03-06 devnull they move
 99 9f827afd 2005-03-06 devnull .B $PLAN9/bin
100 9f827afd 2005-03-06 devnull to the end of the path.
101 93aa30a8 2005-01-14 devnull .SH EXAMPLES
102 93aa30a8 2005-01-14 devnull Search for greek in the password file:
103 93aa30a8 2005-01-14 devnull .IP
104 93aa30a8 2005-01-14 devnull .EX
105 93aa30a8 2005-01-14 devnull $ 9 grep '[α-ζ]' /etc/passwd
106 93aa30a8 2005-01-14 devnull .EE
107 93aa30a8 2005-01-14 devnull .PP
108 93aa30a8 2005-01-14 devnull Start an
109 d32deab1 2020-08-16 rsc .MR rc (1)
110 9f827afd 2005-03-06 devnull with the Plan 9 commands in the path before the system commands,
111 9f827afd 2005-03-06 devnull and then run the Unix
112 9f827afd 2005-03-06 devnull .IR ls :
113 93aa30a8 2005-01-14 devnull .IP
114 93aa30a8 2005-01-14 devnull .EX
115 9f827afd 2005-03-06 devnull $ 9 rc
116 9f827afd 2005-03-06 devnull % u ls
117 93aa30a8 2005-01-14 devnull .EE
118 3940506b 2005-01-13 devnull .SH SOURCE
119 3940506b 2005-01-13 devnull .B \*9/bin/9
120 67075c36 2005-01-14 devnull .br
121 67075c36 2005-01-14 devnull .B \*9/bin/9.rc
122 9f827afd 2005-03-06 devnull .br
123 9f827afd 2005-03-06 devnull .B \*9/bin/u
124 9f827afd 2005-03-06 devnull .br
125 9f827afd 2005-03-06 devnull .B \*9/bin/u.rc
126 3940506b 2005-01-13 devnull .SH SEE ALSO
127 d32deab1 2020-08-16 rsc .MR intro (1)
128 a5632a13 2017-09-01 rsc .SH BUGS
129 a5632a13 2017-09-01 rsc Some shell configurations
130 a5632a13 2017-09-01 rsc (notably, oh-my-zsh)
131 a5632a13 2017-09-01 rsc define
132 a5632a13 2017-09-01 rsc .B 9
133 a5632a13 2017-09-01 rsc as an alias for
134 a5632a13 2017-09-01 rsc .B cd
135 a5632a13 2017-09-01 rsc .BR \-9 ,
136 a5632a13 2017-09-01 rsc which makes the
137 a5632a13 2017-09-01 rsc .I 9
138 a5632a13 2017-09-01 rsc command described here inaccessible.
139 a5632a13 2017-09-01 rsc In such shells, it is necessary to
140 a5632a13 2017-09-01 rsc .B unalias
141 a5632a13 2017-09-01 rsc .B 9
142 a5632a13 2017-09-01 rsc in your initialization scripts.