| 1 | <?xml version = '1.0' encoding = 'UTF-8'?> |
1 | <?xml version = '1.0' encoding = 'UTF-8'?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/quick-samba-howto.xml,v 1.5 2004/05/30 13:24:49 neysx Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/quick-samba-howto.xml,v 1.6 2004/06/22 15:34:19 swift Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | <guide link="quick-samba-howto.xml"> |
4 | <guide link="quick-samba-howto.xml"> |
| 5 | <title>Gentoo Samba3/CUPS/Clam AV HOWTO</title> |
5 | <title>Gentoo Samba3/CUPS/Clam AV HOWTO</title> |
| 6 | <author title="Author"> |
6 | <author title="Author"> |
| 7 | <mail link="daff at dword dot org">Andreas "daff" Ntaflos</mail> |
7 | <mail link="daff at dword dot org">Andreas "daff" Ntaflos</mail> |
| 8 | </author> |
8 | </author> |
| 9 | <author title="Author"> |
9 | <author title="Author"> |
| 10 | <mail link="joshua@sungentoo.homeunix.com">Joshua Preston</mail> |
10 | <mail link="joshua@sungentoo.homeunix.com">Joshua Preston</mail> |
| 11 | </author> |
11 | </author> |
| 12 | |
12 | |
| 13 | <abstract> |
13 | <abstract> |
| 14 | Setup, install and configure a Samba Server under Gentoo that shares |
14 | Setup, install and configure a Samba Server under Gentoo that shares |
| 15 | files, printers without the need to install drivers and provides |
15 | files, printers without the need to install drivers and provides |
| 16 | automatic virus scanning. |
16 | automatic virus scanning. |
| 17 | </abstract> |
17 | </abstract> |
| 18 | |
18 | |
| 19 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
19 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 20 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
20 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
| 21 | <license/> |
21 | <license/> |
| 22 | |
22 | |
| 23 | <version>1.3</version> |
23 | <version>1.4</version> |
| 24 | <date>May 18, 2004</date> |
24 | <date>June 22, 2004</date> |
| 25 | |
25 | |
| 26 | <chapter> |
26 | <chapter> |
| 27 | <title>Introduction to this HOWTO</title> |
27 | <title>Introduction to this HOWTO</title> |
| 28 | <section> |
28 | <section> |
| 29 | <title>Purpose</title> |
29 | <title>Purpose</title> |
| 30 | <body> |
30 | <body> |
| 31 | |
31 | |
| 32 | <p> |
32 | <p> |
| 33 | This HOWTO is designed to help you move a network from many different |
33 | This HOWTO is designed to help you move a network from many different |
| 34 | clients speaking different languages, to many different machines that |
34 | clients speaking different languages, to many different machines that |
| 35 | speak a common language. The ultimate goal is to help differing |
35 | speak a common language. The ultimate goal is to help differing |
| 36 | architectures and technologies, come together in a productive, |
36 | architectures and technologies, come together in a productive, |
| 37 | happily coexisting environment. |
37 | happily coexisting environment. |
| 38 | </p> |
38 | </p> |
| 39 | |
39 | |
| … | |
… | |
| 131 | </li> |
131 | </li> |
| 132 | </ul> |
132 | </ul> |
| 133 | |
133 | |
| 134 | </body> |
134 | </body> |
| 135 | </section> |
135 | </section> |
| 136 | <section> |
136 | <section> |
| 137 | <title>Requirements</title> |
137 | <title>Requirements</title> |
| 138 | <body> |
138 | <body> |
| 139 | |
139 | |
| 140 | <p> |
140 | <p> |
| 141 | We will need the following: |
141 | We will need the following: |
| 142 | </p> |
142 | </p> |
| 143 | |
143 | |
| 144 | <ul> |
144 | <ul> |
| 145 | <li>net-fs/samba</li> |
145 | <li>net-fs/samba</li> |
| 146 | <li>net-mail/clamav</li> |
146 | <li>app-antivirus/clamav</li> |
| 147 | <li>net-print/cups</li> |
147 | <li>net-print/cups</li> |
| 148 | <li>net-print/foomatic</li> |
148 | <li>net-print/foomatic</li> |
| 149 | <li>net-print/hpijs (if you have an HP printer)</li> |
149 | <li>net-print/hpijs (if you have an HP printer)</li> |
| 150 | <li>A kernel of sorts (preferably 2.4.24+ or 2.6.x)</li> |
150 | <li>A kernel of sorts (preferably 2.4.24+ or 2.6.x)</li> |
| 151 | <li>A printer (PS or non-PS, maybe not TOO new or fancy)</li> |
151 | <li>A printer (PS or non-PS, maybe not TOO new or fancy)</li> |
| 152 | <li> |
152 | <li> |
| 153 | A working network (home/office/etc) consisting of more than one machine) |
153 | A working network (home/office/etc) consisting of more than one machine) |
| 154 | </li> |
154 | </li> |
| 155 | </ul> |
155 | </ul> |
| 156 | |
156 | |
| 157 | <p> |
157 | <p> |
| 158 | The main package we use here is net-fs/samba, however, you will need |
158 | The main package we use here is net-fs/samba, however, you will need |
| 159 | a kernel with smbfs support enabled in order to mount a samba or windows |
159 | a kernel with smbfs support enabled in order to mount a samba or windows |
| 160 | share from another computer. CUPS will be emerged if it is not already. |
160 | share from another computer. CUPS will be emerged if it is not already. |
| 161 | net-mail/clamav will be used also, but others should be easily adapted |
161 | app-antivirus/clamav will be used also, but others should be easily adapted |
| 162 | to work with Samba. |
162 | to work with Samba. |
| 163 | </p> |
163 | </p> |
| 164 | |
164 | |
| 165 | </body> |
165 | </body> |
| 166 | </section> |
166 | </section> |
| 167 | </chapter> |
167 | </chapter> |
| 168 | |
168 | |
| 169 | <chapter> |
169 | <chapter> |
| 170 | <title>Getting acquainted with Samba</title> |
170 | <title>Getting acquainted with Samba</title> |
| 171 | <section> |
171 | <section> |
| 172 | <title>The USE Flags</title> |
172 | <title>The USE Flags</title> |
| 173 | <body> |
173 | <body> |
| 174 | |
174 | |
| 175 | <p> |
175 | <p> |
| 176 | Before emerging anything, take a look at the various USE flags |
176 | Before emerging anything, take a look at the various USE flags |
| … | |
… | |
| 351 | </p> |
351 | </p> |
| 352 | |
352 | |
| 353 | </body> |
353 | </body> |
| 354 | </section> |
354 | </section> |
| 355 | <section> |
355 | <section> |
| 356 | <title>Emerging Clam AV</title> |
356 | <title>Emerging Clam AV</title> |
| 357 | <body> |
357 | <body> |
| 358 | |
358 | |
| 359 | <p> |
359 | <p> |
| 360 | Because the <e>oav</e> USE flag only provides an interface to allow on access |
360 | Because the <e>oav</e> USE flag only provides an interface to allow on access |
| 361 | virus scanning, the actual virus scanner must be emerged. The scanner |
361 | virus scanning, the actual virus scanner must be emerged. The scanner |
| 362 | used in this HOWTO is Clam AV. |
362 | used in this HOWTO is Clam AV. |
| 363 | </p> |
363 | </p> |
| 364 | |
364 | |
| 365 | <pre caption="Emerge clam-av"> |
365 | <pre caption="Emerge clam-av"> |
| 366 | # <i>emerge net-mail/clamav</i> |
366 | # <i>emerge app-antivirus/clamav</i> |
| 367 | </pre> |
367 | </pre> |
| 368 | |
368 | |
| 369 | </body> |
369 | </body> |
| 370 | </section> |
370 | </section> |
| 371 | <section> |
371 | <section> |
| 372 | <title>Emerging foomatic</title> |
372 | <title>Emerging foomatic</title> |
| 373 | <body> |
373 | <body> |
| 374 | |
374 | |
| 375 | <pre caption="Emerge foomatic"> |
375 | <pre caption="Emerge foomatic"> |
| 376 | # <i>emerge net-print/foomatic</i> |
376 | # <i>emerge net-print/foomatic</i> |
| 377 | </pre> |
377 | </pre> |
| 378 | |
378 | |
| 379 | </body> |
379 | </body> |
| 380 | </section> |
380 | </section> |
| 381 | <section> |
381 | <section> |