Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH SRC 1
2 
.SH NAME
3 
src  \- find source code for executable
4 
.SH SYNOPSIS
5 
.B src
6 
[
7 
.B -n
8 
]
9 
[
10 
.B -s
11 
.I symbol
12 
]
13 
.I file
14 
.B ...
15 
.SH DESCRIPTION
16 
.I Src
17 
examines the named
18 
.I files
19 
to find the corresponding source code, which is then sent to the editor using
20 
.B B
21 
(see
22 
.IR sam (1)).
23 
If
24 
.I file
25 
is an
26 
.IR rc (1)
27 
script, the source is the file itself.
28 
If
29 
.I file
30 
is an executable, the source is defined to be the single file containing the
31 
definition of
32 
.B main
33 
and
34 
.I src
35 
will point the editor at the line that begins the definition.
36 
.I Src
37 
uses
38 
.IR db (1)
39 
to extract the symbol table information that identifies the source.
40 
.PP
41 
.I Src
42 
looks for each
43 
.I file
44 
in the current directory, in
45 
.BR /bin ,
46 
and in the subdirectories of
47 
.BR /bin ,
48 
in that order.
49 
.PP
50 
The
51 
.B -n
52 
flag causes
53 
.B src
54 
to print the file name but not send it to the editor.
55 
The
56 
.B -s
57 
flag identifies a
58 
.I symbol
59 
other than
60 
.B main
61 
to locate.
62 
.SH EXAMPLES
63 
Find the source to the
64 
.B main
65 
routine in
66 
.BR /bin/ed :
67 
.IP
68 
.EX
69 
src ed
70 
.EE
71 
.PP
72 
Find the source for
73 
.BR strcmp :
74 
.IP
75 
.EX
76 
src -s strcmp rc
77 
.EE
78 
.SH SOURCE
79 
.B /rc/bin/src
80 
.SH "SEE ALSO"
81 
.IR db (1),
82 
.IR plumb (1),
83 
.IR sam (1).