xref: /dflybsd-src/contrib/smbfs/INSTALL (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino    1. Building
286d7f5d3SJohn Marino    ===========
386d7f5d3SJohn Marino
486d7f5d3SJohn Marino    Copy config.in file to the config.local and edit it for your needs. Build
586d7f5d3SJohn Marinoprocess requires kernel sources in order to compile KLD module. If you want
686d7f5d3SJohn Marinoto use encrypted passwords you'll need an src/sys/crypto directory (sys-crypto
786d7f5d3SJohn Marinocvsup collection) because encryption process involves DES algorithm.
886d7f5d3SJohn Marino
986d7f5d3SJohn Marino    Note for FreeBSD-current: it have kernel module sources in the base
1086d7f5d3SJohn Marinotree and requires options LIBMCHAIN and LIBICONV included in the kernel
1186d7f5d3SJohn Marinoconfig file. smbfs can be either compiled in the kernel or loaded as module.
1286d7f5d3SJohn Marino
1386d7f5d3SJohn Marino    If FreeBSD machine and SMB server uses different character sets you
1486d7f5d3SJohn Marinomay consider install ports/converters/iconv package (version 2.0 required).
1586d7f5d3SJohn Marino
1686d7f5d3SJohn Marino    Type 'make' to compile.
1786d7f5d3SJohn Marino
1886d7f5d3SJohn Marino    If you're running any previous version of smbfs, unmount all mounted
1986d7f5d3SJohn Marinoshares and unload an old module via 'kldunload smbfs' command.
2086d7f5d3SJohn Marino
2186d7f5d3SJohn Marino
2286d7f5d3SJohn Marino    2. Installing
2386d7f5d3SJohn Marino    =============
2486d7f5d3SJohn Marino
2586d7f5d3SJohn Marino    'make install' command will copy compiled binaries to /usr/local/bin
2686d7f5d3SJohn Marinodirectory and KLD module into /modules directory.
2786d7f5d3SJohn Marino
2886d7f5d3SJohn Marino    If you're running smbfs for the first time, it is also necessary to
2986d7f5d3SJohn Marinorun 'make makedev' command in order to create /dev/nsmb0 device.
3086d7f5d3SJohn Marino
3186d7f5d3SJohn Marino    3. Configuring
3286d7f5d3SJohn Marino    ==============
3386d7f5d3SJohn Marino
3486d7f5d3SJohn Marino    KLD module can be loaded either manually:
3586d7f5d3SJohn Marino
3686d7f5d3SJohn Marino    kldload smbfs.ko
3786d7f5d3SJohn Marino
3886d7f5d3SJohn Marino or via loader.conf(5) file:
3986d7f5d3SJohn Marino
4086d7f5d3SJohn Marino    smbfs_load="YES"
4186d7f5d3SJohn Marino
4286d7f5d3SJohn Marino    However it is not strictly necessary because mount_smbfs(8) command
4386d7f5d3SJohn Marinowill load it automatically.
4486d7f5d3SJohn Marino
4586d7f5d3SJohn Marino    Copy ./examples/dot.nsmbrc file into your home directory with ./.nsmbrc
4686d7f5d3SJohn Marinoname and edit it for your needs.
4786d7f5d3SJohn Marino
4886d7f5d3SJohn Marino
4986d7f5d3SJohn Marino    4. Running
5086d7f5d3SJohn Marino    ==========
5186d7f5d3SJohn Marino
5286d7f5d3SJohn Marino    Please read mount_smbfs man page to get overview of command options.
5386d7f5d3SJohn Marino
5486d7f5d3SJohn Marino    Here is a quick example:
5586d7f5d3SJohn Marino
5686d7f5d3SJohn Marino	mount_smbfs -I hostname //bp@myserver/myshare /mnt
5786d7f5d3SJohn Marino
5886d7f5d3SJohn Marino    If something goes wrong, please try to find a problem and, if it is a bug
5986d7f5d3SJohn Marino send me detailed description or patch. Before complaining about a bug, please
6086d7f5d3SJohn Marino check the same operations with smbclient program included in the Samba package.
6186d7f5d3SJohn Marino
6286d7f5d3SJohn Marino
6386d7f5d3SJohn Marino
6486d7f5d3SJohn Marino    5. Deinstalling
6586d7f5d3SJohn Marino    ===============
6686d7f5d3SJohn Marino
6786d7f5d3SJohn Marino    All files can be completly removed by typing 'make deinstall' in the
6886d7f5d3SJohn Marinoworking directory.
69