aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml
blob: d3c914e7315c3ea78d20fdb2e015a5b894271260 (plain) (blame)
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<!--
     The FreeBSD Documentation Project

     $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml,v 1.2 2001/07/22 20:08:33 asmodai Exp $
-->

<chapter id="introduction">
  <title>Introduction</title>

  <para>This chapter was written by &a.murray; and &a.asmodai;.</para>

  <sect1>
    <title>Developing on FreeBSD</title>

    <para>So here we are.  System all installed and you are ready to
      start programming.  But where to start?  What does FreeBSD
      provide?  What can it do for me, as a programmer?</para>

    <para>These are some questions which this chapter tries to answer.
      Of course, programming has different levels of proficiency like
      any other trade.  For some it is a hobby, for others it is their
      profession.  The information in this chapter might be more aimed
      towards the beginning programmer, but may also serve to be
      useful for the programmer setting her first steps on the FreeBSD
      platform.</para>      

  </sect1>

  <sect1>
    <title>* The BSD Vision</title>

    <para></para>
  </sect1>
 
  <sect1>
    <title>* Architectural Overview</title>
    <para></para>
  </sect1>

  <sect1>
    <title>The Layout of <filename class="directory">/usr/src</filename></title>

    <para>The complete source code to FreeBSD is available from our
      public CVS repository.  The source code is normally installed in
      <filename class=directory>/usr/src</filename> which contains the
      following subdirectories.</para>

    <para>
      <informaltable frame="none">
        <tgroup cols="2">
	  <thead>
	    <row>
	      <entry>Directory</entry>
	      <entry>Description</entry>
	    </row>
	  </thead>
	  
	  <tbody>
	    <row>
	    <entry><filename class=directory>bin/</filename></entry>
            <entry>Source for files in
            <filename>/bin</filename></entry>
	    </row>
	    
	    <row>
	    <entry><filename class=directory>contrib/</filename></entry>
	    <entry>Source for files from contributed software.</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>crypto/</filename></entry>
	    <entry>DES source</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>etc/</filename></entry>
	    <entry>Source for files in <filename
	    class=directory>/etc</filename></entry>
	    </row>

	    <row>
	    <entry><filename class=directory>games/</filename></entry>
	    <entry>Source for files in <filename
	    class=directory>/usr/games</filename></entry>
	    </row>

	    <row>
	    <entry><filename class=directory>gnu/</filename></entry>
	    <entry>Utilities covered by the GNU Public License</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>include/</filename></entry>
            <entry>Source for files in <filename
            class=directory>/usr/include</filename></entry>
	    </row>

	    <row>
	    <entry><filename
 class=directory>kerberosIV/</filename></entry>
            <entry>Source for Kerbereros version IV</entry>
	    </row>

	    <row>
	    <entry><filename
 class=directory>kerberos5/</filename></entry>
            <entry>Source for Kerbereros version 5</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>lib/</filename></entry>
	    <entry>Source for files in <filename
	    class=directory>/usr/lib</filename></entry>
	    </row>
	    
	    <row>
	    <entry><filename class=directory>libexec/</filename></entry>
	    <entry>Source for files in <filename
	    class=directory>/usr/libexec</filename></entry>
	    </row>
	    
	    <row>
	    <entry><filename
 class=directory>release/</filename></entry>
            <entry>Files required to produce a FreeBSD release</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>sbin/</filename></entry>
	    <entry>Source for files in <filename
	    class=directory>/sbin</filename></entry>
	    </row>

	    <row>
	    <entry><filename class=directory>secure/</filename></entry>
	    <entry>FreeSec sources</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>share/</filename></entry>
	    <entry>Source for files in <filename
	    class=directory>/usr/share</filename></entry>
	    </row>

	    <row>
	    <entry><filename class=directory>sys/</filename></entry>
	    <entry>Kernel source files</entry>
	    </row>

	    <row>
	    <entry><filename class=directory>tools/</filename></entry>
	    <entry>Tools used for maintenance and testing of
	    FreeBSD</entry>
	    </row>

	    <row>
	    <entry><filename
 class=directory>usr.bin/</filename></entry>
            <entry>Source for files in <filename
 class=directory>/usr/bin</filename></entry>
            </row>

	    <row>
	    <entry><filename
 class=directory>usr.sbin/</filename></entry>
            <entry>Source for files in <filename
 class=directory>/usr/sbin</filename></entry>
            </row>
          </tbody>
	</tgroup>
      </informaltable>
    </para>
  </sect1>
</chapter>