regenerate docs
[samba.git] / docs / docbook / faq / general.sgml
1 <chapter id="general">
2 <title>General Information</title>
3
4 <sect1>
5 <title>Where can I get it?</title>
6 <para>
7 The Samba suite is available at the <ulink url="http://samba.org/">samba website</ulink>.
8 </para>
9 </sect1>
10
11 <sect1>
12 <title>What do the version numbers mean?</title>
13 <para>
14 It is not recommended that you run a version of Samba with the word
15 "alpha" in its name unless you know what you are doing and are willing
16 to do some debugging. Many, many people just get the latest
17 recommended stable release version and are happy. If you are brave, by
18 all means take the plunge and help with the testing and development -
19 but don't install it on your departmental server. Samba is typically
20 very stable and safe, and this is mostly due to the policy of many
21 public releases.
22 </para>
23
24 <para>
25 How the scheme works:
26 <simplelist>
27 <member>When major changes are made the version number is increased. For
28 example, the transition from 1.9.15 to 1.9.16. However, this version
29 number will not appear immediately and people should continue to use
30 1.9.15 for production systems (see next point.)</member>
31
32 <member>Just after major changes are made the software is considered
33 unstable, and a series of alpha releases are distributed, for example
34 1.9.16alpha1. These are for testing by those who know what they are
35 doing.  The "alpha" in the filename will hopefully scare off those who
36 are just looking for the latest version to install.</member>
37
38 <member>When Andrew thinks that the alphas have stabilised to the point
39 where he would recommend new users install it, he renames it to the
40 same version number without the alpha, for example 1.9.16.</member>
41
42 <member>Inevitably bugs are found in the "stable" releases and minor patch
43 levels are released which give us the pXX series, for example 1.9.16p2.</member>
44 </simplelist>
45 </para>
46
47 <para>
48 So the progression goes:
49
50 <programlisting>
51 1.9.15p7        (production)
52 1.9.15p8        (production)
53 1.9.16alpha1    (test sites only)
54 :
55 1.9.16alpha20   (test sites only)
56 1.9.16          (production)
57 1.9.16p1        (production)
58 </programlisting>
59 </para>
60
61 <para>
62 The above system means that whenever someone looks at the samba ftp
63 site they will be able to grab the highest numbered release without an
64 alpha in the name and be sure of getting the current recommended
65 version.
66 </para>
67
68 </sect1>
69
70 <sect1>
71 <title>What platforms are supported?</title>
72 <para>
73 Many different platforms have run Samba successfully. The platforms
74 most widely used and thus best tested are Linux and SunOS.</para>
75
76 <para>
77 At time of writing, there is support (or has been support for in earlier 
78 versions):
79 </para>
80
81 <simplelist>
82 <member>A/UX 3.0</member>
83 <member>AIX</member>
84 <member>Altos Series 386/1000</member>
85 <member>Amiga</member>
86 <member>Apollo Domain/OS sr10.3</member>
87 <member>BSDI </member>
88 <member>B.O.S. (Bull Operating System)</member>
89 <member>Cray, Unicos 8.0</member>
90 <member>Convex</member>
91 <member>DGUX. </member>
92 <member>DNIX.</member>
93 <member>FreeBSD</member>
94 <member>HP-UX</member>
95 <member>Intergraph. </member>
96 <member>Linux with/without shadow passwords and quota</member>
97 <member>LYNX 2.3.0</member>
98 <member>MachTen (a unix like system for Macintoshes)</member>
99 <member>Motorola 88xxx/9xx range of machines</member>
100 <member>NetBSD</member>
101 <member>NEXTSTEP Release 2.X, 3.0 and greater (including OPENSTEP for Mach).</member>
102 <member>OS/2 using EMX 0.9b</member>
103 <member>OSF1</member>
104 <member>QNX 4.22</member>
105 <member>RiscIX. </member>
106 <member>RISCOs 5.0B</member>
107 <member>SEQUENT. </member>
108 <member>SCO (including: 3.2v2, European dist., OpenServer 5)</member>
109 <member>SGI.</member>
110 <member>SMP_DC.OSx v1.1-94c079 on Pyramid S series</member>
111 <member>SONY NEWS, NEWS-OS (4.2.x and 6.1.x)</member>
112 <member>SUNOS 4</member>
113 <member>SUNOS 5.2, 5.3, and 5.4 (Solaris 2.2, 2.3, and '2.4 and later')</member>
114 <member>Sunsoft ISC SVR3V4</member>
115 <member>SVR4</member>
116 <member>System V with some berkely extensions (Motorola 88k R32V3.2).</member>
117 <member>ULTRIX.</member>
118 <member>UNIXWARE</member>
119 <member>UXP/DS</member>
120 </simplelist>
121
122 </sect1>
123
124 <sect1>
125 <title>How do I subscribe to the Samba Mailing Lists?</title>
126 <para>
127 Look at <ulink url="http://samba.org/samba/archives.html">the samba mailing list page</ulink>
128 </para>
129 </sect1>
130
131 <sect1>
132 <title>Pizza supply details</title>
133 <para>
134 Those who have registered in the Samba survey as "Pizza Factory" will
135 already know this, but the rest may need some help. Andrew doesn't ask
136 for payment, but he does appreciate it when people give him
137 pizza. This calls for a little organisation when the pizza donor is
138 twenty thousand kilometres away, but it has been done.
139 </para>
140
141 <para>
142 Method 1: Ring up your local branch of an international pizza chain
143 and see if they honour their vouchers internationally. Pizza Hut do,
144 which is how the entire Canberra Linux Users Group got to eat pizza
145 one night, courtesy of someone in the US.
146 </para>
147
148 <para>
149 Method 2: Ring up a local pizza shop in Canberra and quote a credit
150 card number for a certain amount, and tell them that Andrew will be
151 collecting it (don't forget to tell him.) One kind soul from Germany
152 did this.
153 </para>
154
155 <para>
156 Method 3: Purchase a pizza voucher from your local pizza shop that has
157 no international affiliations and send it to Andrew. It is completely
158 useless but he can hang it on the wall next to the one he already has
159 from Germany :-)
160 </para>
161
162 <para>
163 Method 4: Air freight him a pizza with your favourite regional
164 flavours. It will probably get stuck in customs or torn apart by
165 hungry sniffer dogs but it will have been a noble gesture.
166 </para>
167
168 </sect1>
169
170 </chapter>