summaryrefslogtreecommitdiffstats
path: root/contrib/smbfs/INSTALL
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2001-12-14 11:06:03 +0000
committersheldonh <sheldonh@FreeBSD.org>2001-12-14 11:06:03 +0000
commit4e260b134ff188548ec2c8a16a37570a4abf1257 (patch)
tree672d7786f89ed3b67f221098cb86cf0bc53ad5e3 /contrib/smbfs/INSTALL
downloadFreeBSD-src-4e260b134ff188548ec2c8a16a37570a4abf1257.zip
FreeBSD-src-4e260b134ff188548ec2c8a16a37570a4abf1257.tar.gz
Import smbfs-1.4.1.
This is Boris Popov's SMB/CIFS file system implementation for FreeBSD. Obtained from: Boris Popov via ftp://ftp.butya.kz/pub/smbfs/
Diffstat (limited to 'contrib/smbfs/INSTALL')
-rw-r--r--contrib/smbfs/INSTALL68
1 files changed, 68 insertions, 0 deletions
diff --git a/contrib/smbfs/INSTALL b/contrib/smbfs/INSTALL
new file mode 100644
index 0000000..1ae864d
--- /dev/null
+++ b/contrib/smbfs/INSTALL
@@ -0,0 +1,68 @@
+ 1. Building
+ ===========
+
+ Copy config.in file to the config.local and edit it for your needs. Build
+process requires kernel sources in order to compile KLD module. If you want
+to use encrypted passwords you'll need an src/sys/crypto directory (sys-crypto
+cvsup collection) because encryption process involves DES algorithm.
+
+ Note for FreeBSD-current: it have kernel module sources in the base
+tree and requires options LIBMCHAIN and LIBICONV included in the kernel
+config file. smbfs can be either compiled in the kernel or loaded as module.
+
+ If FreeBSD machine and SMB server uses different character sets you
+may consider install ports/converters/iconv package (version 2.0 required).
+
+ Type 'make' to compile.
+
+ If you're running any previous version of smbfs, unmount all mounted
+shares and unload an old module via 'kldunload smbfs' command.
+
+
+ 2. Installing
+ =============
+
+ 'make install' command will copy compiled binaries to /usr/local/bin
+directory and KLD module into /modules directory.
+
+ If you're running smbfs for the first time, it is also necessary to
+run 'make makedev' command in order to create /dev/nsmb0 device.
+
+ 3. Configuring
+ ==============
+
+ KLD module can be loaded either manually:
+
+ kldload smbfs.ko
+
+ or via loader.conf(5) file:
+
+ smbfs_load="YES"
+
+ However it is not strictly necessary because mount_smbfs(8) command
+will load it automatically.
+
+ Copy ./examples/dot.nsmbrc file into your home directory with ./.nsmbrc
+name and edit it for your needs.
+
+
+ 4. Running
+ ==========
+
+ Please read mount_smbfs man page to get overview of command options.
+
+ Here is a quick example:
+
+ mount_smbfs -I hostname //bp@myserver/myshare /mnt
+
+ If something goes wrong, please try to find a problem and, if it is a bug
+ send me detailed description or patch. Before complaining about a bug, please
+ check the same operations with smbclient program included in the Samba package.
+
+
+
+ 5. Deinstalling
+ ===============
+
+ All files can be completly removed by typing 'make deinstall' in the
+working directory.
OpenPOWER on IntegriCloud