187866Ssheldonh    1. Building
287866Ssheldonh    ===========
387866Ssheldonh
487866Ssheldonh    Copy config.in file to the config.local and edit it for your needs. Build
587866Ssheldonhprocess requires kernel sources in order to compile KLD module. If you want
687866Ssheldonhto use encrypted passwords you'll need an src/sys/crypto directory (sys-crypto
787866Ssheldonhcvsup collection) because encryption process involves DES algorithm.
887866Ssheldonh
987866Ssheldonh    Note for FreeBSD-current: it have kernel module sources in the base
1087866Ssheldonhtree and requires options LIBMCHAIN and LIBICONV included in the kernel
1187866Ssheldonhconfig file. smbfs can be either compiled in the kernel or loaded as module.
1287866Ssheldonh
1387866Ssheldonh    If FreeBSD machine and SMB server uses different character sets you
1487866Ssheldonhmay consider install ports/converters/iconv package (version 2.0 required).
1587866Ssheldonh
1687866Ssheldonh    Type 'make' to compile.
1787866Ssheldonh	
1887866Ssheldonh    If you're running any previous version of smbfs, unmount all mounted
1987866Ssheldonhshares and unload an old module via 'kldunload smbfs' command.
2087866Ssheldonh
2187866Ssheldonh
2287866Ssheldonh    2. Installing
2387866Ssheldonh    =============
2487866Ssheldonh
2587866Ssheldonh    'make install' command will copy compiled binaries to /usr/local/bin
2687866Ssheldonhdirectory and KLD module into /modules directory.
2787866Ssheldonh
2887866Ssheldonh    If you're running smbfs for the first time, it is also necessary to
2987866Ssheldonhrun 'make makedev' command in order to create /dev/nsmb0 device.
3087866Ssheldonh
3187866Ssheldonh    3. Configuring
3287866Ssheldonh    ==============
3387866Ssheldonh
3487866Ssheldonh    KLD module can be loaded either manually:
3587866Ssheldonh    
3687866Ssheldonh    kldload smbfs.ko
3787866Ssheldonh
3887866Ssheldonh or via loader.conf(5) file:
3987866Ssheldonh
4087866Ssheldonh    smbfs_load="YES"
4187866Ssheldonh
4287866Ssheldonh    However it is not strictly necessary because mount_smbfs(8) command
4387866Ssheldonhwill load it automatically.
4487866Ssheldonh
4587866Ssheldonh    Copy ./examples/dot.nsmbrc file into your home directory with ./.nsmbrc
4687866Ssheldonhname and edit it for your needs.
4787866Ssheldonh
4887866Ssheldonh
4987866Ssheldonh    4. Running
5087866Ssheldonh    ==========
5187866Ssheldonh
5287866Ssheldonh    Please read mount_smbfs man page to get overview of command options.
5387866Ssheldonh
5487866Ssheldonh    Here is a quick example:
5587866Ssheldonh
5687866Ssheldonh	mount_smbfs -I hostname //bp@myserver/myshare /mnt
5787866Ssheldonh
5887866Ssheldonh    If something goes wrong, please try to find a problem and, if it is a bug
5987866Ssheldonh send me detailed description or patch. Before complaining about a bug, please
6087866Ssheldonh check the same operations with smbclient program included in the Samba package.
6187866Ssheldonh 
6287866Ssheldonh
6387866Ssheldonh
6487866Ssheldonh    5. Deinstalling
6587866Ssheldonh    ===============
6687866Ssheldonh
6787866Ssheldonh    All files can be completly removed by typing 'make deinstall' in the 
6887866Ssheldonhworking directory.
69