From 818db3efd674f66a04c8616d5b6de9c5b89ba71a Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sun, 22 Jan 2006 23:34:28 +0000 Subject: r13070: Add a simple smbd manpage, based on the Samba 3 one. (This used to be commit cbcce3b5731d27e863c916731fe30acac0602c16) --- source4/smbd/config.mk | 1 + source4/smbd/smbd.8.xml | 177 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 178 insertions(+) create mode 100644 source4/smbd/smbd.8.xml (limited to 'source4/smbd') diff --git a/source4/smbd/config.mk b/source4/smbd/config.mk index 16ae45f41f..b6a7cfd039 100644 --- a/source4/smbd/config.mk +++ b/source4/smbd/config.mk @@ -118,6 +118,7 @@ REQUIRED_SUBSYSTEMS = \ # Start BINARY smbd [BINARY::smbd] INSTALLDIR = SBINDIR +MANPAGE = smbd.8 OBJ_FILES = \ server.o REQUIRED_SUBSYSTEMS = \ diff --git a/source4/smbd/smbd.8.xml b/source4/smbd/smbd.8.xml new file mode 100644 index 0000000000..a02c2ce80a --- /dev/null +++ b/source4/smbd/smbd.8.xml @@ -0,0 +1,177 @@ + + + + + + smbd + 8 + + + + + smbd + server to provide filesharing- and directory services to clients + + + + + smbd + -i + -M model + + + + + DESCRIPTION + This program is part of the samba + 7 suite. + + smbd is the server daemon that + provides filesharing and directory services to Windows clients. + The server provides filespace and directory services to + clients using the SMB (or CIFS) protocol and other + related protocols such as DCE/RPC, LDAP and Kerberos. + + + + Clients supported include MSCLIENT 3.0 for DOS, Windows for + Workgroups, Windows 95/98/ME, Windows NT, Windows 2000/XP/2003, + OS/2, DAVE for Macintosh, and cifsfs for Linux. + + An extensive description of the services that the + server can provide is given in the man page for the + configuration file controlling the attributes of those + services (see smb.conf + 5. This man page will not describe the + services, but will concentrate on the administrative aspects + of running the server. + + Please note that there are significant security + implications to running this server, and the smb.conf + 5 manual page should be regarded as mandatory reading before + proceeding with installation. + + As of Samba 4, smbd also incorporates all the functionality of + nmbd. + + + + + OPTIONS + + + + -i + If this parameter is specified it causes the + server to run "interactively", not as a daemon, even if the + server is executed on the command line of a shell. Setting this + parameter negates the implicit deamon mode when run from the + command line. smbd also logs to standard + output, as if the -S parameter had been + given. + + + + + -M model + This parameter can be used to specify the + "process model" smbd should use. This determines + how concurrent clients are handled. Available process + models include single (everything in + a single process), standard (similar + behaviour to that of Samba 3), thread + (single process, different threads. + + + + + + + FILES + + + + /etc/rc + or whatever initialization script your + system uses). + + If running the server as a daemon at startup, + this file will need to contain an appropriate startup + sequence for the server. + + + + /etc/services + If running the server via the + meta-daemon inetd, this file + must contain a mapping of service name (e.g., netbios-ssn) + to service port (e.g., 139) and protocol type (e.g., tcp). + + + + + /usr/local/samba/lib/smb.conf + This is the default location of the smb.conf + 5 server configuration file. Other common places that systems + install this file are /usr/samba/lib/smb.conf + and /etc/samba/smb.conf. + + This file describes all the services the server + is to make available to clients. See smb.conf + 5 for more information. + + + + + + + VERSION + + This man page is correct for version 4 of + the Samba suite. + + + + DIAGNOSTICS + + Most diagnostics issued by the server are logged + in a specified log file. The log file name is specified + at compile time, but may be overridden on the command line. + + The number and nature of diagnostics available depends + on the debug level used by the server. If you have problems, set + the debug level to 3 and peruse the log files. + + Most messages are reasonably self-explanatory. Unfortunately, + at the time this man page was created, there are too many diagnostics + available in the source code to warrant describing each and every + diagnostic. At this stage your best bet is still to grep the + source code and inspect the conditions that gave rise to the + diagnostics you are seeing. + + + + SEE ALSO + hosts_access + 5 + smb.conf + 5, smbclient + 1, testparm + 1, and the + Internet RFC's rfc1001.txt, rfc1002.txt. + In addition the CIFS (formerly SMB) specification is available + as a link from the Web page + http://samba.org/cifs/. + + + + AUTHOR + + The original Samba software and related utilities + were created by Andrew Tridgell. Samba is now developed + by the Samba Team as an Open Source project similar + to the way the Linux kernel is developed. + + + + -- cgit