plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

src.1 (1142B)


      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 .MR sam (1) ).
     23 If
     24 .I file
     25 is an
     26 .MR 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 .MR 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 \*9/bin/src
     80 .SH "SEE ALSO"
     81 .MR db (1) ,
     82 .MR plumb (1) ,
     83 .MR sam (1) .