an, awi, cue and kue don't use the miibus interface.
[dragonfly.git] / contrib / smbfs / INSTALL
1     1. Building
2     ===========
3
4     Copy config.in file to the config.local and edit it for your needs. Build
5 process requires kernel sources in order to compile KLD module. If you want
6 to use encrypted passwords you'll need an src/sys/crypto directory (sys-crypto
7 cvsup collection) because encryption process involves DES algorithm.
8
9     Note for FreeBSD-current: it have kernel module sources in the base
10 tree and requires options LIBMCHAIN and LIBICONV included in the kernel
11 config file. smbfs can be either compiled in the kernel or loaded as module.
12
13     If FreeBSD machine and SMB server uses different character sets you
14 may consider install ports/converters/iconv package (version 2.0 required).
15
16     Type 'make' to compile.
17         
18     If you're running any previous version of smbfs, unmount all mounted
19 shares and unload an old module via 'kldunload smbfs' command.
20
21
22     2. Installing
23     =============
24
25     'make install' command will copy compiled binaries to /usr/local/bin
26 directory and KLD module into /modules directory.
27
28     If you're running smbfs for the first time, it is also necessary to
29 run 'make makedev' command in order to create /dev/nsmb0 device.
30
31     3. Configuring
32     ==============
33
34     KLD module can be loaded either manually:
35     
36     kldload smbfs.ko
37
38  or via loader.conf(5) file:
39
40     smbfs_load="YES"
41
42     However it is not strictly necessary because mount_smbfs(8) command
43 will load it automatically.
44
45     Copy ./examples/dot.nsmbrc file into your home directory with ./.nsmbrc
46 name and edit it for your needs.
47
48
49     4. Running
50     ==========
51
52     Please read mount_smbfs man page to get overview of command options.
53
54     Here is a quick example:
55
56         mount_smbfs -I hostname //bp@myserver/myshare /mnt
57
58     If something goes wrong, please try to find a problem and, if it is a bug
59  send me detailed description or patch. Before complaining about a bug, please
60  check the same operations with smbclient program included in the Samba package.
61  
62
63
64     5. Deinstalling
65     ===============
66
67     All files can be completly removed by typing 'make deinstall' in the 
68 working directory.