security = domain in Samba 2.x

Joining an NT Domain with Samba 2.2

smbpasswd(8) man page for more details.

There is existing development code to join a domain + without having to create the machine trust account on the PDC + beforehand. This code will hopefully be available soon + in release branches as well.

This command goes through the machine account password change protocol, then writes the new (random) machine account password for this Samba server into a file in the same directory @@ -104,11 +118,11 @@ CLASS="REPLACEABLE" ><NT DOMAIN NAME>. - .<Samba Server Name><Samba + Server Name>.mac

Samba and Windows 2000 Domains

Many people have asked regarding the state of Samba's ability to participate in +a Windows 2000 Domain. Samba 2.2 is able to act as a member server of a Windows +2000 domain operating in mixed or native mode.

There is much confusion between the circumstances that require a "mixed" mode +Win2k DC and a when this host can be switched to "native" mode. A "mixed" mode +Win2k domain controller is only needed if Windows NT BDCs must exist in the same +domain. By default, a Win2k DC in "native" mode will still support +NetBIOS and NTLMv1 for authentication of legacy clients such as Windows 9x and +NT 4.0. Samba has the same requirements as a Windows NT 4.0 member server.

The steps for adding a Samba 2.2 host to a Win2k domain are the same as those +for adding a Samba server to a Windows NT 4.0 domain. The only exception is that +the "Server Manager" from NT 4 has been replaced by the "Active Directory Users and +Computers" MMC (Microsoft Management Console) plugin.

Why is this better than security = server?

security = server, @@ -264,6 +303,16 @@ TARGET="_top" NT server in the same way as a Windows 95 or Windows 98 server would.

Please refer to the Winbind + paper for information on a system to automatically + assign UNIX uids and gids to Windows NT Domain users and groups. + This code is available in development branches only at the moment, + but will be moved to release branches soon.

The advantage to domain-level security is that the authentication in domain-level security is passed down the authenticated RPC channel in exactly the same way that an NT server would do it. This diff --git a/docs/htmldocs/ENCRYPTION.html b/docs/htmldocs/ENCRYPTION.html new file mode 100644 index 00000000000..f7424be11a4 --- /dev/null +++ b/docs/htmldocs/ENCRYPTION.html @@ -0,0 +1,656 @@ +LanMan and NT Password Encryption in Samba 2.x

LanMan and NT Password Encryption in Samba 2.x

Introduction

With the development of LanManager and Windows NT + compatible password encryption for Samba, it is now able + to validate user connections in exactly the same way as + a LanManager or Windows NT server.

This document describes how the SMB password encryption + algorithm works and what issues there are in choosing whether + you want to use it. You should read it carefully, especially + the part about security and the "PROS and CONS" section.

How does it work?

LanManager encryption is somewhat similar to UNIX + password encryption. The server uses a file containing a + hashed value of a user's password. This is created by taking + the user's plaintext password, capitalising it, and either + truncating to 14 bytes or padding to 14 bytes with null bytes. + This 14 byte value is used as two 56 bit DES keys to encrypt + a 'magic' eight byte value, forming a 16 byte value which is + stored by the server and client. Let this value be known as + the "hashed password".

Windows NT encryption is a higher quality mechanism, + consisting of doing an MD4 hash on a Unicode version of the user's + password. This also produces a 16 byte hash value that is + non-reversible.

When a client (LanManager, Windows for WorkGroups, Windows + 95 or Windows NT) wishes to mount a Samba drive (or use a Samba + resource), it first requests a connection and negotiates the + protocol that the client and server will use. In the reply to this + request the Samba server generates and appends an 8 byte, random + value - this is stored in the Samba server after the reply is sent + and is known as the "challenge". The challenge is different for + every client connection.

The client then uses the hashed password (16 byte values + described above), appended with 5 null bytes, as three 56 bit + DES keys, each of which is used to encrypt the challenge 8 byte + value, forming a 24 byte value known as the "response".

In the SMB call SMBsessionsetupX (when user level security + is selected) or the call SMBtconX (when share level security is + selected), the 24 byte response is returned by the client to the + Samba server. For Windows NT protocol levels the above calculation + is done on both hashes of the user's password and both responses are + returned in the SMB call, giving two 24 byte values.

The Samba server then reproduces the above calculation, using + its own stored value of the 16 byte hashed password (read from the + smbpasswd file - described later) and the challenge + value that it kept from the negotiate protocol reply. It then checks + to see if the 24 byte value it calculates matches the 24 byte value + returned to it from the client.

If these values match exactly, then the client knew the + correct password (or the 16 byte hashed value - see security note + below) and is thus allowed access. If not, then the client did not + know the correct password and is denied access.

Note that the Samba server never knows or stores the cleartext + of the user's password - just the 16 byte hashed values derived from + it. Also note that the cleartext password or 16 byte hashed values + are never transmitted over the network - thus increasing security.

Important Notes About Security

The unix and SMB password encryption techniques seem similar + on the surface. This similarity is, however, only skin deep. The unix + scheme typically sends clear text passwords over the nextwork when + logging in. This is bad. The SMB encryption scheme never sends the + cleartext password over the network but it does store the 16 byte + hashed values on disk. This is also bad. Why? Because the 16 byte hashed + values are a "password equivalent". You cannot derive the user's + password from them, but they could potentially be used in a modified + client to gain access to a server. This would require considerable + technical knowledge on behalf of the attacker but is perfectly possible. + You should thus treat the smbpasswd file as though it contained the + cleartext passwords of all your users. Its contents must be kept + secret, and the file should be protected accordingly.

Ideally we would like a password scheme which neither requires + plain text passwords on the net or on disk. Unfortunately this + is not available as Samba is stuck with being compatible with + other SMB systems (WinNT, WfWg, Win95 etc).

Warning

Note that Windows NT 4.0 Service pack 3 changed the + default for permissible authentication so that plaintext + passwords are never sent over the wire. + The solution to this is either to switch to encrypted passwords + with Samba or edit the Windows NT registry to re-enable plaintext + passwords. See the document WinNT.txt for details on how to do + this.

Other Microsoft operating systems which also exhibit + this behavior includes

MS DOS Network client 3.0 with + the basic network redirector installed
Windows 95 with the network redirector + update installed
Windows 98 [se]
Windows 2000

Note :All current release of + Microsoft SMB/CIFS clients support authentication via the + SMB Challenge/Response mechanism described here. Enabling + clear text authentication does not disable the ability + of the client to particpate in encrypted authentication.

Advantages of SMB Encryption

plain text passwords are not passed across + the network. Someone using a network sniffer cannot just + record passwords going to the SMB server.
WinNT doesn't like talking to a server + that isn't using SMB encrypted passwords. It will refuse + to browse the server if the server is also in user level + security mode. It will insist on prompting the user for the + password on each connection, which is very annoying. The + only things you can do to stop this is to use SMB encryption. +

Advantages of non-encrypted passwords

plain text passwords are not kept + on disk.
uses same password file as other unix + services such as login and ftp
you are probably already using other + services (such as telnet and ftp) which send plain text + passwords over the net, so sending them for SMB isn't + such a big deal.

The smbpasswd file

In order for Samba to participate in the above protocol + it must be able to look up the 16 byte hashed values given a user name. + Unfortunately, as the UNIX password value is also a one way hash + function (ie. it is impossible to retrieve the cleartext of the user's + password given the UNIX hash of it), a separate password file + containing this 16 byte value must be kept. To minimise problems with + these two password files, getting out of sync, the UNIX /etc/passwd and the smbpasswd file, + a utility, mksmbpasswd.sh, is provided to generate + a smbpasswd file from a UNIX /etc/passwd file. +

To generate the smbpasswd file from your /etc/passwd + file use the following command :

$ cat /etc/passwd | mksmbpasswd.sh + > /usr/local/samba/private/smbpasswd

If you are running on a system that uses NIS, use

$ ypcat passwd | mksmbpasswd.sh + > /usr/local/samba/private/smbpasswd

The mksmbpasswd.sh program is found in + the Samba source directory. By default, the smbpasswd file is + stored in :

/usr/local/samba/private/smbpasswd

The owner of the /usr/local/samba/private/ + directory should be set to root, and the permissions on it should + be set to 0500 (chmod 500 /usr/local/samba/private). +

Likewise, the smbpasswd file inside the private directory should + be owned by root and the permissions on is should be set to 0600 + (chmod 600 smbpasswd).

The format of the smbpasswd file is (The line has been + wrapped here. It should appear as one entry per line in + your smbpasswd file.)

username:uid:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:
+	[Account type]:LCT-<last-change-time>:Long name
+

Although only the username, + uid, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, + [Account type] and last-change-time sections are significant + and are looked at in the Samba code.

It is VITALLY important that there by 32 + 'X' characters between the two ':' characters in the XXX sections - + the smbpasswd and Samba code will fail to validate any entries that + do not have 32 characters between ':' characters. The first XXX + section is for the Lanman password hash, the second is for the + Windows NT version.

When the password file is created all users have password entries + consisting of 32 'X' characters. By default this disallows any access + as this user. When a user has a password set, the 'X' characters change + to 32 ascii hexadecimal digits (0-9, A-F). These are an ascii + representation of the 16 byte hashed value of a user's password.

To set a user to have no password (not recommended), edit the file + using vi, and replace the first 11 characters with the ascii text + "NO PASSWORD" (minus the quotes).

For example, to clear the password for user bob, his smbpasswd file + entry would look like :

	bob:100:NO PASSWORDXXXXXXXXXXXXXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:[U          ]:LCT-00000000:Bob's full name:/bobhome:/bobshell
+

If you are allowing users to use the smbpasswd command to set + their own passwords, you may want to give users NO PASSWORD initially + so they do not have to enter a previous password when changing to their + new password (not recommended). In order for you to allow this the + smbpasswd program must be able to connect to the + smbd daemon as that user with no password. Enable this + by adding the line :

null passwords = yes

to the [global] section of the smb.conf file (this is why + the above scenario is not recommended). Preferably, allocate your + users a default password to begin with, so you do not have + to enable this on your server.

Note : This file should be protected very + carefully. Anyone with access to this file can (with enough knowledge of + the protocols) gain access to your SMB server. The file is thus more + sensitive than a normal unix /etc/passwd file.

The smbpasswd Command

The smbpasswd command maintains the two 32 byte password fields + in the smbpasswd file. If you wish to make it similar to the unix + passwd or yppasswd programs, + install it in /usr/local/samba/bin/ (or your + main Samba binary directory).

Note that as of Samba 1.9.18p4 this program MUST NOT + BE INSTALLED setuid root (the new smbpasswd + code enforces this restriction so it cannot be run this way by + accident).

smbpasswd now works in a client-server mode + where it contacts the local smbd to change the user's password on its + behalf. This has enormous benefits - as follows.

smbpasswd no longer has to be setuid root - + an enormous range of potential security problems is + eliminated.
smbpasswd now has the capability + to change passwords on Windows NT servers (this only works when + the request is sent to the NT Primary Domain Controller if you + are changing an NT Domain user's password).

To run smbpasswd as a normal user just type :

$ smbpasswd

Old SMB password: <type old value here - + or hit return if there was no old password>

New SMB Password: <type new value> +

Repeat New SMB Password: <re-type new value +

If the old value does not match the current value stored for + that user, or the two new values do not match each other, then the + password will not be changed.

If invoked by an ordinary user it will only allow the user + to change his or her own Samba password.

If run by the root user smbpasswd may take an optional + argument, specifying the user name whose SMB password you wish to + change. Note that when run as root smbpasswd does not prompt for + or check the old password value, thus allowing root to set passwords + for users who have forgotten their passwords.

smbpasswd is designed to work in the same way + and be familiar to UNIX users who use the passwd or + yppasswd commands.

For more details on using smbpasswd refer + to the man page which will always be the definitive reference.

Setting up Samba to support LanManager Encryption

This is a very brief description on how to setup samba to + support password encryption.

compile and install samba as usual
enable encrypted passwords in smb.conf by adding the line encrypt + passwords = yes in the [global] section
create the initial smbpasswd + password file in the place you specified in the Makefile + (--prefix=<dir>). See the notes under the The smbpasswd File + section earlier in the document for details.

Note that you can test things using smbclient.

\ No newline at end of file diff --git a/docs/htmldocs/NT_Security.html b/docs/htmldocs/NT_Security.html index 8615a7f0dab..081f7fb838a 100644 --- a/docs/htmldocs/NT_Security.html +++ b/docs/htmldocs/NT_Security.html @@ -1,7 +1,7 @@ UNIX Permission Bits and WIndows NT Access Control Lists

UNIX Permission Bits and WIndows NT Access Control Lists

Viewing and changing UNIX permissions using the NT security dialogs

How to view file security on a Samba share

Viewing file ownership

Viewing file or directory permissions

File Permissions

Directory Permissions

Modifying file or directory permissions

Interaction with the standard Samba create mask parameters

Interaction with the standard Samba file attribute mapping

OS2 Client HOWTO

FAQs

How can I configure OS/2 Warp Connect or + OS/2 Warp 4 as a client for Samba?

A more complete answer to this question can be + found on http://carol.wins.uva.nl/~leeuw/samba/warp.html.

Basically, you need three components:

The File and Print Client ('IBM Peer') +
TCP/IP ('Internet support') +
The "NetBIOS over TCP/IP" driver ('TCPBEUI') +

Installing the first two together with the base operating + system on a blank system is explained in the Warp manual. If Warp + has already been installed, but you now want to install the + networking support, use the "Selective Install for Networking" + object in the "System Setup" folder.

Adding the "NetBIOS over TCP/IP" driver is not described + in the manual and just barely in the online documentation. Start + MPTS.EXE, click on OK, click on "Configure LAPS" and click + on "IBM OS/2 NETBIOS OVER TCP/IP" in 'Protocols'. This line + is then moved to 'Current Configuration'. Select that line, + click on "Change number" and increase it from 0 to 1. Save this + configuration.

If the Samba server(s) is not on your local subnet, you + can optionally add IP names and addresses of these servers + to the "Names List", or specify a WINS server ('NetBIOS + Nameserver' in IBM and RFC terminology). For Warp Connect you + may need to download an update for 'IBM Peer' to bring it on + the same level as Warp 4. See the webpage mentioned above.

How can I configure OS/2 Warp 3 (not Connect), + OS/2 1.2, 1.3 or 2.x for Samba?

You can use the free Microsoft LAN Manager 2.2c Client + for OS/2 from + ftp://ftp.microsoft.com/BusSys/Clients/LANMAN.OS2/. + See http://carol.wins.uva.nl/~leeuw/lanman.html for + more information on how to install and use this client. In + a nutshell, edit the file \OS2VER in the root directory of + the OS/2 boot partition and add the lines:

		20=setup.exe
+		20=netwksta.sys
+		20=netvdd.sys
+

before you install the client. Also, don't use the + included NE2000 driver because it is buggy. Try the NE2000 + or NS2000 driver from + ftp://ftp.cdrom.com/pub/os2/network/ndis/ instead. +

Are there any other issues when OS/2 (any version) + is used as a client?

When you do a NET VIEW or use the "File and Print + Client Resource Browser", no Samba servers show up. This can + be fixed by a patch from http://carol.wins.uva.nl/~leeuw/samba/fix.html. + The patch will be included in a later version of Samba. It also + fixes a couple of other problems, such as preserving long + filenames when objects are dragged from the Workplace Shell + to the Samba server.

How do I get printer driver download working + for OS/2 clients?

First, create a share called [PRINTDRV] that is + world-readable. Copy your OS/2 driver files there. Note + that the .EA_ files must still be separate, so you will need + to use the original install files, and not copy an installed + driver from an OS/2 system.

Install the NT driver first for that printer. Then, + add to your smb.conf a paramater, "os2 driver map = + filename". Then, in the file + specified by filename, map the + name of the NT driver name to the OS/2 driver name as + follows:

<nt driver name> = <os2 driver + name>.<device name>, e.g.: + HP LaserJet 5L = LASERJET.HP LaserJet 5L

You can have multiple drivers mapped in this file.

If you only specify the OS/2 driver name, and not the + device name, the first attempt to download the driver will + actually download the files, but the OS/2 client will tell + you the driver is not available. On the second attempt, it + will work. This is fixed simply by adding the device name + to the mapping, after which it will work on the first attempt. +

\ No newline at end of file diff --git a/docs/htmldocs/Samba-HOWTO-Collection.html b/docs/htmldocs/Samba-HOWTO-Collection.html new file mode 100644 index 00000000000..a0d0573005f --- /dev/null +++ b/docs/htmldocs/Samba-HOWTO-Collection.html @@ -0,0 +1,5936 @@ +SAMBA Project Documentation

SAMBA Project Documentation

SAMBA Team

Abstract

This book is a collection of HOWTOs added to Samba documentation over the year. +I try to ensure that all are current, but sometimes the is a larger job +than one person can maintain. You can always find the later version of this +PDF file at http://www.samba.org/ +on the "Documentation" page. Please send updates to jerry@samba.org.

Cheers, jerry

Table of Contents

1. How to Install and Test SAMBA

Step 0: Read the man pages

Step 1: Building the Binaries

Step 2: The all important step

Step 3: Create the smb configuration file.

Step 4: Test your config file with + testparm

Step 5: Starting the smbd and nmbd

Step 5a: Starting from inetd.conf
Step 5b. Alternative: starting it as a daemon

Step 6: Try listing the shares available on your + server

Step 7: Try connecting with the unix client

Step 8: Try connecting from a DOS, WfWg, Win9x, WinNT, + Win2k, OS/2, etc... client

What If Things Don't Work?

Diagnosing Problems
Scope IDs
Choosing the Protocol Level
Printing from UNIX to a Client PC
Locking
Mapping Usernames
Other Character Sets

2. LanMan and NT Password Encryption in Samba 2.x

Introduction

How does it work?

Important Notes About Security

Advantages of SMB Encryption
Advantages of non-encrypted passwords

The smbpasswd file

The smbpasswd Command

Setting up Samba to support LanManager Encryption

3. Hosting a Microsoft Distributed File System tree on Samba

Instructions

Notes

4. Printing Support in Samba 2.2.x

Introduction

Configuration

Support a large number of printers

The Imprints Toolset

What is Imprints?
Creating Printer Driver Packages
The Imprints server
The Installation Client

Migration to from Samba 2.0.x to + 2.2.x

5. security = domain in Samba 2.x

Joining an NT Domain with Samba 2.2
Samba and Windows 2000 Domains
Why is this better than security = server?

6. How to Configure Samba 2.2.x as a Primary Domain Controller

Background

Configuring the Samba Domain Controller

Creating Machine Trust Accounts and Joining Clients +to the Domain

Common Problems and Errors

System Policies and Profiles

What other help can I get ?

URLs and similar
Mailing Lists

DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba

7. Unifed Logons between Windows NT and UNIX using Winbind

Abstract

Introduction

What Winbind Provides

Target Uses

How Winbind Works

Microsoft Remote Procedure Calls
Name Service Switch
Pluggable Authentication Modules
User and Group ID Allocation
Result Caching

Installation and Configuration

Limitations

Conclusion

8. UNIX Permission Bits and WIndows NT Access Control Lists

Viewing and changing UNIX permissions using the NT + security dialogs

How to view file security on a Samba share

Viewing file ownership

Viewing file or directory permissions

File Permissions
Directory Permissions

Modifying file or directory permissions

Interaction with the standard Samba create mask + parameters

Interaction with the standard Samba file attribute + mapping

9. OS2 Client HOWTO

FAQs

How can I configure OS/2 Warp Connect or + OS/2 Warp 4 as a client for Samba?
How can I configure OS/2 Warp 3 (not Connect), + OS/2 1.2, 1.3 or 2.x for Samba?
Are there any other issues when OS/2 (any version) + is used as a client?
How do I get printer driver download working + for OS/2 clients?

Chapter 1. How to Install and Test SAMBA

Step 0: Read the man pages

The man pages distributed with SAMBA contain + lots of useful info that will help to get you started. + If you don't know how to read man pages then try + something like:

$ nroff -man smbd.8 | more +

Other sources of information are pointed to + by the Samba web site, http://www.samba.org

Step 1: Building the Binaries

To do this, first run the program ./configure + in the source directory. This should automatically + configure Samba for your operating system. If you have unusual + needs then you may wish to run

root# ./configure --help +

first to see what special options you can enable. + Then exectuting

root# make

will create the binaries. Once it's successfully + compiled you can use

root# make install

to install the binaries and manual pages. You can + separately install the binaries and/or man pages using

root# make installbin +

and

root# make installman +

Note that if you are upgrading for a previous version + of Samba you might like to know that the old versions of + the binaries will be renamed with a ".old" extension. You + can go back to the previous version with

root# make revert +

if you find this version a disaster!

Step 2: The all important step

At this stage you must fetch yourself a + coffee or other drink you find stimulating. Getting the rest + of the install right can sometimes be tricky, so you will + probably need it.

If you have installed samba before then you can skip + this step.

Step 3: Create the smb configuration file.

There are sample configuration files in the examples + subdirectory in the distribution. I suggest you read them + carefully so you can see how the options go together in + practice. See the man page for all the options.

The simplest useful configuration file would be + something like this:

	[global]
+	   workgroup = MYGROUP
+
+	   [homes]
+	      guest ok = no
+	      read only = no
+

which would allow connections by anyone with an + account on the server, using either their login name or + "homes" as the service name. (Note that I also set the + workgroup that Samba is part of. See BROWSING.txt for defails)

Note that make install will not install + a smb.conf file. You need to create it + yourself.

Make sure you put the smb.conf file in the same place + you specified in theMakefile (the default is to + look for it in /usr/local/samba/lib/).

For more information about security settings for the + [homes] share please refer to the document UNIX_SECURITY.txt.

Step 4: Test your config file with + testparm

It's important that you test the validity of your + smb.conf file using the testparm program. + If testparm runs OK then it will list the loaded services. If + not it will give an error message.

Make sure it runs OK and that the services look + resonable before proceeding.

Step 5: Starting the smbd and nmbd

You must choose to start smbd and nmbd either + as daemons or from inetd. Don't try + to do both! Either you can put them in inetd.conf and have them started on demand + by inetd, or you can start them as + daemons either from the command line or in /etc/rc.local. See the man pages for details + on the command line options. Take particular care to read + the bit about what user you need to be in order to start + Samba. In many cases you must be root.

The main advantage of starting smbd + and nmbd as a daemon is that they will + respond slightly more quickly to an initial connection + request. This is, however, unlikely to be a problem.

Step 5a: Starting from inetd.conf

NOTE; The following will be different if + you use NIS or NIS+ to distributed services maps.

Look at your /etc/services. + What is defined at port 139/tcp. If nothing is defined + then add a line like this:

netbios-ssn 139/tcp

similarly for 137/udp you should have an entry like:

netbios-ns 137/udp

Next edit your /etc/inetd.conf + and add two lines something like this:

		netbios-ssn stream tcp nowait root /usr/local/samba/bin/smbd smbd 
+		netbios-ns dgram udp wait root /usr/local/samba/bin/nmbd nmbd 
+

The exact syntax of /etc/inetd.conf + varies between unixes. Look at the other entries in inetd.conf + for a guide.

NOTE: Some unixes already have entries like netbios_ns + (note the underscore) in /etc/services. + You must either edit /etc/services or + /etc/inetd.conf to make them consistant.

NOTE: On many systems you may need to use the + "interfaces" option in smb.conf to specify the IP address + and netmask of your interfaces. Run ifconfig + as root if you don't know what the broadcast is for your + net. nmbd tries to determine it at run + time, but fails on somunixes. See the section on "testing nmbd" + for a method of finding if you need to do this.

!!!WARNING!!! Many unixes only accept around 5 + parameters on the command line in inetd.conf. + This means you shouldn't use spaces between the options and + arguments, or you should use a script, and start the script + from inetd.

Restart inetd, perhaps just send + it a HUP. If you have installed an earlier version of nmbd then you may need to kill nmbd as well.

Step 5b. Alternative: starting it as a daemon

To start the server as a daemon you should create + a script something like this one, perhaps calling + it startsmb.

		#!/bin/sh
+		/usr/local/samba/bin/smbd -D 
+		/usr/local/samba/bin/nmbd -D 
+

then make it executable with chmod + +x startsmb

You can then run startsmb by + hand or execute it from /etc/rc.local +

To kill it send a kill signal to the processes + nmbd and smbd.

NOTE: If you use the SVR4 style init system then + you may like to look at the examples/svr4-startup + script to make Samba fit into that system.

Step 6: Try listing the shares available on your + server

$ smbclient -L + yourhostname

Your should get back a list of shares available on + your server. If you don't then something is incorrectly setup. + Note that this method can also be used to see what shares + are available on other LanManager clients (such as WfWg).

If you choose user level security then you may find + that Samba requests a password before it will list the shares. + See the smbclient man page for details. (you + can force it to list the shares without a password by + adding the option -U% to the command line. This will not work + with non-Samba servers)

Step 7: Try connecting with the unix client

$ smbclient //yourhostname/aservice

Typically the yourhostname + would be the name of the host where you installed smbd. The aservice is + any service you have defined in the smb.conf + file. Try your user name if you just have a [homes] section + in smb.conf.

For example if your unix host is bambi and your login + name is fred you would type:

$ smbclient //bambi/fred +

Step 8: Try connecting from a DOS, WfWg, Win9x, WinNT, + Win2k, OS/2, etc... client

Try mounting disks. eg:

C:\WINDOWS\> net use d: \\servername\service +

Try printing. eg:

C:\WINDOWS\> net use lpt1: + \\servername\spoolservice

C:\WINDOWS\> print filename +

Celebrate, or send me a bug report!

What If Things Don't Work?

If nothing works and you start to think "who wrote + this pile of trash" then I suggest you do step 2 again (and + again) till you calm down.

Then you might read the file DIAGNOSIS.txt and the + FAQ. If you are still stuck then try the mailing list or + newsgroup (look in the README for details). Samba has been + successfully installed at thousands of sites worldwide, so maybe + someone else has hit your problem and has overcome it. You could + also use the WWW site to scan back issues of the samba-digest.

When you fix the problem PLEASE send me some updates to the + documentation (or source code) so that the next person will find it + easier.

Diagnosing Problems

If you have instalation problems then go to + DIAGNOSIS.txt to try to find the + problem.

Scope IDs

By default Samba uses a blank scope ID. This means + all your windows boxes must also have a blank scope ID. + If you really want to use a non-blank scope ID then you will + need to use the -i <scope> option to nmbd, smbd, and + smbclient. All your PCs will need to have the same setting for + this to work. I do not recommend scope IDs.

Choosing the Protocol Level

The SMB protocol has many dialects. Currently + Samba supports 5, called CORE, COREPLUS, LANMAN1, + LANMAN2 and NT1.

You can choose what maximum protocol to support + in the smb.conf file. The default is + NT1 and that is the best for the vast majority of sites.

In older versions of Samba you may have found it + necessary to use COREPLUS. The limitations that led to + this have mostly been fixed. It is now less likely that you + will want to use less than LANMAN1. The only remaining advantage + of COREPLUS is that for some obscure reason WfWg preserves + the case of passwords in this protocol, whereas under LANMAN1, + LANMAN2 or NT1 it uppercases all passwords before sending them, + forcing you to use the "password level=" option in some cases.

The main advantage of LANMAN2 and NT1 is support for + long filenames with some clients (eg: smbclient, Windows NT + or Win95).

See the smb.conf(5) manual page for more details.

Note: To support print queue reporting you may find + that you have to use TCP/IP as the default protocol under + WfWg. For some reason if you leave Netbeui as the default + it may break the print queue reporting on some systems. + It is presumably a WfWg bug.

Printing from UNIX to a Client PC

To use a printer that is available via a smb-based + server from a unix host you will need to compile the + smbclient program. You then need to install the script + "smbprint". Read the instruction in smbprint for more details. +

There is also a SYSV style script that does much + the same thing called smbprint.sysv. It contains instructions.

Locking

One area which sometimes causes trouble is locking.

There are two types of locking which need to be + performed by a SMB server. The first is "record locking" + which allows a client to lock a range of bytes in a open file. + The second is the "deny modes" that are specified when a file + is open.

Samba supports "record locking" using the fcntl() unix system + call. This is often implemented using rpc calls to a rpc.lockd process + running on the system that owns the filesystem. Unfortunately many + rpc.lockd implementations are very buggy, particularly when made to + talk to versions from other vendors. It is not uncommon for the + rpc.lockd to crash.

There is also a problem translating the 32 bit lock + requests generated by PC clients to 31 bit requests supported + by most unixes. Unfortunately many PC applications (typically + OLE2 applications) use byte ranges with the top bit set + as semaphore sets. Samba attempts translation to support + these types of applications, and the translation has proved + to be quite successful.

Strictly a SMB server should check for locks before + every read and write call on a file. Unfortunately with the + way fcntl() works this can be slow and may overstress the + rpc.lockd. It is also almost always unnecessary as clients + are supposed to independently make locking calls before reads + and writes anyway if locking is important to them. By default + Samba only makes locking calls when explicitly asked + to by a client, but if you set "strict locking = yes" then it will + make lock checking calls on every read and write.

You can also disable by range locking completely + using "locking = no". This is useful for those shares that + don't support locking or don't need it (such as cdroms). In + this case Samba fakes the return codes of locking calls to + tell clients that everything is OK.

The second class of locking is the "deny modes". These + are set by an application when it opens a file to determine + what types of access should be allowed simultaneously with + its open. A client may ask for DENY_NONE, DENY_READ, DENY_WRITE + or DENY_ALL. There are also special compatability modes called + DENY_FCB and DENY_DOS.

You can disable share modes using "share modes = no". + This may be useful on a heavily loaded server as the share + modes code is very slow. See also the FAST_SHARE_MODES + option in the Makefile for a way to do full share modes + very fast using shared memory (if your OS supports it).

Mapping Usernames

If you have different usernames on the PCs and + the unix server then take a look at the "username map" option. + See the smb.conf man page for details.

Other Character Sets

If you have problems using filenames with accented + characters in them (like the German, French or Scandinavian + character sets) then I recommmend you look at the "valid chars" + option in smb.conf and also take a look at the validchars + package in the examples directory.

Chapter 2. LanMan and NT Password Encryption in Samba 2.x

Introduction

How does it work?

Windows NT encryption is a higher quality mechanism, + consisting of doing an MD4 hash on a Unicode version of the user's + password. This also produces a 16 byte hash value that is + non-reversible.

Important Notes About Security

Warning

Other Microsoft operating systems which also exhibit + this behavior includes

MS DOS Network client 3.0 with + the basic network redirector installed
Windows 95 with the network redirector + update installed
Windows 98 [se]
Windows 2000

Advantages of SMB Encryption

plain text passwords are not passed across + the network. Someone using a network sniffer cannot just + record passwords going to the SMB server.
WinNT doesn't like talking to a server + that isn't using SMB encrypted passwords. It will refuse + to browse the server if the server is also in user level + security mode. It will insist on prompting the user for the + password on each connection, which is very annoying. The + only things you can do to stop this is to use SMB encryption. +

Advantages of non-encrypted passwords

plain text passwords are not kept + on disk.
uses same password file as other unix + services such as login and ftp
you are probably already using other + services (such as telnet and ftp) which send plain text + passwords over the net, so sending them for SMB isn't + such a big deal.

The smbpasswd file

To generate the smbpasswd file from your /etc/passwd + file use the following command :

$ cat /etc/passwd | mksmbpasswd.sh + > /usr/local/samba/private/smbpasswd

If you are running on a system that uses NIS, use

$ ypcat passwd | mksmbpasswd.sh + > /usr/local/samba/private/smbpasswd

The mksmbpasswd.sh program is found in + the Samba source directory. By default, the smbpasswd file is + stored in :

/usr/local/samba/private/smbpasswd

The owner of the /usr/local/samba/private/ + directory should be set to root, and the permissions on it should + be set to 0500 (chmod 500 /usr/local/samba/private). +

Likewise, the smbpasswd file inside the private directory should + be owned by root and the permissions on is should be set to 0600 + (chmod 600 smbpasswd).

The format of the smbpasswd file is (The line has been + wrapped here. It should appear as one entry per line in + your smbpasswd file.)

username:uid:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:
+	[Account type]:LCT-<last-change-time>:Long name
+

Although only the username, + uid, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, + [Account type] and last-change-time sections are significant + and are looked at in the Samba code.

To set a user to have no password (not recommended), edit the file + using vi, and replace the first 11 characters with the ascii text + "NO PASSWORD" (minus the quotes).

For example, to clear the password for user bob, his smbpasswd file + entry would look like :

	bob:100:NO PASSWORDXXXXXXXXXXXXXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:[U          ]:LCT-00000000:Bob's full name:/bobhome:/bobshell
+

null passwords = yes

The smbpasswd Command

Note that as of Samba 1.9.18p4 this program MUST NOT + BE INSTALLED setuid root (the new smbpasswd + code enforces this restriction so it cannot be run this way by + accident).

smbpasswd now works in a client-server mode + where it contacts the local smbd to change the user's password on its + behalf. This has enormous benefits - as follows.

smbpasswd no longer has to be setuid root - + an enormous range of potential security problems is + eliminated.
smbpasswd now has the capability + to change passwords on Windows NT servers (this only works when + the request is sent to the NT Primary Domain Controller if you + are changing an NT Domain user's password).

To run smbpasswd as a normal user just type :

$ smbpasswd

Old SMB password: <type old value here - + or hit return if there was no old password>

New SMB Password: <type new value> +

Repeat New SMB Password: <re-type new value +

If the old value does not match the current value stored for + that user, or the two new values do not match each other, then the + password will not be changed.

If invoked by an ordinary user it will only allow the user + to change his or her own Samba password.

smbpasswd is designed to work in the same way + and be familiar to UNIX users who use the passwd or + yppasswd commands.

For more details on using smbpasswd refer + to the man page which will always be the definitive reference.

Setting up Samba to support LanManager Encryption

This is a very brief description on how to setup samba to + support password encryption.

compile and install samba as usual
enable encrypted passwords in smb.conf by adding the line encrypt + passwords = yes in the [global] section
create the initial smbpasswd + password file in the place you specified in the Makefile + (--prefix=<dir>). See the notes under the The smbpasswd File + section earlier in the document for details.

Note that you can test things using smbclient.

Chapter 3. Hosting a Microsoft Distributed File System tree on Samba

Instructions

The Distributed File System (or Dfs) provides a means of + separating the logical view of files and directories that users + see from the actual physical locations of these resources on the + network. It allows for higher availability, smoother storage expansion, + load balancing etc. For more information about Dfs, refer to Microsoft documentation.

This document explains how to host a Dfs tree on a Unix + machine (for Dfs-aware clients to browse) using Samba.

To enable SMB-based DFS for Samba, configure it with the + --with-msdfs option. Once built, a + Samba server can be made a Dfs server by setting the global + boolean host msdfs parameter in the smb.conf + file. You designate a share as a Dfs root using the share + level boolean msdfs root parameter. A Dfs root directory on + Samba hosts Dfs links in the form of symbolic links that point + to other servers. For example, a symbolic link + junction->msdfs:storage1\share1 in + the share directory acts as the Dfs junction. When Dfs-aware + clients attempt to access the junction link, they are redirected + to the storage location (in this case, \\storage1\share1).

Dfs trees on Samba work with all Dfs-aware clients ranging + from Windows 95 to 2000.

Here's an example of setting up a Dfs tree on a Samba + server.

# The smb.conf file:
+[global]
+	netbios name = SAMBA
+	host msdfs   = yes
+
+[dfs]
+	path = /export/dfsroot
+	msdfs root = yes
+

In the /export/dfsroot directory we set up our dfs links to + other servers on the network.

root# cd /export/dfsroot

root# chown root /export/dfsroot

root# chmod 755 /export/dfsroot

root# ln -s msdfs:storageA\\shareA linka

root# ln -s msdfs:serverB\\share,serverC\\share linkb

You should set up the permissions and ownership of + the directory acting as the Dfs root such that only designated + users can create, delete or modify the msdfs links. Also note + that symlink names should be all lowercase. This limitation exists + to have Samba avoid trying all the case combinations to get at + the link name. Finally set up the symbolic links to point to the + network shares you want, and start Samba.

Users on Dfs-aware clients can now browse the Dfs tree + on the Samba server at \\samba\dfs. Accessing + links linka or linkb (which appear as directories to the client) + takes users directly to the appropriate shares on the network.

Notes

Windows clients need to be rebooted + if a previously mounted non-dfs share is made a dfs + root or vice versa. A better way is to introduce a + new share and make it the dfs root.
Currently there's a restriction that msdfs + symlink names should all be lowercase.
For security purposes, the directory + acting as the root of the Dfs tree should have ownership + and permissions set so that only designated users can + modify the symbolic links in the directory.

Chapter 4. Printing Support in Samba 2.2.x

Introduction

Beginning with the 2.2.0 release, Samba supports +the native Windows NT printing mechanisms implemented via +MS-RPC (i.e. the SPOOLSS named pipe). Previous versions of +Samba only supported LanMan printing calls.

The additional functionality provided by the new +SPOOLSS support includes:

Support for downloading printer driver + files to Windows 95/98/NT/2000 clients upon demand. +
Uploading of printer drivers via the + Windows NT Add Printer Wizard (APW) or the + Imprints tool set (refer to http://imprints.sourceforge.net). +
Support for the native MS-RPC printing + calls such as StartDocPrinter, EnumJobs(), etc... (See + the MSDN documentation + at http://msdn.microsoft.com/ for more information on the Win32 printing API) +
Support for NT Access Control Lists (ACL) + on printer objects
Improved support for printer queue manipulation + through the use of an internal databases for spooled job + information

Configuration

In order to support the uploading of printer driver +files, you must first configure a file share named [print$]. +The name of this share is hard coded in Samba's internals so +the name is very important (print$ is the service used by +Windows NT print servers to provide support for printer driver +download).

Warning

Previous versions of Samba recommended using + a share named [printer$]. This name was taken from the + printer$ service created by Windows 9x clients when a + printer was shared. Windows 9x printer servers always have + a printer$ service which provides read-only access via no + password in order to support printer driver downloads.

However, the initial implementation allowed for a + parameter named printer driver location + to be used on a per share basis to specify the location of + the driver files associated with that printer. Another + parameter named printer driver provided + a means of defining the printer driver name to be sent to + the client.

These parameters, including printer driver + file parameter, are being depreciated and should not + be used in new installations. For more information on this change, + you should refer to the Migration section + of this document.

You should modify the server's smb.conf file to create the +following file share (of course, some of the parameter values, +such as 'path' are arbitrary and should be replaced with +appropriate values for your site):

[print$]
+    path = /usr/local/samba/printers
+    guest ok = yes
+    browseable = yes
+    read only = yes
+    write list = ntadmin

The write list is used to allow administrative +level user accounts to have write access in order to update files +on the share. See the smb.conf(5) man page for more information on +configuring file shares.

The requirement for guest ok = yes depends upon how your +site is configured. If users will be guaranteed to have +an account on the Samba host, then this is a non-issue.

author's note: The non-issue is that +if all your Windows NT users are guaranteed to be authenticated +by the Samba server (such as a domain member server and the NT +user has already been validated by the Domain Controller in +order to logon to the Windows NT console), then guest access +is not necessary. Of course, in a workgroup environment where +you just want to be able to print without worrying about +silly accounts and security, then configure the share for +guest access. You'll probably want to add map to guest = Bad User in the [global] section as well. Make sure +you understand what this parameter does before using it +though. --jerry]

In order for a Windows NT print server to support +the downloading of driver files by multiple client architectures, +it must create subdirectories within the [print$] service +which correspond to each of the supported client architectures. +Samba follows this model as well.

Next create the directory tree below the [print$] share +for each architecture you wish to support.

[print$]-----
+        |-W32X86           ; "Windows NT x86"
+        |-WIN40            ; "Windows 95/98"
+        |-W32ALPHA         ; "Windows NT Alpha_AXP"
+        |-W32MIPS          ; "Windows NT R4000"
+        |-W32PPC           ; "Windows NT PowerPC"

Warning

ATTENTION! REQUIRED PERMISSIONS

In order to currently add a new driver to you Samba host, + one of two conditions must hold true:

The account used to connect to the Samba host + must have a uid of 0 (i.e. a root account)
The account used to connect to the Samba host + must be a member of the printer admin list.

Of course, the connected account must still possess access + to add files to the subdirectories beneath [print$].

Once you have created the required [print$] service and +associated subdirectories, simply log onto the Samba server using +a root (or printer admin) account +from a Windows NT 4.0 client. Navigate to the "Printers" folder +on the Samba server. You should see an initial listing of printers +that matches the printer shares defined on your Samba host.

The initial listing of printers in the Samba host's +Printers folder will have no printer driver assigned to them. +The way assign a driver to a printer is to view the Properties +of the printer and either

Use the "New Driver..." button to install + a new printer driver, or
Select a driver from the popup list of + installed drivers. Initially this list will be empty.

If you wish to install printer drivers for client +operating systems other than "Windows NT x86", you will need +to use the "Sharing" tab of the printer properties dialog.

Assuming you have connected with a root account, you +will also be able modify other printer properties such as +ACLs and device settings using this dialog box.

A few closing comments for this section, it is possible +on a Windows NT print server to have printers +listed in the Printers folder which are not shared. Samba does +not make this distinction. By definition, the only printers of +which Samba is aware are those which are specified as shares in +smb.conf.

Another interesting side note is that Windows NT clients do +not use the SMB printer share, but rather can print directly +to any printer on another Windows NT host using MS-RPC. This +of course assumes that the printing client has the necessary +privileges on the remote host serving the printer. The default +permissions assigned by Windows NT to a printer gives the "Print" +permissions to the "Everyone" well-known group.

Support a large number of printers

One issue that has arisen during the development +phase of Samba 2.2 is the need to support driver downloads for +100's of printers. Using the Windows NT APW is somewhat +awkward to say the list. If more than one printer are using the +same driver, the rpcclient's +setdriver command can be used to set the driver +associated with an installed driver. The following is example +of how this could be accomplished:

 
+$ rpcclient pogo -U root%secret -c "enumdrivers"
+Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
+ 
+[Windows NT x86]
+Printer Driver Info 1:
+     Driver Name: [HP LaserJet 4000 Series PS]
+ 
+Printer Driver Info 1:
+     Driver Name: [HP LaserJet 2100 Series PS]
+ 
+Printer Driver Info 1:
+     Driver Name: [HP LaserJet 4Si/4SiMX PS]
+				  
+$ rpcclient pogo -U root%secret -c "enumprinters"
+Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
+     flags:[0x800000]
+     name:[\\POGO\hp-print]
+     description:[POGO\\POGO\hp-print,NO DRIVER AVAILABLE FOR THIS PRINTER,]
+     comment:[]
+				  
+$ rpcclient pogo -U root%bleaK.er \
+>  -c "setdriver hp-print \"HP LaserJet 4000 Series PS\""
+Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
+Successfully set hp-print to driver HP LaserJet 4000 Series PS.

The Imprints Toolset

The Imprints tool set provides a UNIX equivalent of the + Windows NT Add Printer Wizard. For complete information, please + refer to the Imprints web site at http://imprints.sourceforge.net/ as well as the documentation + included with the imprints source distribution. This section will + only provide a brief introduction to the features of Imprints.

What is Imprints?

Imprints is a collection of tools for supporting the goals + of

Providing a central repository information + regarding Windows NT and 95/98 printer driver packages
Providing the tools necessary for creating + the Imprints printer driver packages.
Providing an installation client which + will obtain and install printer drivers on remote Samba + and Windows NT 4 print servers.

Creating Printer Driver Packages

The process of creating printer driver packages is beyond + the scope of this document (refer to Imprints.txt also included + with the Samba distribution for more information). In short, + an Imprints driver package is a gzipped tarball containing the + driver files, related INF files, and a control file needed by the + installation client.

The Imprints server

The Imprints server is really a database server that + may be queried via standard HTTP mechanisms. Each printer + entry in the database has an associated URL for the actual + downloading of the package. Each package is digitally signed + via GnuPG which can be used to verify that package downloaded + is actually the one referred in the Imprints database. It is + not recommended that this security check + be disabled.

The Installation Client

More information regarding the Imprints installation client + is available in the Imprints-Client-HOWTO.ps + file included with the imprints source package.

The Imprints installation client comes in two forms.

a set of command line Perl scripts
a GTK+ based graphical interface to + the command line perl scripts

The installation client (in both forms) provides a means + of querying the Imprints database server for a matching + list of known printer model names as well as a means to + download and install the drivers on remote Samba and Windows + NT print servers.

The basic installation process is in four steps and + perl code is wrapped around smbclient + and rpcclient.

	
+		foreach (supported architecture for a given driver)
+		{
+			1.	rpcclient: Get the appropriate upload directory 
+				on the remote server
+			2.	smbclient: Upload the driver files
+			3.	rpcclient: Issues an AddPrinterDriver() MS-RPC
+		}
+	
+		4.	rpcclient: Issue an AddPrinterEx() MS-RPC to actually
+			create the printer
+

One of the problems encountered when implementing + the Imprints tool set was the name space issues between + various supported client architectures. For example, Windows + NT includes a driver named "Apple LaserWriter II NTX v51.8" + and Windows 95 callsits version of this driver "Apple + LaserWriter II NTX"

The problem is how to know what client drivers have + been uploaded for a printer. As astute reader will remember + that the Windows NT Printer Properties dialog only includes + space for one printer driver name. A quick look in the + Windows NT 4.0 system registry at

HKLM\System\CurrentControlSet\Control\Print\Environment +

will reveal that Windows NT always uses the NT driver + name. The is ok as Windows NT always requires that at least + the Windows NT version of the printer driver is present. + However, Samba does not have the requirement internally. + Therefore, how can you use the NT driver name if is has not + already been installed?

The way of sidestepping this limitation is to require + that all Imprints printer driver packages include both the Intel + Windows NT and 95/98 printer drivers and that NT driver is + installed first.

Migration to from Samba 2.0.x to + 2.2.x

Given that printer driver management has changed + (we hope improved :) ) in 2.2.0 over prior releases, + migration from an existing setup to 2.2.0 can follow + several paths.

Warning

The following smb.conf parameters are considered to be + depreciated and will be removed soon. Do not use them + in new installations

printer driver file (G) +
printer driver (S) +
printer driver location (S) +

Here are the possible scenarios for supporting migration:

If you do not desire the new Windows NT + print driver support, nothing needs to be done. + All existing parameters work the same.
If you want to take advantage of NT printer + driver support but do not want to migrate the + 9x drivers to the new setup, the leave the existing + printers.def file. When smbd attempts to locate a + 9x driver for the printer in the TDB and fails it + will drop down to using the printers.def (and all + associated parameters). The make_printerdef + tool will also remain for backwards compatibility but will + be moved to the "this tool is the old way of doing it" + pile.
If you install a Windows 9x driver for a printer + on your Samba host (in the printing TDB), this information will + take precedence and the three old printing parameters + will be ignored (including print driver location).
If you want to migrate an existing printers.def file into the new setup, the current only + solution is to use the Windows NT APW to install the NT drivers + and the 9x drivers. This can be scripted using smbclient and + rpcclient. See the Imprints installation client for an example. +

Chapter 5. security = domain in Samba 2.x

Joining an NT Domain with Samba 2.2

In order for a Samba-2 server to join an NT domain, + you must first add the NetBIOS name of the Samba server to the + NT domain on the PDC using Server Manager for Domains. This creates + the machine account in the domain (PDC) SAM. Note that you should + add the Samba server as a "Windows NT Workstation or Server", + NOT as a Primary or backup domain controller.

Assume you have a Samba-2 server with a NetBIOS name of + SERV1 and are joining an NT domain called + DOM, which has a PDC with a NetBIOS name + of DOMPDC and two backup domain controllers + with NetBIOS names DOMBDC1 and DOMBDC2 +.

In order to join the domain, first stop all Samba daemons + and run the command:

root# smbpasswd -j DOM -r DOMPDC +

as we are joining the domain DOM and the PDC for that domain + (the only machine that has write access to the domain SAM database) + is DOMPDC. If this is successful you will see the message:

smbpasswd: Joined domain DOM. +

in your terminal window. See the smbpasswd(8) man page for more details.

This command goes through the machine account password + change protocol, then writes the new (random) machine account + password for this Samba server into a file in the same directory + in which an smbpasswd file would be stored - normally :

/usr/local/samba/private

In Samba 2.0.x, the filename looks like this:

<NT DOMAIN NAME>.<Samba + Server Name>.mac

The .mac suffix stands for machine account + password file. So in our example above, the file would be called:

DOM.SERV1.mac

In Samba 2.2, this file has been replaced with a TDB + (Trivial Database) file named secrets.tdb. +

This file is created and owned by root and is not + readable by any other user. It is the key to the domain-level + security for your system, and should be treated as carefully + as a shadow password file.

Now, before restarting the Samba daemons you must + edit your smb.conf(5) + file to tell Samba it should now use domain security.

Change (or add) your security = line in the [global] section + of your smb.conf to read:

security = domain

Next change the workgroup = line in the [global] section to read:

workgroup = DOM

as this is the name of the domain we are joining.

You must also have the parameter encrypt passwords set to yes + in order for your users to authenticate to the NT PDC.

Finally, add (or modify) a password server = line in the [global] + section to read:

password server = DOMPDC DOMBDC1 DOMBDC2

These are the primary and backup domain controllers Samba + will attempt to contact in order to authenticate users. Samba will + try to contact each of these servers in order, so you may want to + rearrange this list in order to spread out the authentication load + among domain controllers.

Alternatively, if you want smbd to automatically determine + the list of Domain controllers to use for authentication, you may + set this line to be :

password server = *

This method, which was introduced in Samba 2.0.6, + allows Samba to use exactly the same mechanism that NT does. This + method either broadcasts or uses a WINS database in order to + find domain controllers to authenticate against.

Finally, restart your Samba daemons and get ready for + clients to begin using domain security!

Samba and Windows 2000 Domains

Why is this better than security = server?

Currently, domain security in Samba doesn't free you from + having to create local Unix users to represent the users attaching + to your server. This means that if domain user DOM\fred + attaches to your domain security Samba server, there needs + to be a local Unix user fred to represent that user in the Unix + filesystem. This is very similar to the older Samba security mode + security = server, + where Samba would pass through the authentication request to a Windows + NT server in the same way as a Windows 95 or Windows 98 server would. +

The advantage to domain-level security is that the + authentication in domain-level security is passed down the authenticated + RPC channel in exactly the same way that an NT server would do it. This + means Samba servers now participate in domain trust relationships in + exactly the same way NT servers do (i.e., you can add Samba servers into + a resource domain and have the authentication passed on from a resource + domain PDC to an account domain PDC.

In addition, with security = server every Samba + daemon on a server has to keep a connection open to the + authenticating server for as long as that daemon lasts. This can drain + the connection resources on a Microsoft NT server and cause it to run + out of available connections. With security = domain, + however, the Samba daemons connect to the PDC/BDC only for as long + as is necessary to authenticate the user, and then drop the connection, + thus conserving PDC connection resources.

And finally, acting in the same manner as an NT server + authenticating to a PDC means that as part of the authentication + reply, the Samba server gets the user identification information such + as the user SID, the list of NT groups the user belongs to, etc. All + this information will allow Samba to be extended in the future into + a mode the developers currently call appliance mode. In this mode, + no local Unix users will be necessary, and Samba will generate Unix + uids and gids from the information passed back from the PDC when a + user is authenticated, making a Samba server truly plug and play + in an NT domain environment. Watch for this code soon.

NOTE: Much of the text of this document + was first published in the Web magazine + LinuxWorld as the article Doing + the NIS/NT Samba.

Chapter 6. How to Configure Samba 2.2.x as a Primary Domain Controller

Background

Author's Note : This document +is a combination of David Bannon's Samba 2.2 PDC HOWTO +and the Samba NT Domain FAQ. Both documents are superceeded by this one.

Version of Samba prior to release 2.2 had marginal capabilities to +act as a Windows NT 4.0 Primary Domain Controller (PDC). The following +functionality should work in 2.2.0:

domain logons for Windows NT 4.0/2000 clients
placing a Windows 9x client in user level security
retrieving a list of users and groups from a Samba PDC to + Windows 9x/NT/2000 clients
roving user profiles
Windows NT 4.0 style system policies

The following pieces of functionality are not included in the 2.2 release:

Windows NT 4 domain trusts
Sam replication with Windows NT 4.0 Domain Controllers + (i.e. a Samba PDC and a Windows NT BDC or vice versa)
Adding users via the User Manager for Domains
Acting as a Windows 2000 Domain Controller (i.e. Kerberos + and Active Directory)

Please note that Windows 9x clients are not true members of a domain +for reasons outlined in this article. Therefore the protocol for +support Windows 9x style domain logons is completely different +from NT4 domain logons and has been officially supported for some +time.

Beginning with Samba 2.2.0, we are proud to announce official +support for Windows NT 4.0 style domain logons from Windows NT +4.0 and Windows 2000 (including SP1) clients. This article +outlines the steps necessary for configuring Samba as a PDC. +Note that it is necessary to have a working Samba server +prior to implementing the PDC functionality. If you have not +followed the steps outlined in UNIX_INSTALL.html, please make sure that your server +is configured correctly before proceeding. Another good +resource in the smb.conf(5) man +page.

Implementing a Samba PDC can basically be divided into 2 broad +steps.

Configuring the Samba Domain Controller +
Creating machine trust accounts + and joining clients to the domain

There are other minor details such as user profiles, system +policies, etc... However, these are not necessarily specific +to a Samba PDC as much as they are related to Windows NT networking +concepts. They will be mentioned only briefly here.

Configuring the Samba Domain Controller

The first step in creating a working Samba PDC is to +understand the parameters necessary in smb.conf. I will not +attempt to re-explain the parameters here as they are more that +adequately covered in the smb.conf +man page. For convenience, the parameters have been +linked with the actual smb.conf description.

Here is an example smb.conf for acting as a PDC:

[global]
+    ; Basic server settings
+    netbios name = POGO
+    workgroup = NARNIA
+
+    ; we should act as the domain and local master browser
+    os level = 64
+    preferred master = yes
+    domain master = yes
+    local master = yes
+    
+    ; security settings (must user security = user)
+    security = user
+    
+    ; encrypted passwords are a requirement for a PDC
+    encrypt passwords = yes
+    
+    ; support domain logons
+    domain logons = yes
+    
+    ; where to store user profiles?
+    logon path = \\%N\profiles\%u
+    
+    ; where is a user's home directory and where should it
+    ; be mounted at?
+    logon drive = H:
+    logon home = \\homeserver\%u
+    
+    ; specify a generic logon script for all users
+    ; this is a relative path to the [netlogon] share
+    logon script = logon.cmd
+
+; necessary share for domain controller
+[netlogon]
+    path = /usr/local/samba/lib/netlogon
+    writeable = no
+    write list = ntadmin
+    
+; share for storing user profiles
+[profiles]
+    path = /export/smb/ntprofile
+    writeable = yes
+    create mask = 0600
+    directory mask = 0700

There are a couple of points to emphasize in the above +configuration.

encrypted passwords must be enabled. + For more details on how to do this, refer to + ENCRYPTION.html. +
The server must support domain logons + and a [netlogon] share
The server must be the domain master browser + in order for Windows client to locate the server as a DC.

As Samba 2.2 does not offer a complete implementation of group mapping between +Windows NT groups and UNIX groups (this is really quite complicated to explain +in a short space), you should refer to the domain +admin users and domain +admin group smb.conf parameters for information of creating a Domain Admins +style accounts.

Creating Machine Trust Accounts and Joining Clients +to the Domain

First you must understand what a machine trust account is and what +it is used for.

A machine trust account is a user account owned by a computer. +The account password acts as the shared secret for secure +communication with the Domain Controller. Hence the reason that +a Windows 9x host is never a true member of a domain because +it does not posses a machine trust account and thus has no shared +secret with the DC.

On a Windows NT PDC, these machine trust account passwords are stored +in the registry. A Samba PDC stores these accounts in he same location +as user LanMan and NT password hashes (currently smbpasswd). +However, machine trust accounts only possess the NT password hash.

There are two means of creating machine trust accounts.

Manual creation before joining the client + to the domain. In this case, the password is set to a known + value -- the lower case of the machine's netbios name.
Creation of the account at the time of + joining the domain. In this case, the session key of the + administrative account used to join the client to the domain acts + as an encryption key for setting the password to a random value.

Because Samba requires machine accounts to possess a UNIX uid from +which an Windows NT SID can be generated, all of these accounts +will have an entry in /etc/passwd and smbpasswd. +Future releases will alleviate the need to create +/etc/passwd entries.

The /etc/passwd entry will list the machine name +with a $ appended, won't have a passwd, will have a null shell and no +home directory. For example a machine called 'doppy' would have an +/etc/passwd entry like this :

doppy$:x:505:501:NTMachine:/dev/null:/bin/false

If you are manually creating the machine accounts, it is necessary +to add the /etc/passwd (or NIS passwd +map) entry prior to adding the smbpasswd +entry. The following command will create a new machine account +ready for use.

root# smbpasswd -a -m machine_name

where machine_name is the machine's netbios +name.

If you manually create a machine account, immediately join +the client to the domain. An open account like this +can allow intruders to gain access to user account information +in your domain.

The second way of creating machine trust accounts is to add +them on the fly at the time the client is joined to the domain. +You will need to include a value for the +add user script +parameter. Below is an example I use on a RedHat 6.2 Linux system.

add user script = /usr/sbin/useradd -d /dev/null -g 100 -s /bin/false -M %u

In Samba 2.2.0, only the root account can be used to create +machine accounts on the fly like this. Therefore, it is required +to create an entry in smbpasswd for root. +The password SHOULD be set to s different +password that the associated /etc/passwd +entry for security reasons.

Common Problems and Errors

I cannot include a '$' in a machine name.

A 'machine name' in (typically) /etc/passwd +of the machine name with a '$' appended. FreeBSD (and other BSD +systems ?) won't create a user with a '$' in their name.

The problem is only in the program used to make the entry, once +made, it works perfectly. So create a user without the '$' and +use vipw to edit the entry, adding the '$'. Or create +the whole entry with vipw if you like, make sure you use a +unique uid !

I get told "You already have a connection to the Domain...." +when creating a machine account.

This happens if you try to create a machine account from the +machine itself and use a user name that does not work (for whatever +reason) and then try another (possibly valid) user name. +Exit out of the network applet to close the initial connection +and try again.

Further, if the machine is a already a 'member of a workgroup' that +is the same name as the domain you are joining (bad idea) you will +get this message. Change the workgroup name to something else, it +does not matter what, reboot, and try again.

I get told "Cannot join domain, the credentials supplied +conflict with an existing set.."

This is the same basic problem as mentioned above, "You already +have a connection..."

"The system can not log you on (C000019B)...."

I joined the domain successfully but after upgrading +to a newer version of the Samba code I get the message, "The system +can not log you on (C000019B), Please try a gain or consult your +system administrator" when attempting to logon.

This occurs when the domain SID stored in +private/WORKGROUP.SID is +changed. For example, you remove the file and smbd automatically +creates a new one. Or you are swapping back and forth between +versions 2.0.7, TNG and the HEAD branch code (not recommended). The +only way to correct the problem is to restore the original domain +SID or remove the domain client from the domain and rejoin.

"The machine account for this computer either does not +exist or is not accessible."

When I try to join the domain I get the message "The machine account +for this computer either does not exist or is not accessible". Whats +wrong ?

This problem is caused by the PDC not having a suitable machine account. +If you are using the add user script = method to create +accounts then this would indicate that it has not worked. Ensure the domain +admin user system is working.

Alternatively if you are creating account entries manually then they +have not been created correctly. Make sure that you have the entry +correct for the machine account in smbpasswd file on the Samba PDC. +If you added the account using an editor rather than using the smbpasswd +utility, make sure that the account name is the machine netbios name +with a '$' appended to it ( ie. computer_name$ ). There must be an entry +in both /etc/passwd and the smbpasswd file. Some people have reported +that inconsistent subnet masks between the Samba server and the NT +client have caused this problem. Make sure that these are consistent +for both client and server.

System Policies and Profiles

Much of the information necessary to implement System Policies and +Roving User Profiles in a Samba domain is the same as that for +implementing these same items in a Windows NT 4.0 domain. +You should read the white paper Implementing +Profiles and Policies in Windows NT 4.0 available from Microsoft.

Here are some additional details:

What about Windows NT Policy Editor ?

To create or edit ntconfig.pol you must use +the NT Server Policy Editor, poledit.exe which +is included with NT Server but not NT Workstation. +There is a Policy Editor on a NTws +but it is not suitable for creating Domain Policies. +Further, although the Windows 95 +Policy Editor can be installed on an NT Workstation/Server, it will not +work with NT policies because the registry key that are set by the policy templates. +However, the files from the NT Server will run happily enough on an NTws. +You need poledit.exe, common.adm and winnt.adm. It is convenient +to put the two *.adm files in c:\winnt\inf which is where +the binary will look for them unless told otherwise. Note also that that +directory is 'hidden'.

The Windows NT policy editor is also included with the +Service Pack 3 (and later) for Windows NT 4.0. Extract the files using +servicepackname /x, ie thats Nt4sp6ai.exe +/x for service pack 6a. The policy editor, poledit.exe and the +associated template files (*.adm) should +be extracted as well. It is also possible to downloaded the policy template +files for Office97 and get a copy of the policy editor. Another possible +location is with the Zero Administration Kit available for download from Microsoft.

Can Win95 do Policies ?

Install the group policy handler for Win9x to pick up group +policies. Look on the Win98 CD in \tools\reskit\netadmin\poledit. +Install group policies on a Win9x client by double-clicking +grouppol.inf. Log off and on again a couple of +times and see if Win98 picks up group policies. Unfortunately this needs +to be done on every Win9x machine that uses group policies....

If group policies don't work one reports suggests getting the updated +(read: working) grouppol.dll for Windows 9x. The group list is grabbed +from /etc/group.

How do I get 'User Manager' and 'Server Manager'

Since I don't need to buy an NT Server CD now, how do I get +the 'User Manager for Domains', the 'Server Manager' ?

Microsoft distributes a version of +these tools called nexus for installation on Windows 95 systems. The +tools set includes

Server Manager
User Manager for Domains
Event Viewer

Click here to download the archived file ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE

The Windows NT 4.0 version of the 'User Manager for +Domains' and 'Server Manager' are available from Microsoft via ftp +from ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE

What other help can I get ?

What are some diagnostics tools I can use to debug the domain logon +process and where can I find them?

Another helpful method of debugging is to compile samba using the + gcc -g flag. This will include debug + information in the binaries and allow you to attach gdb to the + running smbd / nmbd process. In order to attach gdb to an smbd + process for an NT workstation, first get the workstation to make the + connection. Pressing ctrl-alt-delete and going down to the domain box + is sufficient (at least, on the first time you join the domain) to + generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation + maintains an open connection, and therefore there will be an smbd + process running (assuming that you haven't set a really short smbd + idle timeout) So, in between pressing ctrl alt delete, and actually + typing in your password, you can gdb attach and continue. +

Some useful samba commands worth investigating: +

testparam | more
smbclient -L //{netbios name of server}

An SMB enabled version of tcpdump is available from + http://www.tcpdup.org/. + Ethereal, another good packet sniffer for UNIX and Win32 + hosts, can be downloaded from http://www.ethereal.com. +

For tracing things on the Microsoft Windows NT, Network Monitor + (aka. netmon) is available on the Microsoft Developer Network CD's, + the Windows NT Server install CD and the SMS CD's. The version of + netmon that ships with SMS allows for dumping packets between any two + computers (ie. placing the network interface in promiscuous mode). + The version on the NT Server install CD will only allow monitoring + of network traffic directed to the local NT box and broadcasts on the + local subnet. Be aware that Ethereal can read and write netmon + formatted files. +

How do I install 'Network Monitor' on an NT Workstation +or a Windows 9x box?

Initially you will need to install 'Network Monitor Tools and Agent' + on the NT Server. To do this +

Goto Start - Settings - Control Panel - + Network - Services - Add
Select the 'Network Monitor Tools and Agent' and + click on 'OK'.
Click 'OK' on the Network Control Panel. +
Insert the Windows NT Server 4.0 install CD + when prompted.

At this point the Netmon files should exist in + %SYSTEMROOT%\System32\netmon\*.*. + Two subdirectories exist as well, parsers\ + which contains the necessary DLL's for parsing the netmon packet + dump, and captures\. +

In order to install the Netmon tools on an NT Workstation, you will + first need to install the 'Network Monitor Agent' from the Workstation + install CD. +

Goto Start - Settings - Control Panel - + Network - Services - Add
Select the 'Network Monitor Agent' and click + on 'OK'.
Click 'OK' on the Network Control Panel. +
Insert the Windows NT Workstation 4.0 install + CD when prompted.

Now copy the files from the NT Server in %SYSTEMROOT%\System32\netmon\*.* + to %SYSTEMROOT%\System32\netmon\*.* on the Workstation and set + permissions as you deem appropriate for your site. You will need + administrative rights on the NT box to run netmon. +

To install Netmon on a Windows 9x box install the network monitor agent + from the Windows 9x CD (\admin\nettools\netmon). There is a readme + file located with the netmon driver files on the CD if you need + information on how to do this. Copy the files from a working + Netmon installation. +

URLs and similar

Home of Samba site http://samba.org. We have a mirror near you !
The Development document + on the Samba mirrors might mention your problem. If so, + it might mean that the developers are working on it.
See how Scott Merrill simulates a BDC behavior at + http://www.skippy.net/linux/smb-howto.html.
Although 2.0.7 has almost had its day as a PDC, David Bannon will + keep the 2.0.7 PDC pages at http://bioserve.latrobe.edu.au/samba going for a while yet.
Misc links to CIFS information + http://samba.org/cifs/
NT Domains for Unix http://mailhost.cb1.com/~lkcl/ntdom/
FTP site for older SMB specs: + ftp://ftp.microsoft.com/developr/drg/CIFS/

Mailing Lists

How do I get help from the mailing lists ?

There are a number of Samba related mailing lists. Go to http://samba.org, click on your nearest mirror +and then click on Support and then click on Samba related mailing lists.

For questions relating to Samba TNG go to +http://www.samba-tng.org/ +It has been requested that you don't post questions about Samba-TNG to the +main stream Samba lists.

If you post a message to one of the lists please observe the following guide lines :

Always remember that the developers are volunteers, they are + not paid and they never guarantee to produce a particular feature at + a particular time. Any time lines are 'best guess' and nothing more. +
Always mention what version of samba you are using and what + operating system its running under. You should probably list the + relevant sections of your smb.conf file, at least the options + in [global] that affect PDC support.
In addition to the version, if you obtained Samba via + CVS mention the date when you last checked it out.
Try and make your question clear and brief, lots of long, + convoluted questions get deleted before they are completely read ! + Don't post html encoded messages (if you can select colour or font + size its html).
If you run one of those nifty 'I'm on holidays' things when + you are away, make sure its configured to not answer mailing lists. +
Don't cross post. Work out which is the best list to post to + and see what happens, ie don't post to both samba-ntdom and samba-technical. + Many people active on the lists subscribe to more + than one list and get annoyed to see the same message two or more times. + Often someone will see a message and thinking it would be better dealt + with on another, will forward it on for you.
You might include partial + log files written at a debug level set to as much as 20. + Please don't send the entire log but enough to give the context of the + error messages.
(Possibly) If you have a complete netmon trace ( from the opening of + the pipe to the error ) you can send the *.CAP file as well.
Please think carefully before attaching a document to an email. + Consider pasting the relevant parts into the body of the message. The samba + mailing lists go to a huge number of people, do they all need a copy of your + smb.conf in their attach directory ?

How do I get off the mailing lists ?

To have your name removed from a samba mailing list, go to the + same place you went to to get on it. Go to http://lists.samba.org, click + on your nearest mirror and then click on Support and + then click on Samba related mailing lists. Or perhaps see + here

Please don't post messages to the list asking to be removed, you will just + be referred to the above address (unless that process failed in some way...) +

DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba

This appendix was originally authored by John H Terpstra of the Samba Team +and is included here for posterity.

NOTE : +The term "Domain Controller" and those related to it refer to one specific +method of authentication that can underly an SMB domain. Domain Controllers +prior to Windows NT Server 3.1 were sold by various companies and based on +private extensions to the LAN Manager 2.1 protocol. Windows NT introduced +Microsoft-specific ways of distributing the user authentication database. +See DOMAIN.txt for examples of how Samba can participate in or create +SMB domains based on shared authentication database schemes other than the +Windows NT SAM.

Windows NT Server can be installed as either a plain file and print server +(WORKGROUP workstation or server) or as a server that participates in Domain +Control (DOMAIN member, Primary Domain controller or Backup Domain controller).

The same is true for OS/2 Warp Server, Digital Pathworks and other similar +products, all of which can participate in Domain Control along with Windows NT. +However only those servers which have licensed Windows NT code in them can be +a primary Domain Controller (eg Windows NT Server, Advanced Server for Unix.)

To many people these terms can be confusing, so let's try to clear the air.

Every Windows NT system (workstation or server) has a registry database. +The registry contains entries that describe the initialization information +for all services (the equivalent of Unix Daemons) that run within the Windows +NT environment. The registry also contains entries that tell application +software where to find dynamically loadable libraries that they depend upon. +In fact, the registry contains entries that describes everything that anything +may need to know to interact with the rest of the system.

The registry files can be located on any Windows NT machine by opening a +command prompt and typing:

C:\WINNT\> dir %SystemRoot%\System32\config

The environment variable %SystemRoot% value can be obtained by typing:

C:\WINNT>echo %SystemRoot%

The active parts of the registry that you may want to be familiar with are +the files called: default, system, software, sam and security.

In a domain environment, Microsoft Windows NT domain controllers participate +in replication of the SAM and SECURITY files so that all controllers within +the domain have an exactly identical copy of each.

The Microsoft Windows NT system is structured within a security model that +says that all applications and services must authenticate themselves before +they can obtain permission from the security manager to do what they set out +to do.

The Windows NT User database also resides within the registry. This part of +the registry contains the user's security identifier, home directory, group +memberships, desktop profile, and so on.

Every Windows NT system (workstation as well as server) will have its own +registry. Windows NT Servers that participate in Domain Security control +have a database that they share in common - thus they do NOT own an +independent full registry database of their own, as do Workstations and +plain Servers.

The User database is called the SAM (Security Access Manager) database and +is used for all user authentication as well as for authentication of inter- +process authentication (ie: to ensure that the service action a user has +requested is permitted within the limits of that user's privileges).

The Samba team have produced a utility that can dump the Windows NT SAM into +smbpasswd format: see ENCRYPTION.txt for information on smbpasswd and +/pub/samba/pwdump on your nearest Samba mirror for the utility. This +facility is useful but cannot be easily used to implement SAM replication +to Samba systems.

Windows for Workgroups, Windows 95, and Windows NT Workstations and Servers +can participate in a Domain security system that is controlled by Windows NT +servers that have been correctly configured. At most every domain will have +ONE Primary Domain Controller (PDC). It is desirable that each domain will +have at least one Backup Domain Controller (BDC).

The PDC and BDCs then participate in replication of the SAM database so that +each Domain Controlling participant will have an up to date SAM component +within its registry.

Chapter 7. Unifed Logons between Windows NT and UNIX using Winbind

Abstract

Integration of UNIX and Microsoft Windows NT through + a unified logon has been considered a "holy grail" in heterogeneous + computing environments for a long time. We present winbind + , a component of the Samba suite of programs as a + solution to the unied logon problem. Winbind uses a UNIX implementation + of Microsoft RPC calls, Pluggable Authentication Modules, and the Name + Service Switch to allow Windows NT domain users to appear and operate + as UNIX users on a UNIX machine. This paper describes the winbind + system, explaining the functionality it provides, how it is configured, + and how it works internally.

Introduction

It is well known that UNIX and Microsoft Windows NT have + different models for representing user and group information and + use different technologies for implementing them. This fact has + made it difficult to integrate the two systems in a satisfactory + manner.

One common solution in use today has been to create + identically named user accounts on both the UNIX and Windows systems + and use the Samba suite of programs to provide file and print services + between the two. This solution is far from perfect however, as + adding and deleting users on both sets of machines becomes a chore + and two sets of passwords are required both of which which + can lead to synchronization problems between the UNIX and Windows + systems and confusion for users.

We divide the unifed logon problem for UNIX machines into + three smaller problems:

Obtaining Windows NT user and group information +
Authenticating Windows NT users +
Password changing for Windows NT users +

Ideally, a prospective solution to the unified logon problem + would satisfy all the above components without duplication of + information on the UNIX machines and without creating additional + tasks for the system administrator when maintaining users and + groups on either system. The winbind system provides a simple + and elegant solution to all three components of the unifed logon + problem.

What Winbind Provides

Winbind unifies UNIX and Windows NT account management by + allowing a UNIX box to become a full member of a NT domain. Once + this is done the UNIX box will see NT users and groups as if + they were native UNIX users and groups, allowing the NT domain + to be used in much the same manner that NIS+ is used within + UNIX-only environments.

The end result is that whenever any + program on the UNIX machine asks the operating system to lookup + a user or group name, the query will be resolved by asking the + NT domain controller for the specied domain to do the lookup. + Because Winbind hooks into the operating system at a low level + (via the NSS name resolution modules in the C library) this + redirection to the NT domain controller is completely + transparent.

Users on the UNIX machine can then use NT user and group + names as they would use "native" UNIX names. They can chown files + so that they are owned by NT domain users or even login to the + UNIX machine and run a UNIX X-Window session as a domain user.

The only obvious indication that Winbind is being used is + that user and group names take the form DOMAIN\user and + DOMAIN\group. This is necessary as it allows Winbind to determine + that redirection to a domain controller is wanted for a particular + lookup and which trusted domain is being referenced.

Additionally, Winbind provides a authentication service + that hooks into the Pluggable Authentication Modules (PAM) system + to provide authentication via a NT domain to any PAM enabled + applications. This capability solves the problem of synchronizing + passwords between systems as all passwords are stored in a single + location (on the domain controller).

Target Uses

Winbind is targeted at organizations that have an + existing NT based domain infrastructure into which they wish + to put UNIX workstations or servers. Winbind will allow these + organizations to deploy UNIX workstations without having to + maintain a separate account infrastructure. This greatly simplies + the administrative overhead of deploying UNIX workstations into + a NT based organization.

Another interesting way in which we expect Winbind to + be used is as a central part of UNIX based appliances. Appliances + that provide file and print services to Microsoft based networks + will be able to use Winbind to provide seamless integration of + the appliance into the domain.

How Winbind Works

The winbind system is designed around a client/server + architecture. A long running winbindd daemon + listens on a UNIX domain socket waiting for requests + to arrive. These requests are generated by the NSS and PAM + clients and processed sequentially.

The technologies used to implement winbind are described + in detail below.

Microsoft Remote Procedure Calls

Over the last two years, efforts have been underway + by various Samba Team members to decode various aspects of + the Microsoft Remote Procedure Call (MSRPC) system. This + system is used for most network related operations between + Windows NT machines including remote management, user authentication + and print spooling. Although initially this work was done + to aid the implementation of Primary Domain Controller (PDC) + functionality in Samba, it has also yielded a body of code which + can be used for other purposes.

Winbind uses various MSRPC calls to enumerate domain users + and groups and to obtain detailed information about individual + users or groups. Other MSRPC calls can be used to authenticate + NT domain users and to change user passwords. By directly querying + a Windows PDC for user and group information, winbind maps the + NT account information onto UNIX user and group names.

Name Service Switch

The Name Service Switch, or NSS, is a feature that is + present in many UNIX operating systems. It allows system + information such as hostnames, mail aliases and user information + to be resolved from dierent sources. For example, a standalone + UNIX workstation may resolve system information from a series of + flat files stored on the local lesystem. A networked workstation + may first attempt to resolve system information from local files, + then consult a NIS database for user information or a DNS server + for hostname information.

The NSS application programming interface allows winbind + to present itself as a source of system information when + resolving UNIX usernames and groups. Winbind uses this interface, + and information obtained from a Windows NT server using MSRPC + calls to provide a new source of account enumeration. Using standard + UNIX library calls, one can enumerate the users and groups on + a UNIX machine running winbind and see all users and groups in + a NT domain plus any trusted domain as though they were local + users and groups.

The primary control le for NSS is /etc/nsswitch.conf +. When a UNIX application makes a request to do a lookup + the C library looks in /etc/nsswitch.conf + for a line which matches the service type being requested, for + example the "passwd" service type is used when user or group names + are looked up. This config line species which implementations + of that service should be tried andin what order. If the passwd + config line is:

passwd: files example

then the C library will first load a module called + /lib/libnss_files.so followed by + the module /lib/libnss_example.so. The + C library will dynamically load each of these modules in turn + and call resolver functions within the modules to try to resolve + the request. Once the request is resolved the C library returns the + result to the application.

This NSS interface provides a very easy way for Winbind + to hook into the operating system. All that needs to be done + is to put libnss_winbind.so in /lib/ + then add "winbind" into /etc/nsswitch.conf at + the appropriate place. The C library will then call Winbind to + resolve user and group names.

Pluggable Authentication Modules

Pluggable Authentication Modules, also known as PAM, + is a system for abstracting authentication and authorization + technologies. With a PAM module it is possible to specify different + authentication methods for dierent system applications without + having to recompile these applications. PAM is also useful + for implementing a particular policy for authorization. For example, + a system administrator may only allow console logins from users + stored in the local password file but only allow users resolved from + a NIS database to log in over the network.

Winbind uses the authentication management and password + management PAM interface to integrate Windows NT users into a + UNIX system. This allows Windows NT users to log in to a UNIX + machine and be authenticated against a suitable Primary Domain + Controller. These users can also change their passwords and have + this change take eect directly on the Primary Domain Controller. +

PAM is congured by providing control files in the directory + /etc/pam.d/ for each of the services that + require authentication. When an authentication request is made + by an application the PAM code in the C library looks up this + control file to determine what modules to load to do the + authentication check and in what order. This interface makes adding + a new authentication service for Winbind very easy, all that needs + to be done is that the pam_winbind.so module + is copied to /lib/security/ and the pam + control files for relevant services are updated to allow + authentication via winbind. See the PAM documentation + for more details.

User and Group ID Allocation

When a user or group is created under Windows NT + is it allocated a numerical relative identier (RID). This is + slightly dierent to UNIX which has a range of numbers which are + used to identify users, and the same range in which to identify + groups. It is winbind's job to convert RIDs to UNIX id numbers and + vice versa. When winbind is congured it is given part of the UNIX + user id space and a part of the UNIX group id space in which to + store Windows NT users and groups. If a Windows NT user is + resolved for the first time, it is allocated the next UNIX id from + the range. The same process applies for Windows NT groups. Over + time, winbind will have mapped all Windows NT users and groups + to UNIX user ids and group ids.

The results of this mapping are stored persistently in + a ID mapping database held in a tdb database). This ensures that + RIDs are mapped to UNIX IDs in a consistent way.

Result Caching

An active system can generate a lot of user and group + name lookups. To reduce the network cost of these lookups winbind + uses a caching scheme based on the SAM sequence number supplied + by NT domain controllers. User or group information returned + by a PDC is cached by winbind along with a sequence number also + returned by the PDC. This sequence number is incremented by + Windows NT whenever any user or group information is modied. If + a cached entry has expired, the sequence number is requested from + the PDC and compared against the sequence number of the cached entry. + If the sequence numbers do not match, then the cached information + is discarded and up to date information is requested directly + from the PDC.

Installation and Configuration

The easiest way to install winbind is by using the packages + provided in the pub/samba/appliance/ + directory on your nearest + Samba mirror. These packages provide snapshots of the Samba source + code and binaries already setup to provide the full functionality + of winbind. This setup is a little more complex than a normal Samba + build as winbind needs a small amount of functionality from a + development code branch called SAMBA_TNG.

Once you have installed the packages you should read + the winbindd(8) man page which will provide you + with conguration information and give you sample conguration files. + You may also wish to update the main Samba daemons smbd and nmbd) + with a more recent development release, such as the recently + announced Samba 2.2 alpha release.

Limitations

Winbind has a number of limitations in its current + released version which we hope to overcome in future + releases:

Winbind is currently only available for + the Linux operating system, although ports to other operating + systems are certainly possible. For such ports to be feasible, + we require the C library of the target operating system to + support the Name Service Switch and Pluggable Authentication + Modules systems. This is becoming more common as NSS and + PAM gain support among UNIX vendors.
The mappings of Windows NT RIDs to UNIX ids + is not made algorithmically and depends on the order in which + unmapped users or groups are seen by winbind. It may be difficult + to recover the mappings of rid to UNIX id mapping if the file + containing this information is corrupted or destroyed.
Currently the winbind PAM module does not take + into account possible workstation and logon time restrictions + that may be been set for Windows NT users.
Building winbind from source is currently + quite tedious as it requires combining source code from two Samba + branches. Work is underway to solve this by providing all + the necessary functionality in the main Samba code branch.

Conclusion

The winbind system, through the use of the Name Service + Switch, Pluggable Authentication Modules, and appropriate + Microsoft RPC calls have allowed us to provide seamless + integration of Microsoft Windows NT domain users on a + UNIX system. The result is a great reduction in the administrative + cost of running a mixed UNIX and NT network.

Chapter 8. UNIX Permission Bits and WIndows NT Access Control Lists

Viewing and changing UNIX permissions using the NT + security dialogs

New in the Samba 2.0.4 release is the ability for Windows + NT clients to use their native security settings dialog box to + view and modify the underlying UNIX permissions.

Note that this ability is careful not to compromise + the security of the UNIX host Samba is running on, and + still obeys all the file permission rules that a Samba + administrator can set.

In Samba 2.0.4 and above the default value of the + parameter nt acl support has been changed from + false to true, so + manipulation of permissions is turned on by default.

How to view file security on a Samba share

From an NT 4.0 client, single-click with the right + mouse button on any file or directory in a Samba mounted + drive letter or UNC path. When the menu pops-up, click + on the Properties entry at the bottom of + the menu. This brings up the normal file properties dialog + box, but with Samba 2.0.4 this will have a new tab along the top + marked Security. Click on this tab and you + will see three buttons, Permissions, + Auditing, and Ownership. + The Auditing button will cause either + an error message A requested privilege is not held + by the client to appear if the user is not the + NT Administrator, or a dialog which is intended to allow an + Administrator to add auditing requirements to a file if the + user is logged on as the NT Administrator. This dialog is + non-functional with a Samba share at this time, as the only + useful button, the Add button will not currently + allow a list of users to be seen.

Viewing file ownership

Clicking on the "Ownership" button + brings up a dialog box telling you who owns the given file. The + owner name will be of the form :

"SERVER\user (Long name)"

Where SERVER is the NetBIOS name of + the Samba server, user is the user name of + the UNIX user who owns the file, and (Long name) + is the discriptive string identifying the user (normally found in the + GECOS field of the UNIX password database). Click on the Close + button to remove this dialog.

If the parameter nt acl support + is set to false then the file owner will + be shown as the NT user "Everyone".

The Take Ownership button will not allow + you to change the ownership of this file to yourself (clicking on + it will display a dialog box complaining that the user you are + currently logged onto the NT client cannot be found). The reason + for this is that changing the ownership of a file is a privilaged + operation in UNIX, available only to the root + user. As clicking on this button causes NT to attempt to change + the ownership of a file to the current user logged into the NT + client this will not work with Samba at this time.

There is an NT chown command that will work with Samba + and allow a user with Administrator privillage connected + to a Samba 2.0.4 server as root to change the ownership of + files on both a local NTFS filesystem or remote mounted NTFS + or Samba drive. This is available as part of the Seclib + NT security library written by Jeremy Allison of + the Samba Team, available from the main Samba ftp site.

Viewing file or directory permissions

The third button is the "Permissions" + button. Clicking on this brings up a dialog box that shows both + the permissions and the UNIX owner of the file or directory. + The owner is displayed in the form :

"SERVER\user (Long name)"

If the parameter nt acl support + is set to false then the file owner will + be shown as the NT user "Everyone" and the + permissions will be shown as NT "Full Control".

The permissions field is displayed differently for files + and directories, so I'll describe the way file permissions + are displayed first.

File Permissions

The standard UNIX user/group/world triple and + the correspinding "read", "write", "execute" permissions + triples are mapped by Samba into a three element NT ACL + with the 'r', 'w', and 'x' bits mapped into the corresponding + NT permissions. The UNIX world permissions are mapped into + the global NT group Everyone, followed + by the list of permissions allowed for UNIX world. The UNIX + owner and group permissions are displayed as an NT + user icon and an NT local + group icon respectively followed by the list + of permissions allowed for the UNIX user and group.

As many UNIX permission sets don't map into common + NT names such as "read", "change" or "full control" then + usually the permissions will be prefixed by the words "Special Access" in the NT display list.

But what happens if the file has no permissions allowed + for a particular UNIX user group or world component ? In order + to allow "no permissions" to be seen and modified then Samba + overloads the NT "Take Ownership" ACL attribute + (which has no meaning in UNIX) and reports a component with + no permissions as having the NT "O" bit set. + This was chosen of course to make it look like a zero, meaning + zero permissions. More details on the decision behind this will + be given below.

Directory Permissions

Directories on an NT NTFS file system have two + different sets of permissions. The first set of permissions + is the ACL set on the directory itself, this is usually displayed + in the first set of parentheses in the normal "RW" + NT style. This first set of permissions is created by Samba in + exactly the same way as normal file permissions are, described + above, and is displayed in the same way.

The second set of directory permissions has no real meaning + in the UNIX permissions world and represents the "inherited" permissions that any file created within + this directory would inherit.

Samba synthesises these inherited permissions for NT by + returning as an NT ACL the UNIX permission mode that a new file + created by Samba on this share would receive.

Modifying file or directory permissions

Modifying file and directory permissions is as simple + as changing the displayed permissions in the dialog box, and + clicking the OK button. However, there are + limitations that a user needs to be aware of, and also interactions + with the standard Samba permission masks and mapping of DOS + attributes that need to also be taken into account.

If the parameter nt acl support + is set to false then any attempt to set + security permissions will fail with an "Access Denied" + message.

The first thing to note is that the "Add" + button will not return a list of users in Samba 2.0.4 (it will give + an error message of "The remote proceedure call failed + and did not execute"). This means that you can only + manipulate the current user/group/world permissions listed in + the dialog box. This actually works quite well as these are the + only permissions that UNIX actually has.

If a permission triple (either user, group, or world) + is removed from the list of permissions in the NT dialog box, + then when the "OK" button is pressed it will + be applied as "no permissions" on the UNIX side. If you then + view the permissions again the "no permissions" entry will appear + as the NT "O" flag, as described above. This + allows you to add permissions back to a file or directory once + you have removed them from a triple component.

As UNIX supports only the "r", "w" and "x" bits of + an NT ACL then if other NT security attributes such as "Delete + access" are selected then they will be ignored when applied on + the Samba server.

When setting permissions on a directory the second + set of permissions (in the second set of parentheses) is + by default applied to all files within that directory. If this + is not what you want you must uncheck the "Replace + permissions on existing files" checkbox in the NT + dialog before clicking "OK".

If you wish to remove all permissions from a + user/group/world component then you may either highlight the + component and click the "Remove" button, + or set the component to only have the special "Take + Ownership" permission (dsplayed as "O" + ) highlighted.

Interaction with the standard Samba create mask + parameters

Note that with Samba 2.0.5 there are four new parameters + to control this interaction. These are :

security mask

force security mode

directory security mask

force directory security mode

Once a user clicks "OK" to apply the + permissions Samba maps the given permissions into a user/group/world + r/w/x triple set, and then will check the changed permissions for a + file against the bits set in the + security mask parameter. Any bits that + were changed that are not set to '1' in this parameter are left alone + in the file permissions.

Essentially, zero bits in the security mask + mask may be treated as a set of bits the user is not + allowed to change, and one bits are those the user is allowed to change. +

If not set explicitly this parameter is set to the same value as + the create mask + parameter to provide compatibility with Samba 2.0.4 + where this permission change facility was introduced. To allow a user to + modify all the user/group/world permissions on a file, set this parameter + to 0777.

Next Samba checks the changed permissions for a file against + the bits set in the force security mode parameter. Any bits + that were changed that correspond to bits set to '1' in this parameter + are forced to be set.

Essentially, bits set in the force security mode + parameter may be treated as a set of bits that, when + modifying security on a file, the user has always set to be 'on'.

If not set explicitly this parameter is set to the same value + as the force + create mode parameter to provide compatibility + with Samba 2.0.4 where the permission change facility was introduced. + To allow a user to modify all the user/group/world permissions on a file, + with no restrictions set this parameter to 000.

The security mask and force + security mode parameters are applied to the change + request in that order.

For a directory Samba will perform the same operations as + described above for a file except using the parameter directory security mask instead of security + mask, and force directory security mode + parameter instead of force security mode +.

The directory security mask parameter + by default is set to the same value as the directory mask + parameter and the force directory security + mode parameter by default is set to the same value as + the force directory mode parameter to provide + compatibility with Samba 2.0.4 where the permission change facility + was introduced.

In this way Samba enforces the permission restrictions that + an administrator can set on a Samba share, whilst still allowing users + to modify the permission bits within that restriction.

If you want to set up a share that allows users full control + in modifying the permission bits on their files and directories and + doesn't force any particular bits to be set 'on', then set the following + parameters in the smb.conf(5) + file in that share specific section :

security mask = 0777

force security mode = 0

directory security mask = 0777

force directory security mode = 0

As described, in Samba 2.0.4 the parameters :

create mask

force create mode

directory mask

force directory mode

were used instead of the parameters discussed here.

Interaction with the standard Samba file attribute + mapping

Samba maps some of the DOS attribute bits (such as "read + only") into the UNIX permissions of a file. This means there can + be a conflict between the permission bits set via the security + dialog and the permission bits set by the file attribute mapping. +

One way this can show up is if a file has no UNIX read access + for the owner it will show up as "read only" in the standard + file attributes tabbed dialog. Unfortunately this dialog is + the same one that contains the security info in another tab.

What this can mean is that if the owner changes the permissions + to allow themselves read access using the security dialog, clicks + "OK" to get back to the standard attributes tab + dialog, and then clicks "OK" on that dialog, then + NT will set the file permissions back to read-only (as that is what + the attributes still say in the dialog). This means that after setting + permissions and clicking "OK" to get back to the + attributes dialog you should always hit "Cancel" + rather than "OK" to ensure that your changes + are not overridden.

Chapter 9. OS2 Client HOWTO

FAQs

How can I configure OS/2 Warp Connect or + OS/2 Warp 4 as a client for Samba?

A more complete answer to this question can be + found on http://carol.wins.uva.nl/~leeuw/samba/warp.html.

Basically, you need three components:

The File and Print Client ('IBM Peer') +
TCP/IP ('Internet support') +
The "NetBIOS over TCP/IP" driver ('TCPBEUI') +

How can I configure OS/2 Warp 3 (not Connect), + OS/2 1.2, 1.3 or 2.x for Samba?

		20=setup.exe
+		20=netwksta.sys
+		20=netvdd.sys
+

before you install the client. Also, don't use the + included NE2000 driver because it is buggy. Try the NE2000 + or NS2000 driver from + ftp://ftp.cdrom.com/pub/os2/network/ndis/ instead. +

Are there any other issues when OS/2 (any version) + is used as a client?

How do I get printer driver download working + for OS/2 clients?

<nt driver name> = <os2 driver + name>.<device name>, e.g.: + HP LaserJet 5L = LASERJET.HP LaserJet 5L

You can have multiple drivers mapped in this file.

\ No newline at end of file diff --git a/docs/htmldocs/Samba-PDC-HOWTO.html b/docs/htmldocs/Samba-PDC-HOWTO.html new file mode 100644 index 00000000000..668f7f9aff3 --- /dev/null +++ b/docs/htmldocs/Samba-PDC-HOWTO.html @@ -0,0 +1,1252 @@ +How to Configure Samba 2.2.x as a Primary Domain Controller

How to Configure Samba 2.2.x as a Primary Domain Controller

Background

Author's Note : This document +is a combination of David Bannon's Samba 2.2 PDC HOWTO +and the Samba NT Domain FAQ. Both documents are superceeded by this one.

Version of Samba prior to release 2.2 had marginal capabilities to +act as a Windows NT 4.0 Primary Domain Controller (PDC). The following +functionality should work in 2.2.0:

domain logons for Windows NT 4.0/2000 clients
placing a Windows 9x client in user level security
retrieving a list of users and groups from a Samba PDC to + Windows 9x/NT/2000 clients
roving user profiles
Windows NT 4.0 style system policies

The following pieces of functionality are not included in the 2.2 release:

Windows NT 4 domain trusts
Sam replication with Windows NT 4.0 Domain Controllers + (i.e. a Samba PDC and a Windows NT BDC or vice versa)
Adding users via the User Manager for Domains
Acting as a Windows 2000 Domain Controller (i.e. Kerberos + and Active Directory)

Implementing a Samba PDC can basically be divided into 2 broad +steps.

Configuring the Samba Domain Controller +
Creating machine trust accounts + and joining clients to the domain

Configuring the Samba Domain Controller

Here is an example smb.conf for acting as a PDC:

[global]
+    ; Basic server settings
+    netbios name = POGO
+    workgroup = NARNIA
+
+    ; we should act as the domain and local master browser
+    os level = 64
+    preferred master = yes
+    domain master = yes
+    local master = yes
+    
+    ; security settings (must user security = user)
+    security = user
+    
+    ; encrypted passwords are a requirement for a PDC
+    encrypt passwords = yes
+    
+    ; support domain logons
+    domain logons = yes
+    
+    ; where to store user profiles?
+    logon path = \\%N\profiles\%u
+    
+    ; where is a user's home directory and where should it
+    ; be mounted at?
+    logon drive = H:
+    logon home = \\homeserver\%u
+    
+    ; specify a generic logon script for all users
+    ; this is a relative path to the [netlogon] share
+    logon script = logon.cmd
+
+; necessary share for domain controller
+[netlogon]
+    path = /usr/local/samba/lib/netlogon
+    writeable = no
+    write list = ntadmin
+    
+; share for storing user profiles
+[profiles]
+    path = /export/smb/ntprofile
+    writeable = yes
+    create mask = 0600
+    directory mask = 0700

There are a couple of points to emphasize in the above +configuration.

encrypted passwords must be enabled. + For more details on how to do this, refer to + ENCRYPTION.html. +
The server must support domain logons + and a [netlogon] share
The server must be the domain master browser + in order for Windows client to locate the server as a DC.

Creating Machine Trust Accounts and Joining Clients +to the Domain

First you must understand what a machine trust account is and what +it is used for.

There are two means of creating machine trust accounts.

Manual creation before joining the client + to the domain. In this case, the password is set to a known + value -- the lower case of the machine's netbios name.
Creation of the account at the time of + joining the domain. In this case, the session key of the + administrative account used to join the client to the domain acts + as an encryption key for setting the password to a random value.

doppy$:x:505:501:NTMachine:/dev/null:/bin/false

root# smbpasswd -a -m machine_name

where machine_name is the machine's netbios +name.

If you manually create a machine account, immediately join +the client to the domain. An open account like this +can allow intruders to gain access to user account information +in your domain.

add user script = /usr/sbin/useradd -d /dev/null -g 100 -s /bin/false -M %u

Common Problems and Errors

I cannot include a '$' in a machine name.

A 'machine name' in (typically) /etc/passwd +of the machine name with a '$' appended. FreeBSD (and other BSD +systems ?) won't create a user with a '$' in their name.

I get told "You already have a connection to the Domain...." +when creating a machine account.

I get told "Cannot join domain, the credentials supplied +conflict with an existing set.."

This is the same basic problem as mentioned above, "You already +have a connection..."

"The system can not log you on (C000019B)...."

"The machine account for this computer either does not +exist or is not accessible."

When I try to join the domain I get the message "The machine account +for this computer either does not exist or is not accessible". Whats +wrong ?

System Policies and Profiles

Here are some additional details:

What about Windows NT Policy Editor ?

Can Win95 do Policies ?

If group policies don't work one reports suggests getting the updated +(read: working) grouppol.dll for Windows 9x. The group list is grabbed +from /etc/group.

How do I get 'User Manager' and 'Server Manager'

Since I don't need to buy an NT Server CD now, how do I get +the 'User Manager for Domains', the 'Server Manager' ?

Microsoft distributes a version of +these tools called nexus for installation on Windows 95 systems. The +tools set includes

Server Manager
User Manager for Domains
Event Viewer

Click here to download the archived file ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE

The Windows NT 4.0 version of the 'User Manager for +Domains' and 'Server Manager' are available from Microsoft via ftp +from ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE

What other help can I get ?

What are some diagnostics tools I can use to debug the domain logon +process and where can I find them?

Some useful samba commands worth investigating: +

testparam | more
smbclient -L //{netbios name of server}

An SMB enabled version of tcpdump is available from + http://www.tcpdup.org/. + Ethereal, another good packet sniffer for UNIX and Win32 + hosts, can be downloaded from http://www.ethereal.com. +

How do I install 'Network Monitor' on an NT Workstation +or a Windows 9x box?

Initially you will need to install 'Network Monitor Tools and Agent' + on the NT Server. To do this +

Goto Start - Settings - Control Panel - + Network - Services - Add
Select the 'Network Monitor Tools and Agent' and + click on 'OK'.
Click 'OK' on the Network Control Panel. +
Insert the Windows NT Server 4.0 install CD + when prompted.

In order to install the Netmon tools on an NT Workstation, you will + first need to install the 'Network Monitor Agent' from the Workstation + install CD. +

Goto Start - Settings - Control Panel - + Network - Services - Add
Select the 'Network Monitor Agent' and click + on 'OK'.
Click 'OK' on the Network Control Panel. +
Insert the Windows NT Workstation 4.0 install + CD when prompted.

URLs and similar

Home of Samba site http://samba.org. We have a mirror near you !
The Development document + on the Samba mirrors might mention your problem. If so, + it might mean that the developers are working on it.
See how Scott Merrill simulates a BDC behavior at + http://www.skippy.net/linux/smb-howto.html.
Although 2.0.7 has almost had its day as a PDC, David Bannon will + keep the 2.0.7 PDC pages at http://bioserve.latrobe.edu.au/samba going for a while yet.
Misc links to CIFS information + http://samba.org/cifs/
NT Domains for Unix http://mailhost.cb1.com/~lkcl/ntdom/
FTP site for older SMB specs: + ftp://ftp.microsoft.com/developr/drg/CIFS/

Mailing Lists

How do I get help from the mailing lists ?

There are a number of Samba related mailing lists. Go to http://samba.org, click on your nearest mirror +and then click on Support and then click on Samba related mailing lists.

For questions relating to Samba TNG go to +http://www.samba-tng.org/ +It has been requested that you don't post questions about Samba-TNG to the +main stream Samba lists.

If you post a message to one of the lists please observe the following guide lines :

Always remember that the developers are volunteers, they are + not paid and they never guarantee to produce a particular feature at + a particular time. Any time lines are 'best guess' and nothing more. +
Always mention what version of samba you are using and what + operating system its running under. You should probably list the + relevant sections of your smb.conf file, at least the options + in [global] that affect PDC support.
In addition to the version, if you obtained Samba via + CVS mention the date when you last checked it out.
Try and make your question clear and brief, lots of long, + convoluted questions get deleted before they are completely read ! + Don't post html encoded messages (if you can select colour or font + size its html).
If you run one of those nifty 'I'm on holidays' things when + you are away, make sure its configured to not answer mailing lists. +
Don't cross post. Work out which is the best list to post to + and see what happens, ie don't post to both samba-ntdom and samba-technical. + Many people active on the lists subscribe to more + than one list and get annoyed to see the same message two or more times. + Often someone will see a message and thinking it would be better dealt + with on another, will forward it on for you.
You might include partial + log files written at a debug level set to as much as 20. + Please don't send the entire log but enough to give the context of the + error messages.
(Possibly) If you have a complete netmon trace ( from the opening of + the pipe to the error ) you can send the *.CAP file as well.
Please think carefully before attaching a document to an email. + Consider pasting the relevant parts into the body of the message. The samba + mailing lists go to a huge number of people, do they all need a copy of your + smb.conf in their attach directory ?

How do I get off the mailing lists ?

Please don't post messages to the list asking to be removed, you will just + be referred to the above address (unless that process failed in some way...) +

DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba

This appendix was originally authored by John H Terpstra of the Samba Team +and is included here for posterity.

To many people these terms can be confusing, so let's try to clear the air.

The registry files can be located on any Windows NT machine by opening a +command prompt and typing:

C:\WINNT\> dir %SystemRoot%\System32\config

The environment variable %SystemRoot% value can be obtained by typing:

C:\WINNT>echo %SystemRoot%

The active parts of the registry that you may want to be familiar with are +the files called: default, system, software, sam and security.

The Windows NT User database also resides within the registry. This part of +the registry contains the user's security identifier, home directory, group +memberships, desktop profile, and so on.

The PDC and BDCs then participate in replication of the SAM database so that +each Domain Controlling participant will have an up to date SAM component +within its registry.

\ No newline at end of file diff --git a/docs/htmldocs/UNIX_INSTALL.html b/docs/htmldocs/UNIX_INSTALL.html new file mode 100644 index 00000000000..34f4ed9283a --- /dev/null +++ b/docs/htmldocs/UNIX_INSTALL.html @@ -0,0 +1,815 @@ +How to Install and Test SAMBA

How to Install and Test SAMBA

Step 0: Read the man pages

The man pages distributed with SAMBA contain + lots of useful info that will help to get you started. + If you don't know how to read man pages then try + something like:

$ nroff -man smbd.8 | more +

Other sources of information are pointed to + by the Samba web site, http://www.samba.org

Step 1: Building the Binaries

root# ./configure --help +

first to see what special options you can enable. + Then exectuting

root# make

will create the binaries. Once it's successfully + compiled you can use

root# make install

to install the binaries and manual pages. You can + separately install the binaries and/or man pages using

root# make installbin +

and

root# make installman +

root# make revert +

if you find this version a disaster!

Step 2: The all important step

At this stage you must fetch yourself a + coffee or other drink you find stimulating. Getting the rest + of the install right can sometimes be tricky, so you will + probably need it.

If you have installed samba before then you can skip + this step.

Step 3: Create the smb configuration file.

The simplest useful configuration file would be + something like this:

	[global]
+	   workgroup = MYGROUP
+
+	   [homes]
+	      guest ok = no
+	      read only = no
+

Note that make install will not install + a smb.conf file. You need to create it + yourself.

Make sure you put the smb.conf file in the same place + you specified in theMakefile (the default is to + look for it in /usr/local/samba/lib/).

For more information about security settings for the + [homes] share please refer to the document UNIX_SECURITY.txt.

Step 4: Test your config file with + testparm

It's important that you test the validity of your + smb.conf file using the testparm program. + If testparm runs OK then it will list the loaded services. If + not it will give an error message.

Make sure it runs OK and that the services look + resonable before proceeding.

Step 5: Starting the smbd and nmbd

The main advantage of starting smbd + and nmbd as a daemon is that they will + respond slightly more quickly to an initial connection + request. This is, however, unlikely to be a problem.

Step 5a: Starting from inetd.conf

NOTE; The following will be different if + you use NIS or NIS+ to distributed services maps.

Look at your /etc/services. + What is defined at port 139/tcp. If nothing is defined + then add a line like this:

netbios-ssn 139/tcp

similarly for 137/udp you should have an entry like:

netbios-ns 137/udp

Next edit your /etc/inetd.conf + and add two lines something like this:

		netbios-ssn stream tcp nowait root /usr/local/samba/bin/smbd smbd 
+		netbios-ns dgram udp wait root /usr/local/samba/bin/nmbd nmbd 
+

The exact syntax of /etc/inetd.conf + varies between unixes. Look at the other entries in inetd.conf + for a guide.

NOTE: Some unixes already have entries like netbios_ns + (note the underscore) in /etc/services. + You must either edit /etc/services or + /etc/inetd.conf to make them consistant.

Restart inetd, perhaps just send + it a HUP. If you have installed an earlier version of nmbd then you may need to kill nmbd as well.

Step 5b. Alternative: starting it as a daemon

To start the server as a daemon you should create + a script something like this one, perhaps calling + it startsmb.

		#!/bin/sh
+		/usr/local/samba/bin/smbd -D 
+		/usr/local/samba/bin/nmbd -D 
+

then make it executable with chmod + +x startsmb

You can then run startsmb by + hand or execute it from /etc/rc.local +

To kill it send a kill signal to the processes + nmbd and smbd.

NOTE: If you use the SVR4 style init system then + you may like to look at the examples/svr4-startup + script to make Samba fit into that system.

Step 6: Try listing the shares available on your + server

$ smbclient -L + yourhostname

Step 7: Try connecting with the unix client

$ smbclient //yourhostname/aservice

For example if your unix host is bambi and your login + name is fred you would type:

$ smbclient //bambi/fred +

Step 8: Try connecting from a DOS, WfWg, Win9x, WinNT, + Win2k, OS/2, etc... client

Try mounting disks. eg:

C:\WINDOWS\> net use d: \\servername\service +

Try printing. eg:

C:\WINDOWS\> net use lpt1: + \\servername\spoolservice

C:\WINDOWS\> print filename +

Celebrate, or send me a bug report!

What If Things Don't Work?

If nothing works and you start to think "who wrote + this pile of trash" then I suggest you do step 2 again (and + again) till you calm down.

When you fix the problem PLEASE send me some updates to the + documentation (or source code) so that the next person will find it + easier.

Diagnosing Problems

If you have instalation problems then go to + DIAGNOSIS.txt to try to find the + problem.

Scope IDs

Choosing the Protocol Level

The SMB protocol has many dialects. Currently + Samba supports 5, called CORE, COREPLUS, LANMAN1, + LANMAN2 and NT1.

You can choose what maximum protocol to support + in the smb.conf file. The default is + NT1 and that is the best for the vast majority of sites.

The main advantage of LANMAN2 and NT1 is support for + long filenames with some clients (eg: smbclient, Windows NT + or Win95).

See the smb.conf(5) manual page for more details.

Printing from UNIX to a Client PC

There is also a SYSV style script that does much + the same thing called smbprint.sysv. It contains instructions.

Locking

One area which sometimes causes trouble is locking.

Mapping Usernames

If you have different usernames on the PCs and + the unix server then take a look at the "username map" option. + See the smb.conf man page for details.

Other Character Sets

\ No newline at end of file diff --git a/docs/htmldocs/lmhosts.5.html b/docs/htmldocs/lmhosts.5.html index 4d66e95b7a0..671278c19e0 100644 --- a/docs/htmldocs/lmhosts.5.html +++ b/docs/htmldocs/lmhosts.5.html @@ -14,7 +14,7 @@ VLINK="#840084" ALINK="#0000FF" >

lmhosts

#
-#Sample Samba lmhosts file.
+# Sample Samba lmhosts file.
 #
 192.9.200.1	TESTPC
 192.9.200.20	NTSERVER#20
diff --git a/docs/htmldocs/msdfs_setup.html b/docs/htmldocs/msdfs_setup.html
new file mode 100644
index 00000000000..7bf6664dc64
--- /dev/null
+++ b/docs/htmldocs/msdfs_setup.html
@@ -0,0 +1,210 @@
+Hosting a Microsoft Distributed File System tree on SambaHosting a Microsoft Distributed File System tree on Samba
Instructions
The Distributed File System (or Dfs) provides a means of 
+	separating the logical view of files and directories that users 
+	see from the actual physical locations of these resources on the 
+	network. It allows for higher availability, smoother storage expansion, 
+	load balancing etc. For more information about Dfs, refer to  	Microsoft documentation. 
This document explains how to host a Dfs tree on a Unix 
+	machine (for Dfs-aware clients to browse) using Samba.
To enable SMB-based DFS for Samba, configure it with the 
+	--with-msdfs option. Once built, a 
+	Samba server can be made a Dfs server by setting the global 
+	boolean 	host msdfs parameter in the smb.conf
+	 file. You designate a share as a Dfs root using the share 
+	level boolean 	msdfs root parameter. A Dfs root directory on 
+	Samba hosts Dfs links in the form of symbolic links that point 
+	to other servers. For example, a symbolic link
+	junction->msdfs:storage1\share1 in 
+	the share directory acts as the Dfs junction. When Dfs-aware 
+	clients attempt to access the junction link, they are redirected 
+	to the storage location (in this case, \\storage1\share1).
Dfs trees on Samba work with all Dfs-aware clients ranging 
+	from Windows 95 to 2000.
Here's an example of setting up a Dfs tree on a Samba 
+	server.
# The smb.conf file:
+[global]
+	netbios name = SAMBA
+	host msdfs   = yes
+
+[dfs]
+	path = /export/dfsroot
+	msdfs root = yes
+	
In the /export/dfsroot directory we set up our dfs links to 
+	other servers on the network.
root# cd /export/dfsroot
root# chown root /export/dfsroot
root# chmod 755 /export/dfsroot
root# ln -s msdfs:storageA\\shareA linka
root# ln -s msdfs:serverB\\share,serverC\\share linkb
You should set up the permissions and ownership of 
+	the directory acting as the Dfs root such that only designated 
+	users can create, delete or modify the msdfs links. Also note 
+	that symlink names should be all lowercase. This limitation exists 
+	to have Samba avoid trying all the case combinations to get at 
+	the link name. Finally set up the symbolic links to point to the 
+	network shares you want, and start Samba.
Users on Dfs-aware clients can now browse the Dfs tree 
+	on the Samba server at \\samba\dfs. Accessing 
+	links linka or linkb (which appear as directories to the client) 
+	takes users directly to the appropriate shares on the network.
Notes
Windows clients need to be rebooted 
+			if a previously mounted non-dfs share is made a dfs 
+			root or vice versa. A better way is to introduce a 
+			new share and make it the dfs root.
Currently there's a restriction that msdfs 
+			symlink names should all be lowercase.
For security purposes, the directory 
+			acting as the root of the Dfs tree should have ownership 
+			and permissions set so that only designated users can 
+			modify the symbolic links in the directory.
\ No newline at end of file
diff --git a/docs/htmldocs/printer_driver2.html b/docs/htmldocs/printer_driver2.html
new file mode 100644
index 00000000000..34208f8feea
--- /dev/null
+++ b/docs/htmldocs/printer_driver2.html
@@ -0,0 +1,744 @@
+Printing Support in Samba 2.2.xPrinting Support in Samba 2.2.x
Introduction
Beginning with the 2.2.0 release, Samba supports 
+	the native Windows NT printing mechanisms implemented via 
+	MS-RPC (i.e. the SPOOLSS named pipe).  Previous versions of 
+	Samba only supported LanMan printing calls.
The additional functionality provided by the new 
+	SPOOLSS support includes:
Support for downloading printer driver 
+		files to Windows 95/98/NT/2000 clients upon demand.
+		
Uploading of printer drivers via the 
+		Windows NT Add Printer Wizard (APW) or the Imprints tool set
+		
Support for the native MS-RPC printing 
+		calls such as StartDocPrinter, EnumJobs(), etc...  (See 
+		the MSDN documentation
+		 for more information on the Win32 printing API)
+		
Support for NT Access Control Lists (ACL) 
+		on printer objects
Improved support for printer queue manipulation 
+		through the use of an internal databases for spooled job 
+		information
Configuration
In order to support the uploading of printer driver 
+	files, you must first configure a file share named [print$].  
+	The name of this share is hard coded in Samba's internals so 
+	the name is very important (print$ is the service used by 
+	Windows NT print servers to provide support for printer driver 
+	download).
Warning
Previous versions of Samba recommended using 
+		a share named [printer$].  This name was taken from the 
+		printer$ service created by Windows 9x clients when a 
+		printer was shared.  Windows 9x printer servers always have 
+		a printer$ service which provides read-only access via no 
+		password in order to support printer driver downloads.
However, the initial implementation allowed for a 
+		parameter named printer driver location 
+		to be used on a per share basis to specify the location of 
+		the driver files associated with that printer.  Another 
+		parameter named printer driver provided 
+		a means of defining the printer driver name to be sent to 
+		the client.
These parameters, including printer driver 
+		file parameter, are being depreciated and should not 
+		be used in new installations.  For more information on this change, 
+		you should refer to the Migration section 
+		of this document.
You should modify the server's smb.conf file to create the 
+	following file share (of course, some of the parameter values,
+	such as 'path' are arbitrary and should be replaced with
+	appropriate values for your site):
[print$]
+	path = /usr/local/samba/printers
+	guest ok = yes
+	browseable = yes
+	read only = yes
+	write list = ntadmin
+	
The 	write list is used to allow administrative 
+	level user accounts to have write access in order to update files 
+	on the share.  See the 	smb.conf(5) man page for more information on 
+	configuring file shares.
The requirement for 	guest ok = yes depends upon how your
+	site is configured.  If users will be guaranteed to have 
+	an account on the Samba host, then this is a non-issue.
author's note: The non-issue is that 
+	if all your Windows NT users are guarenteed to be authenticated 
+	by the Samba server (such as a domain member server and the NT 
+	user has already been validated by the Domain Controller in 
+	order to logon to the Windows NT console), then guest access 
+	is not necessary.  Of course, in a workgroup environment where 
+	you just want to be able to print without worrying about 
+	silly accounts and security, then configure the share for 
+	guest access.  You'll probably want to add map to guest = Bad User
+	 in the [global] section as well.  Make sure 
+	you understand what this parameter does before using it 
+	though. --jerry]
In order for a Windows NT print server to support 
+	the downloading of driver files by multiple client architectures,
+	it must create subdirectories within the [print$] service
+	which correspond to each of the supported client architectures.
+	Samba follows this model as well.
Next create the directory tree below the [print$] share 
+	for each architecture you wish to support.
	[print$]-----
+		|-W32X86		; "Windows NT x86"
+		|-WIN40			; "Windows 95/98"
+		|-W32ALPHA		; "Windows NT Alpha_AXP"
+		|-W32MIPS		; "Windows NT R4000"
+		|-W32PPC		; "Windows NT PowerPC"
+	
Warning
ATTENTION!  REQUIRED PERMISSIONS
In order to currently add a new driver to you Samba host, 
+		one of two conditions must hold true:
The account used to connect to the Samba host 
+			must have a uid of 0 (i.e. a root account)
The account used to connect to the Samba host
+			must be a member of the 			printer admin list.
Of course, the connected account must still possess access
+		to add files to the subdirectories beneath [print$].
Once you have created the required [print$] service and 
+	associated subdirectories, simply log onto the Samba server using 
+	a root (or printer admin) account
+	from a Windows NT 4.0 client.  Navigate to the "Printers" folder
+	on the Samba server.  You should see an initial listing of printers
+	that matches the printer shares defined on your Samba host.
The initial listing of printers in the Samba host's 
+	Printers folder will have no printer driver assigned to them.  
+	The way assign a driver to a printer is to view the Properties 
+	of the printer and either
Use the "New Driver..." button to install 
+		a new printer driver, or
Select a driver from the popup list of 
+		installed drivers.  Initially this list will be empty.
If you wish to install printer drivers for client 
+	operating systems other than "Windows NT x86", you will need 
+	to use the "Sharing" tab of the printer properties dialog.
Assuming you have connected with a root account, you 
+	will also be able modify other printer properties such as 
+	ACLs and device settings using this dialog box.
A few closing comments for this section, it is possible 
+	on a Windows NT print server to have printers
+	listed in the Printers folder which are not shared.  Samba does
+	not make this distinction.  By definition, the only printers of
+	which Samba is aware are those which are specified as shares in
+	smb.conf.
Another interesting side note is that Windows NT clients do
+	not use the SMB printer share, but rather can print directly 
+	to any printer on another Windows NT host using MS-RPC.  This
+	of course assumes that the printing client has the necessary
+	privileges on the remote host serving the printer.  The default
+	permissions assigned by Windows NT to a printer gives the "Print"
+	permissions to the "Everyone" well-known group.
Support a large number of printers
One issue that has arisen during the development
+		phase of Samba 2.2 is the need to support driver downloads for
+		100's of printers.  Using the Windows NT APW is somewhat 
+		awkward to say the list.  If more than one printer are using the 
+		same driver, the rpcclient's
+		setdriver command can be used to set the driver
+		associated with an installed driver.  The following is example
+		of how this could be accomplished:
 
+		$ rpcclient pogo -U root%secret -c "enumdrivers"
+Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
+ 
+[Windows NT x86]
+Printer Driver Info 1:
+	Driver Name: [HP LaserJet 4000 Series PS]
+ 
+Printer Driver Info 1:
+	Driver Name: [HP LaserJet 2100 Series PS]
+ 
+Printer Driver Info 1:
+	Driver Name: [HP LaserJet 4Si/4SiMX PS]
+				  
+		$ rpcclient pogo -U root%secret -c "enumprinters"
+Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
+	flags:[0x800000]
+	name:[\\POGO\hp-print]
+	description:[POGO\\POGO\hp-print,NO DRIVER AVAILABLE FOR THIS PRINTER,]
+	comment:[]
+				  
+		$ rpcclient pogo -U root%bleaK.er \
+		>  -c "setdriver hp-print \"HP LaserJet 4000 Series PS\""
+Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
+Succesfully set hp-print to driver HP LaserJet 4000 Series PS.
+		
The Imprints Toolset
The Imprints tool set provides a UNIX equivalent of the 
+	Windows NT Add Printer Wizard.  For complete information, please 
+	refer to the Imprints web site at 	http://imprints.sourceforge.net/ as well as the documentation 
+	included with the imprints source distribution.  This section will 
+	only provide a brief introduction to the features of Imprints.
What is Imprints?
Imprints is a collection of tools for supporting the goals 
+		of
Providing a central repository information 
+			regarding Windows NT and 95/98 printer driver packages
Providing the tools necessary for creating 
+			the Imprints printer driver packages.
Providing an installation client which 
+			will obtain and install printer drivers on remote Samba 
+			and Windows NT 4 print servers.
Creating Printer Driver Packages
The process of creating printer driver packages is beyond
+		the scope of this document (refer to Imprints.txt also included
+		with the Samba distribution for more information).  In short,
+		an Imprints driver package is a gzipped tarball containing the
+		driver files, related INF files, and a control file needed by the
+		installation client.
The Imprints server
The Imprints server is really a database server that 
+		may be queried via standard HTTP mechanisms.  Each printer 
+		entry in the database has an associated URL for the actual
+		downloading of the package.  Each package is digitally signed
+		via GnuPG which can be used to verify that package downloaded
+		is actually the one referred in the Imprints database.  It is 
+		not recommended that this security check 
+		be disabled.
The Installation Client
More information regarding the Imprints installation client 
+		is available in the Imprints-Client-HOWTO.ps 
+		file included with the imprints source package.
The Imprints installation client comes in two forms.
a set of command line Perl scripts
a GTK+ based graphical interface to 
+			the command line perl scripts
The installation client (in both forms) provides a means
+		of querying the Imprints database server for a matching
+		list of known printer model names as well as a means to 
+		download and install the drivers on remote Samba and Windows
+		NT print servers.
The basic installation process is in four steps and 
+		perl code is wrapped around smbclient 
+		and rpcclient.
	
+		foreach (supported architecture for a given driver)
+		{
+			1.	rpcclient: Get the appropriate upload directory 
+				on the remote server
+			2.	smbclient: Upload the driver files
+			3.	rpcclient: Issues an AddPrinterDriver() MS-RPC
+		}
+	
+		4.	rpcclient: Issue an AddPrinterEx() MS-RPC to actually
+			create the printer
+		
One of the problems encountered when implementing 
+		the Imprints tool set was the name space issues between 
+		various supported client architectures.  For example, Windows 
+		NT includes a driver named "Apple LaserWriter II NTX v51.8" 
+		and Windows 95 callsits version of this driver "Apple 
+		LaserWriter II NTX"
The problem is how to know what client drivers have 
+		been uploaded for a printer.  As astute reader will remember 
+		that the Windows NT Printer Properties dialog only includes 
+		space for one printer driver name.  A quick look in the 
+		Windows NT 4.0 system registry at
HKLM\System\CurrentControlSet\Control\Print\Environment
+		
will reveal that Windows NT always uses the NT driver 
+		name.  The is ok as Windows NT always requires that at least 
+		the Windows NT version of the printer driver is present.  
+		However, Samba does not have the requirement internally.  
+		Therefore, how can you use the NT driver name if is has not 
+		already been installed?
The way of sidestepping this limitation is to require 
+		that all Imprints printer driver packages include both the Intel 
+		Windows NT and 95/98 printer drivers and that NT driver is 
+		installed first.
Migration to from Samba 2.0.x to 
+	2.2.x
Given that printer driver management has changed
+	(we hope improved :) ) in 2.2.0 over prior releases,
+	migration from an existing setup to 2.2.0 can follow
+	several paths.
Warning
The following smb.conf parameters are considered to be
+		depreciated and will be removed soon.  Do not use them
+		in new installations
printer driver file (G)
+			
printer driver (S)
+			
printer driver location (S)
+			
Here are the possible scenarios for supporting migration:
If you do not desire the new Windows NT 
+		print driver support, nothing needs to be done.  
+		All existing parameters work the same.
If you want to take advantage of NT printer 
+		driver support but do not want to migrate the 
+		9x drivers to the new setup, the leave the existing 
+		printers.def file.  When smbd attempts to locate a 
+		9x driver for the printer in the TDB and fails it 
+		will drop down to using the printers.def (and all 
+		associated parameters).  The make_printerdef 
+		tool will also remain for backwards compatibility but will 
+		be moved to the "this tool is the old way of doing it" 
+		pile.
If you install a Windows 9x driver for a printer 
+		on your Samba host (in the printing TDB), this information will 
+		take precedence and the three old printing parameters
+		will be ignored (including print driver location).
If you want to migrate an existing 		printers.def file into the new setup, the current only 
+		solution is to use the Windows NT APW to install the NT drivers 
+		and the 9x  drivers.  This can be scripted using smbclient and 
+		rpcclient.  See the 		Imprints insrallation client for an example.
+		
\ No newline at end of file
diff --git a/docs/htmldocs/rpcclient.1.html b/docs/htmldocs/rpcclient.1.html
index 95324065c24..0242f7b8270 100644
--- a/docs/htmldocs/rpcclient.1.html
+++ b/docs/htmldocs/rpcclient.1.html
@@ -24,7 +24,7 @@ NAME="AEN5"
 >Namerpcclient -- developer's tool to testing client side 
+>rpcclient -- tool for executing client side 
 	MS-RPC functions

nmblookup [-d debuglevel] [-S server] [-U username] [-W workgroup] [-n <netbios name>] [-A authfile] [-N] [-l logfile] [-I destinationIP] [-E <terminal code>] [-c <command string>] [-i scope] [-O <socket options>] [-s <smb config file>]

rpcclient {server} [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N]

DESCRIPTION

rpcclient is a utility for developers for - executing various MS-RPC functions. It's primary use is for testing - Samba's own MS-RPC server implementation, however many administrators - have written scripts around it to manage Windows NT clients from +> is a utility initially developed + to test MS-RPC functionality in Samba itself. It has undergone + several stages of development and stability. Many system administrators + have now written scripts around it to manage Windows NT clients from their UNIX workstation.

OPTIONS

-d debuglevel: set the debuglevel. Debug level 0 is the lowest - and 100 being the highest. This should be set to 100 if you are - planning on submitting a bug report to the Samba team - (see BUGS.txt).
-S server: NetBIOS name of Server to which you wish to - connect. The server can be any SMB/CIFS server. The name is - resolved using either the NetBIOS name of Server to which to connect. + The server can be any SMB/CIFS server. The name is + resolved using the name resolve order - line or by using the -R option.
line from + smb.conf(5).
-l logbasename: File name for log/debug files. .client will be - appended. The log file is never removed by the client. +>This option allows + you to specify a file from which to read the username and + password used in the connection. The format of the file is
username = <value> + password = <value> + domain = <value> +
Make certain that the permissions on the file restrict + access from unwanted users.
-n netbios name: NetBIOS name of the - local machine. This option is only needed if your Samba client - cannot find it automatically. Samba should use the uppercase - of the machine's hostname.
execute semicolon separated commands (listed + below))
-N: tells rpcclient not to ask for a password. - rpcclient will prompt the user by default. +>set the debuglevel. Debug level 0 is the lowest + and 100 being the highest. This should be set to 100 if you are + planning on submitting a bug report to the Samba team (see BUGS.txt).
-I destinationIP: The IP address of the server specified with - the -S option. Only needed when the server's NetBIOS name cannot - be resolved using WINS or broadcast and isn't found in the LMHOSTS - file.
Print a summary of command line options. +
-E: causes rpcclient to write - messages to stderr instead of stdout.
File name for log/debug files. .client will be + appended. The log file is never removed by the client. +
-U username[%pass]: Sets the SMB username or username and password. - If %pass is not specified, The user will be prompted. The client - will first check the USER environment variable, then the - instruct rpcclient not to ask + for a password. By default, rpcclient will prompt + for a password. See also the $LOGNAME-U option.
-s smb.conf: Specifies the location of the all important + smb.conf file.
-U username[%password]: Sets the SMB username or username and password.
If %password is not specified, The user will be prompted. The + client will first check the USER environment variable, then the + LOGNAME variable and if either exist, the - string is uppercased. Anything in these variables following a '%' - sign will be treated as the password. If these environmental - variables are not found, the username GUEST - is used.
If the password is not included in these environment - variables (using the %pass syntax), rpcclient will look for - a $PASSWD environment variable from which - to read the password.
is used.
A third option is to use a credentials file which contains the plaintext of the username and password. This @@ -188,18 +209,12 @@ CLASS="PARAMETER" > for more details.
Be cautious about including passwords in scripts or in - the $PASSWD environment variable. Also, on +>Be cautious about including passwords in scripts. Also, on many systems the command line of a running process may be seen via the ps command to be safe always allow +> command. To be safe always allow rpcclient
-A filename: This option allows - you to specify a file from which to read the username and - password used in the connection. The format of the file is -
username = <value> -password = <value> -
Make certain that the permissions on the file restrict - access from unwanted users.
-W domain
-P: operate in promptless mode. Without this - mode (the default) rpcclient displays a - prompt of the form '[domain\username@host]$'
-c 'command string': execute semicolon separated commands (listed - below))
-t terminalcode: This tells the Samba client how to interpret - the incoming filenames, in regards to character sets. The list - here is not complete. For a complete list see your local Samba - source. Some valid options are sjis, euc, jis7, jis8, junet - and hex.
-O socket options: These socket options are the same as in - smb.conf (under the socket options - section).
-s smb.conf: Specifies the location of the all important - smb.conf file.
-i scope: Defines the NetBIOS scope. For more - information on NetBIOS scopes, see rfc1001 and rfc1002. NetBIOS - scopes are rarely used.

COMMANDS SPOOLSS CommandsLSARPC spoolenum - Execute an EnumPrinters() - call. This lists the various installed and share printers. Refer - to the MS Platform SDK documentation for more details of the various - flags and calling options. lsaquery spoolenumports level - - Executes an EnumPorts() call using the specified - info level. Currently only info level 1 and 2 are supported. - lookupsids spoolenumdata - Enumerate all - printer setting data stored on the server. On Windows NT clients, - these values are stored in the registry, while Samba servers - store them in the printers TDB. This command corresponds - to the MS Platform SDK GetPrinterData() function. lookupnames spooljobs printer - List the jobs - and status of a given printer. - This command corresponds to the MS Platform SDK EnumJobs() - function. enumtrusts SAMR spoolopen printer - - Execute an OpenPrinterEx() and ClosePrinter() RPC - against a given printer. queryuser spoolgetdata printer - - Retrieve the data for a given printer setting. See - the spoolenumdata command for more information. - This command corresponds to the GetPrinterData() MS Platform - SDK function. querygroup spoolgetprinter printer - - Retrieve the current printer information. This command - corresponds to the GetPrinter() MS Platform SDK function. - queryusergroups spoolgetprinterdriver - printer - Retrieve the printer driver information - (such as driver file, config file, dependent files, etc...) for - the given printer. This command corresponds to the GetPrinterDriver() - MS Platform SDK function. querygroupmem spoolgetprinterdriverdir - arch - Execute a GetPrinterDriverDirectory() - RPC to retreive the SMB share name and subdirectory for - storing printer driver files for a given architecture. Possible - values for arch are "Windows 4.0" - (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows - Alpha_AXP", and "Windows NT R4000". SPOOLSS spooladdprinterdriver - arch config - Execute an - AddPrinterDriver() RPC to install the printer driver information - on the server. Note that the driver files should already exist - in the directory returned by spoolgetprinterdriverdir. Possible - values for adddriver <arch> <config> + - Execute an AddPrinterDriver() RPC to install the printer driver + information on the server. Note that the driver files should + already exist in the directory returned by + getdriverdir. Possible values for + arch are the same as those for the spooolgetprintedriverdirgetdriverdir command. The Long Printer Name:\ -Driver File Name:\ -Data File Name:\ -Config File Name:\ -Help File Name:\ -Language Monitor Name:\ -Default Data Type:\ -Comma Separated list of Files +> Long Printer Name:\ + Driver File Name:\ + Data File Name:\ + Config File Name:\ + Help File Name:\ + Language Monitor Name:\ + Default Data Type:\ + Comma Separated list of Files spooladdprinter printername - sharename drivername port - - Add a printer on the remote server. This printer +>addprinter <printername> + <sharename> <drivername> <port> + - Add a printer on the remote server. This printer will be automatically shared. Be aware that the printer driver - must already be installed on the server (see addprinterdriver) + must already be installed on the server (see adddriver) and the portmust be a valid port name. must be a valid port name (see + enumports. enumdata - Enumerate all + printer setting data stored on the server. On Windows NT clients, + these values are stored in the registry, while Samba servers + store them in the printers TDB. This command corresponds + to the MS Platform SDK GetPrinterData() function (* This + command is currently unimplemented). enumjobs <printer> + - List the jobs and status of a given printer. + This command corresponds to the MS Platform SDK EnumJobs() + function (* This command is currently unimplemented). enumports [level] + - Executes an EnumPorts() call using the specified + info level. Currently only info levels 1 and 2 are supported. + enumdrivers [level] + - Execute an EnumPrinterDrivers() call. This lists the various installed + printer drivers for all architectures. Refer to the MS Platform SDK + documentation for more details of the various flags and calling + options. Currently supported info levels are 1, 2, and 3. enumprinters [level] + - Execute an EnumPrinters() call. This lists the various installed + and share printers. Refer to the MS Platform SDK documentation for + more details of the various flags and calling options. Currently + supported info levels are 0, 1, and 2. getdata <printername> + - Retrieve the data for a given printer setting. See + the enumdata command for more information. + This command corresponds to the GetPrinterData() MS Platform + SDK function (* This command is currently unimplemented). getdriver <printername> + - Retrieve the printer driver information (such as driver file, + config file, dependent files, etc...) for + the given printer. This command corresponds to the GetPrinterDriver() + MS Platform SDK function. Currently info level 1, 2, and 3 are supported. + getdriverdir <arch> + - Execute a GetPrinterDriverDirectory() + RPC to retreive the SMB share name and subdirectory for + storing printer driver files for a given architecture. Possible + values for General Commands arch are "Windows 4.0" + (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows + Alpha_AXP", and "Windows NT R4000". getprinter <printername> + - Retrieve the current printer information. This command + corresponds to the GetPrinter() MS Platform SDK function. + set - Set miscellaneous +>openprinter <printername> + - Execute an OpenPrinterEx() and ClosePrinter() RPC + against a given printer. setdriver <printername> <drivername> + - Execute a SetPrinter() command to update the printer driver associated + with an installed printer. The printer driver must already be correctly + installed on the print server. See also the enumprinters and rpcclient command line options during a - running session. enumdrivers commands for obtaining a list of + of installed printers and drivers. GENERAL OPTIONS use - Connect to a rmeote SMB - server. rpcclient has the ability to - maintain connections to multiple server simulaneously. debuglevel - Set the current debug level + used to log information. helphelp (?) - Print a listing of all known commands or extended help on a particular command. quitquit (exit) - Exit rpcclient - .

BUGS smbd(8) and rpcclientrpcclient(1) that are incompatible for some commands or services. Additionally, the developers are sending reports to Microsoft, and problems found @@ -592,18 +631,18 @@ CLASS="COMMAND" >VERSION This man page is correct for version 2.2 of - the Samba suite.This man page is correct for version 2.2 of the Samba + suite. AUTHOR The original rpcclient man page was written by Matthew Geddes, - Luke Kenneth Casson, and Gerald Carter. The conversion to - DocBook for Samba 2.2 was done by Gerald CarterThe original rpcclient man page was written by Matthew + Geddes, Luke Kenneth Casson, and rewriten by Gerald Carter. + The conversion to DocBook for Samba 2.2 was done by Gerald + Carter. Comments, corrections and additions to <D.Bannon@latrobe.edu.au> This is the FAQ for Samba 2.2 as an NTDomain controller. +> This is the FAQ for Samba 2.2 as an NTDomain controller. This document is derived from the origional FAQ that was built and - maintained by Gerald Carter - from the early days of Samba NTDomain development up until recently. - It is now being updated as significent changes are made to 2.2.0. Please note it does not apply to Samba2.2alpha0, Samba2.2alpha1, Samba 2.0.7, TNG nor HEAD branch. - I'll repeat, it does not apply to the current snapshot [ftp mirror]:/pub/samba/alpha/samba-2.2.0-alpha1.tar.gz, only to the to the current cvs. Please note it does not apply to the SAMBA_TNG nor the HEAD branch. + Also available is a Samba 2.2 PDC HowTo that takes you, step - by step, over the process of setting up a very basic Samba 2.2 Primary Domain Controller - Note: Please read the Introduction for the current state of play.HOWTO + that takes you, step by step, over the process of setting up a very basic Samba + 2.2 Primary Domain Controller + 1. Introduction State of Play Introduction 2. General Information What can we do ? What can Samba Primary Domain Controller (PDC) do ?What can Samba 2.2.x Primary Domain Controller (PDC) do ? Can I have a Windows 2000 client logon to a Samba controlled domain? What's the status of print spool (spoolss) support in the NTDOM code?Can I have a Windows 2000 client logon to a Samba +controlled domain? CVS What are the different Samba branches available in CVS ? What are the CVS commands ? 3. Establishing Connections How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?How do I get my NT4 or W2000 Workstation to login to the Samba +controlled Domain? What is a 'machine account' ? "The machine account for this computer either does not exist or is not accessable.""The machine account for this computer either does not +exist or is not accessable." How do I create machine accounts manually ? I cannot include a '$' in a machine name. I get told "You already have a connection to the Domain...." when creating a - machine account.I get told "You already have a connection to the Domain...." +when creating a machine account. I get told "Cannot join domain, the credentials supplied conflict - with an existing set.."I get told "Cannot join domain, the credentials supplied +conflict with an existing set.." "The system can not log you on (C000019B)...." 4. User Account Management Domain Admins How do I configure an account as a domain administrator? Profiles Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?Why is it bad to set "logon path = \\%N\%U\profile" in +smb.conf? Why are all the users listed in the "domain admin users" using the same profile?Why are all the users listed in the "domain admin users" using the +same profile? The roaming profiles do not seem to be updating on the server.The roaming profiles do not seem to be updating on the +server. Policies What are 'Policies' ?. I can't get system policies to work. What about Windows NT Policy Editor ? Can Win95 do Policies ? Passwords What is password sync and should I use it ? How do I get remote password (unix and SMB) changing working ? 5. Miscellaneous What editor can I use in DOS/Windows that won't mess with my unix EOFWhat editor can I use in DOS/Windows that won't +mess with my unix EOF How do I get 'User Manager' and 'Server Manager' The time setting from a Samba server does not work. "trust account xxx should be in DOMAIN_GROUP_RID_USERS" How do I get my samba server to become a member ( not PDC ) of an NT domain? 6. Troubleshooting and Bug Reporting Diagnostic tools What are some diagnostics tools I can use to debug the domain logon process and where can I find them? How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?How do I install 'Network Monitor' on an NT Workstation +or a Windows 9x box? What other help can I get ? URLs and similar How do I get help from the mailing lists ? How do I get off the mailing lists ? Chapter 1. Introduction State of Play It should be noted that 2.2.0 in its pre-release form still has a few problems, - I'll try and keep this section current while things are still dynamic. - At the time of this update (December 15, 2000) the current state of play is : Comments here about W2K joining the domain apply only to Samba 2.2 from the CVS after November 27th. The - 'snapshot' release Samba2.2alpha1 does not work !!! See below on how to get a CVS tree. Known Bug !W2K machines will not successfully join a domain with a name that - is made up from an even number of characters. Yep, thats right ! BIOTEST is OK as is MYDOMAI - but MYDOMAIN will not work until this bug is fixed. Hmm.., we believe - that this bug is fixed, but see below. Known Bug !After some bugs were fixed just before - Christmas, W2K SP1 machines cannot join the domain. Expected to be - fixed early in the new year. Whats that ? yeah, samba developers - have a Christmas break too ! Know Bug !NTs (and possibly W2K ?) are not told the logged on user is a domain - admin if the parameter "domain admin users = user" is used. The alternative, "domain admin group" - does work. See the HowTo. Client Side creation of Machine accounts does work but is not complete. - Firstly, the add user script runs as the user who's - name was entered, not as root. Secondly, the machine name passed to the script (%U) - has an underscore at the end, not a '$'. One alternative is to use %m and add the $. - This method is documented in the HowTo. - And thirdly, it does not work with NT4ws. - A W2K machine can join the domain. See the HowTo - which explains the process. The methods - described are 'work arounds' and should be regarded as temporary. Although I (drb) - have tested these procedures a number of people have had difficulty so there - may be other issues at work. JFM is aware of these - problems and will attend to them when he can. A Domain Admin account is required and at present it appears that only root - is a suitable candidate. Much of the related code does work. For example, if an NT is removed from the domain and then rejoins, the Actually I'm - not sure that last paragraph is correct .... Policies do work on a W2K machine. MS says that recent builds of - W2K dont observe an NT policy but it appears it does in 'legacy' mode. do work on a W2K machine. MS says that recent + builds of W2K dont observe an NT policy but it appears it does in 'legacy' + mode. Introduction This FAQ was origionally compiled by Jerry Carter (gc) chiefly dealing with the 'old head' - version of Samba and its NTDomain facilities. It is being rewritten by David Bannon (drb) - so that it addresses more accurately the Samba 2.2 planned for release late 2000. This FAQ was origionally compiled by Jerry Carter (gc) chiefly dealing + with the 'old HEAD' version of Samba and its NTDomain facilities. It is + being rewritten by David Bannon (drb) so that it addresses more + accurately the Samba 2.2.x release. + This document probably still contains some material that does not apply to - Samba 2.2 but most (all?) of the really misleading stuff has been removed. Some - issues are not dealt with or are dealt with badly. Please send corrections and additions to - David Bannon at D.Bannon@latrobe.edu.au This document probably still contains some material that does not apply + to Samba 2.2 but most (all?) of the really misleading stuff has been + removed. Some issues are not dealt with or are dealt with badly. Please + send corrections and additions to David Bannon. + Hopefully, as we all become familiar with the Samba 2.2 as a PDC this document will - become much more usefull.Hopefully, as we all become familiar with the Samba 2.2 as a + PDC this document will become much more usefull. Chapter 2. General Information What can we do ? What can Samba Primary Domain Controller (PDC) do ?What can Samba 2.2.x Primary Domain Controller (PDC) do ? If you wish to have Samba act as a PDC for Windows NT 3.51.and 4.0 or W2000 client, then you - will need to obtain the 2.2.0 version, currently in pre-release. Release of a stable, - full featured Samba PDC is currently slated for version 3.0. If you wish to have Samba act as a PDC for Windows NT 4.0/2000 client, + then you will need to obtain the 2.2.0 version. Release of a stable, + full featured Samba PDC is currently slated for version 3.0. + The following is a list of included features currently in Samba 2.2: The following is a list of included features currently in + Samba 2.2: + The ability to act as a limited PDC for Windows NT and W2000 clients. - This includes adding NT and W2K machines to the domain and authenticating users logging - into the domain.The ability to act as a limited PDC for + Windows NT and W2000 clients. This includes adding NT and + W2K machines to the domain and authenticating users logging + into the domain. Domain account can be viewed using the User Manager for - Domains ????Domain account can be viewed using the User + Manager for Domains Viewing resources on the Samba PDC via the Server Manager for Domains - from the NT client. ??Viewing/adding/deleting resources on the Samba + PDC via the Server Manager for Domains from the NT client. + Windows 95 clients will allow user level security to be set - but will not currently allow browsing of accounts.Windows 95/98/ME clients will allow user + level security to be set and browsing of domain accounts. + Changing of user passwords from an NT client. Partial support for Windows NT group and username mapping. Support for a LDAP password database backend.Changing of user passwords from an NT client. + Printing.Partial support for Windows NT username mapping. + Group name mapping is slated for a later release. These things are note expected to work in the forseeable future: + These things are note expected to work in the forseeable future PDC and BDC integration Windows NT ACLs (on the Samba shares) Offer a list of domain users to User Manager for Domains - (or the Security Tab etc). Can I have a Windows 2000 client logon to a Samba controlled domain?Can I have a Windows 2000 client logon to a Samba +controlled domain? The 2.2 release branch of Samba supports Windows 2000 domain - clients in legacy mode, ie as if the PDC is a NTServer, not a - W2K server. What's the status of print spool (spoolss) support in the NTDOM code? The implementation of support for SPOOLSS pipe is complete and it will be available - in the 2.2.0 release. This means that Samba will support the automatic downloading of printer - drivers for Windows NT clients just as it currently does for Windows 9x clients. The 2.2 release branch of Samba supports Windows 2000 domain + clients in legacy mode, ie as if the PDC is a NTServer, not a + W2K server. + CVS CVS is a programme (publically available) that the Samba developers use to - maintain the central source code. Non developers can get access to the source in - a read only capacity. Many flavours of unix now arrive with cvs installed. CVS is a programme (publically available) that the Samba developers + use to maintain the central source code. Non developers can get + access to the source in a read only capacity. Many flavours of unix + now arrive with cvs installed. What are the different Samba branches available in CVS ? You can find out more about obtaining Samba's via - anonymous CVS from - You can find out more about obtaining Samba's via anonymous + CVS from http://pserver.samba.org/samba/cvs.html". http://pserver.samba.org/samba/cvs.html. + There are basically four branches to watch at the moment : + There are basically four branches to watch at the moment : HEAD Samba 3.0 ? This code boasts all the main development - work in Samba. Two things that most people are not aware of - which live in the HEAD branch code are winbind NSS module and - Tim Potter's VFS implementation. Due to its developmental +>Samba 3.0 ? This code boasts all the main + development work in Samba. Due to its developmental nature, its not really suitable for production work. - SAMBA_2_0 This branch contains the current stable release release. - At the moment it contains 2.0.7, a version that will do some - limited PDC stuff. If you are really going to do PDC things then - I (drb) suggest that you consider 2.2 instead. - This branch contains the previous stable + release. At the moment it contains 2.0.8, a version that + will do some limited PDC stuff. If you are really going to + do PDC things, you consider 2.2 instead. + SAMBA_2_2 The next stable release, currently in a 'alpha' form. - It provides the Samba developers, testers and interested - people with an approximation of what is to come. This document - addresses only SAMBA_2_2. - The 2.2.x release branch which is a subset + of the features of the HEAD branch. This document addresses + only SAMBA_2_2. + SAMBA_TNG This branch is no longer maintained from the Samba sites. - Please see This branch is no longer maintained from the Samba + sites. Please see http://www.samba-tng.org/. It has been requested - that questions about TNG are not posted to the regular Samba mailing - lists including samba-ntdom and samba-technical. - What are the CVS commands ? See See http://pserver.samba.org/samba/cvs.html To get the Samba 2.2 version, tag SAMBA_2_2 you would do : For example : cd /usr/local/src/ cvs -d :pserver:cvs@pserver.samba.org:/cvsroot - login When prompted enter a password of cvs cvs -d :pserver:cvs@pserver.samba.org:/cvsroot - co -r SAMBA_2_2 samba Then to update that directory at some later time, cd /usr/local/src/samba cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login When prompted enter a password of 'cvs'. cvs update -d -P for instructions + on obtaining the SAMBA_2_2 or HEAD cvs code. + Chapter 3. Establishing Connections How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?How do I get my NT4 or W2000 Workstation to login to the Samba +controlled Domain? There is a comprehensive Samba PDC There is a comprehensive Samba PDC HowTo - accessable from the samba web site - under 'Documentation'. Its currently located at http://bioserve.latrobe.edu.au/samba. Read it. HOWTO accessable from the samba web + site under 'Documentation'. Read it. + What is a 'machine account' ? Every NT, W2K or Samba machine that joins a Samba controlled domain must be known to - the Samba PDC. There are two entries required, one in (typically) Every NT, W2K or Samba machine that joins a Samba controlled + domain must be known to the Samba PDC. There are two entries + required, one in (typically) /etc/passwd and the other in (typically) /usr/local/samba/private/smbpasswd. Under - some circumstances these entries are made . + Under some circumstances these entries are made + manually, the - , the HowTo discusses ways of creating them automatically. HOWTO + discusses ways of creating them automatically. "The machine account for this computer either does not exist or is not accessable.""The machine account for this computer either does not +exist or is not accessable." When I try to join the domain I get the message "The machine account for this computer - either does not exist or is not accessable". Whats wrong ? When I try to join the domain I get the message "The machine account + for this computer either does not exist or is not accessable". Whats + wrong ? + This problem is caused by the PDC not having a suitable machine account. +> This problem is caused by the PDC not having a suitable machine account. If you are using the add user script = method to create accounts - then this would indicate that it has not worked. Ensure the domain admin user - system is working. Alternatively if you are creating account entries manually then they have not been created - correctly. Make sure that you have the entry correct for the machine account in smbpasswd - file on the Samba PDC. If you added the account using an editor rather than using the smbpasswd utility, - make sure that the account name is the machine netbios name with a '$' appended to it - ( ie. computer_name$ ). There must be an entry in both /etc/passwd and - the smbpasswd file. Some people have reported that - inconsistent subnet masks between the Samba server and the NT client have caused this problem. - Make sure that these are consistent for both client and server. method to create + accounts then this would indicate that it has not worked. Ensure the domain + admin user system is working. + Alternatively if you are creating account entries manually then they + have not been created correctly. Make sure that you have the entry + correct for the machine account in smbpasswd file on the Samba PDC. + If you added the account using an editor rather than using the smbpasswd + utility, make sure that the account name is the machine netbios name + with a '$' appended to it ( ie. computer_name$ ). There must be an entry + in both /etc/passwd and the smbpasswd file. Some people have reported + that inconsistent subnet masks between the Samba server and the NT + client have caused this problem. Make sure that these are consistent + for both client and server. + How do I create machine accounts manually ? This was the only option until recently, now in version 2.2 better means are available. - You might still need to do it manually for a couple of reasons. A machine account - consists of two entries (assuming a standard install and /etc/passwd use), - one in /etc/passwd and the other in /usr/local/samba/private/smbpasswd. The /etc/passwd - entry will list the machine name with a $ appended, won't have a passwd, will have a null - shell and no home directory. For example a machine called 'doppy' would have an /etc/passwd - entry like this : This was the only option until recently, now in version 2.2 better + means are available. You might still need to do it manually for a + couple of reasons. A machine account consists of two entries (assuming + a standard install and /etc/passwd use), one in /etc/passwd and the + other in /usr/local/samba/private/smbpasswd. The /etc/passwd + entry will list the machine name with a $ appended, won't have a + passwd, will have a null shell and no home directory. For example + a machine called 'doppy' would have an /etc/passwd entry like this : doppy$:x:505:501:NTMachine:/dev/null:/bin/false + On a linux system for example, you would typically add it like this : On a linux system for example, you would typically add it like + this : + adduser -g machines -c NTMachine -d /dev/null -s /bin/false -n - doppy$ + Then you need to add that entry to smbpasswd, assuming you have a suitable +> Then you need to add that entry to smbpasswd, assuming you have a suitable path to the smbpasswd programme, do this : programme, do this : + smbpasswd -a -m doppy$ + The entry will be created with a well known password, so any machine that - says its doppy could join the domain as long as it gets in first. So don't create - the accounts any earlier than you need them. The entry will be created with a well known password, so any machine that + says its doppy could join the domain as long as it gets in first. So + don't create the accounts any earlier than you need them. + I cannot include a '$' in a machine name. A 'machine name' in (typically) A 'machine name' in (typically) /etc/passwd consists - of the machine name with a '$' appended. FreeBSD (and other BSD systems ?) - won't create a user with a '$' in their name. The problem is only in the program used to make the entry, once made, it works - perfectly. So create a user without the '$' and use The problem is only in the program used to make the entry, once + made, it works perfectly. So create a user without the '$' and + use vipw to edit - the entry, adding the '$'. Or create the whole entry with vipw if you like, - make sure you use a unique uid ! to edit the entry, adding the '$'. Or create + the whole entry with vipw if you like, make sure you use a + unique uid ! I get told "You already have a connection to the Domain...." when creating a - machine account.I get told "You already have a connection to the Domain...." +when creating a machine account. This happens if you try to create a machine account from the machine itself - and use a user name that does not work (for whatever reason) and then try - another (possibly valid) user name. - Exit out of the network applet to close the initial connection and try again. This happens if you try to create a machine account from the + machine itself and use a user name that does not work (for whatever + reason) and then try another (possibly valid) user name. + Exit out of the network applet to close the initial connection + and try again. + Further, if the machine is a already a 'member of a workgroup' that is the - same name as the domain you are joining (bad idea) you will get this message. - Change the workgroup name to something else, it does not matter what, reboot, - and try again. Further, if the machine is a already a 'member of a workgroup' that + is the same name as the domain you are joining (bad idea) you will + get this message. Change the workgroup name to something else, it + does not matter what, reboot, and try again. I get told "Cannot join domain, the credentials supplied conflict - with an existing set.."I get told "Cannot join domain, the credentials supplied +conflict with an existing set.." This is the same basic problem as mentioned above, "You already have a connection..." This is the same basic problem as mentioned above, "You already have a connection..." + "The system can not log you on (C000019B)...." I joined the domain successfully but after upgrading to a newer version of the - Samba code I get the message, "The system can not log you on (C000019B), Please try a - gain or consult your system administrator" when attempting to logon. I joined the domain successfully but after upgrading + to a newer version of the Samba code I get the message, "The system + can not log you on (C000019B), Please try a gain or consult your + system administrator" when attempting to logon. + This occurs when the domain SID stored in private/WORKGROUP.SID is changed. - For example, you remove the file and smbd automatically creates a new one. - Or you are swapping back and forth between versions 2.0.7, TNG and the HEAD branch - code (not recommended). The only way to correct the problem is to restore the - original domain SID or remove the domain client from the domain and rejoin. This occurs when the domain SID stored in private/WORKGROUP.SID is + changed. For example, you remove the file and smbd automatically + creates a new one. Or you are swapping back and forth between + versions 2.0.7, TNG and the HEAD branch code (not recommended). The + only way to correct the problem is to restore the original domain + SID or remove the domain client from the domain and rejoin. +

`Chapter 4. User Account Management`

`Domain Admins`

`How do I configure an account as a domain administrator?`

See the NTDom See the NTDom HowTo.

. +

`Profiles`

`Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?Why is it bad to set "logon path = \\%N\%U\profile" in +smb.conf?`

Sometimes Windows clients will maintain a connection to the \\homes\ ( or [%U] ) share - even after the user has logged out. Consider the following scenario.

Sometimes Windows clients will maintain a connection to + the \\homes\ ( or [%U] ) share even after the user has logged out. + Consider the following scenario. + user1 logs into the Windows NT machine. Therefore the - [homes] share is set to \\server\user1. user1 logs into the Windows NT machine. + Therefore the [homes] share is set to \\server\user1. + user1 works for a while and then logs out. user1 works for a while and then logs + out. user2 logs into the same Windows NT machine. user2 logs into the same Windows NT + machine. However, since the NT box has maintained a connection to [homes] which was - previously set to \\server\user1, when the operating system attempts to - get the profile and if it can read users1's profile, will get it otherwise it - will return an error. You get the picture. A better solution is to use a separate [profiles] share and set the - "logon path = \\%N\profiles\%U" However, since the NT box has maintained a connection to [homes] + which was previously set to \\server\user1, when the operating system + attempts to get the profile and if it can read users1's profile, will + get it otherwise it will return an error. You get the picture. + Note: Is this still a problem ???? A better solution is to use a separate [profiles] share and + set the "logon path = \\%N\profiles\%U" +

`Why are all the users listed in the "domain admin users" using the same profile?Why are all the users listed in the "domain admin users" using the +same profile?`

You are using a very very old development version of Samba. Upgrade.

You are using a very very old development version of Samba. + Upgrade. +

`The roaming profiles do not seem to be updating on the server.The roaming profiles do not seem to be updating on the +server.`

There can be several reasons for this.

There can be several reasons for this. + Make sure that the time on the client and the PDC are synchronized. You can accomplish - this by executing a Make sure that the time on the client and the PDC are synchronized. You + can accomplish this by executing a net time \\server /set /yes replacing server with the - name of your PDC (or another synchronized SMB server). See about Setting Time + replacing server with the name of your PDC (or another synchronized SMB server). + See about Setting Time + Make sure that the - logon path is writeable by the user and make sure that the connection to the logon - path location is by the current user. Sometimes Windows client do not drop the - connection immediately upon logoff. Make sure that the "logon path" is writeable by the user and make sure + that the connection to the logon path location is by the current user. + Sometimes Windows client do not drop the connection immediately upon + logoff. + Some people have reported that the logon path location should also be browseable. - I (GC) have yet to emperically verify this, but you can try. Some people have reported that the logon path location should + also be browseable. I (GC) have yet to emperically verify this, + but you can try.

`Policies`

`What are 'Policies' ?.`

When a user logs onto the domain via a client machine, the PDC sends - the client machine a list of things contained in the 'policy' (if it exists). - This list may do things like suppress a splach screen, format the dates the way you - like them or perhaps remove locally stored profiles.

When a user logs onto the domain via a client machine, the PDC + sends the client machine a list of things contained in the + 'policy' (if it exists). This list may do things like suppress + a splach screen, format the dates the way you like them or perhaps + remove locally stored profiles. + On a samba PDC this list is obtained from a file called ntconfig.pol - and located in the [netlogon]share. The file is created with a policy editor - and must be readable by anyone and writeable by only root. See On a samba PDC this list is obtained from a file called + ntconfig.pol and located in the [netlogon] + share. The file is created with a policy editor and must be readable + by anyone and writeable by only root. See below for how to get a suitable editor. for how to get a suitable editor. +

`I can't get system policies to work.`

There are two possible reasons for system policies not functioning correctly. - Make sure that you have the following parameters set in smb.conf

There are two possible reasons for system policies not + functioning correctly. Make sure that you have the following + parameters set in smb.conf + [netlogon] @@ -1235,66 +1099,71 @@ CLASS="PROGRAMLISTING" browseable = yes .... A policy file must be in the [netlogon] share and must be - readable by everyone and writeable by only root. The file must be created - by an NTServer Policy Editor. A policy file must be in the [netlogon] share and must be + readable by everyone and writeable by only root. The file + must be created by an NTServer Policy + Editor. + Last time I (drb) looked in the source, it was - looking for Last time I (drb) looked in the source, it was looking for + ntconfig.pol first then several other combinations of upper - and lower case. People have reported success using first then several other + combinations of upper and lower case. People have reported + success using NTconfig.pol, - , NTconfig.POL and + and ntconfig.pol. These are the case - settings that I (GC) use with the - filename . These are the case settings that + I (GC) use with the filename ntconfig.pol : + case sensitive = no case preserve = yes + short preserve case = no default case = yes -

`What about Windows NT Policy Editor ?`

To create or edit ntconfig.pol you must use the NT Server - Policy Editor, To create or edit ntconfig.pol you must use + the NT Server Policy Editor, poledit.exe which is included with NT Server - but which + is included with NT Server but not NT Workstation. There is a Policy Editor on a NTws +>. + There is a Policy Editor on a NTws but it is not suitable for creating Domain Policiesc:\winnt\inf which is where the binary will look for them unless told otherwise. Note also that that - directory is 'hidden'.

The Windows NT policy editor is also included with the Service Pack 3 (and later) for Windows NT 4.0. Extract the files using @@ -1324,13 +1194,13 @@ CLASS="COMMAND" >servicepackname /x, ie thats Nt4sp6ai.exe /x - for service pack 6a. - The policy editor, Nt4sp6ai.exe + /x for service pack 6a. The policy editor, poledt.exe and the associated template files (*.adm) should +> and the + associated template files (*.adm) should be extracted as well. It is also possible to downloaded the policy template files for Office97 and get a copy of the policy editor. Another possible location is with the Zero Administration Kit available for download from Microsoft. @@ -1341,24 +1211,28 @@ CLASS="SECT2" >

`Can Win95 do Policies ?`

Install the group policy handler for Win9x to pick up group policies. - Look on the Win98 CD in Install the group policy handler for Win9x to pick up group + policies. Look on the Win98 CD in \tools\reskit\netadmin\poledit. Install group policies on a Win9x client by double-clicking +>\tools\reskit\netadmin\poledit. + Install group policies on a Win9x client by double-clicking grouppol.inf. Log off and on again a couple of times and see if - Win98 picks up group policies. - Unfortunately this needs to be done on every Win9x machine that uses group policies....

. Log off and on again a couple of + times and see if Win98 picks up group policies. Unfortunately this needs + to be done on every Win9x machine that uses group policies.... + If group policies don't work one reports suggests getting the updated (read: working) - grouppol.dll for Windows 9x. The group list is grabbed from /etc/group. If group policies don't work one reports suggests getting the updated + (read: working) grouppol.dll for Windows 9x. The group list is grabbed + from /etc/group. +

`Passwords`

`What is password sync and should I use it ?`

NTws users can change their domain password by pressing Ctrl-Alt-Del and - choosing 'Change Password'. By default however, this does not change the unix password +> NTws users can change their domain password by pressing Ctrl-Alt-Del + and choosing 'Change Password'. By default however, this does not change the unix password (typically in /etc/passwd or /etc/shadow). In lots of situations - thats OK, for example :

/etc/passwd or /etc/shadow). + In lots of situations thats OK, for example : + The server is only accessible to the user via samba.The server is only accessible to the user via + samba. But sometimes you really do need to maintain two seperate password databases and - there are good reasons to keep then in sync. Trying to explain to users - that they need to change their passwords in two seperate places or use - two seperate passwords is not fun. But sometimes you really do need to maintain two seperate password + databases and there are good reasons to keep then in sync. Trying + to explain to users that they need to change their passwords in two + seperate places or use two seperate passwords is not fun. + However do understand that setting up password sync is not without problems either. - The chief difficulty is the interface between Samba and the However do understand that setting up password sync is not without + problems either. The chief difficulty is the interface between Samba + and the passwd command, - it can be a fiddle to set up and if the password the user has entered fails, - the resulting errors are ambiguously reported - and the user is confused. Further, you need to take steps to ensure that users - only ever change their passwords via samba (or use command, it can be a fiddle to set + up and if the password the user has entered fails, the resulting errors + are ambiguously reported and the user is confused. Further, you need + to take steps to ensure that users only ever change their passwords + via samba (or use smbpasswd), - otherwise they will only be changing the unix password. ), otherwise they will + only be changing the unix password.

`How do I get remote password (unix and SMB) changing working ?`

Have a practice changing a user's password (as root) to see what - discussion takes place and change the text in the 'passwd chat' line below as necessary. The - line as shown works for recent RH Linux but most other systems seem to like to do something - different. The '*' is a wild card and will match anything (or nothing). +> Have a practice changing a user's password (as root) to see + what discussion takes place and change the text in the 'passwd chat' + line below as necessary. The line as shown works for recent RH Linux + but most other systems seem to like to do something different. The '*' is + a wild card and will match anything (or nothing). +

Add these lines to smb.conf under [Global]

 
@@ -1442,10 +1326,13 @@ CLASS="PROGRAMLISTING"
    		passwd program = /usr/bin/passwd %u
    		passwd chat = *password* %n\n *password* %n\n *successful*

As mentioned above, the change to the unix password - happens as root, not as the user, as is indicated in ~/smbd/chgpasswd.c If - you are using NIS, the Samba server must be running on the NIS master machine.

As mentioned above, the change to the unix password happens as root, + not as the user, as is indicated in ~/smbd/chgpasswd.c If + you are using NIS, the Samba server must be running on the NIS + master machine. +

`Chapter 5. Miscellaneous`

`What editor can I use in DOS/Windows that won't mess with my unix EOFWhat editor can I use in DOS/Windows that won't +mess with my unix EOF`

There are a number of Windows or DOS based editors that will understand, and - leave intact, the unix eof (as opposed to a DOS CL/LF). List members suggested :

There are a number of Windows or DOS based editors that will + understand, and leave intact, the unix eof (as opposed to a DOS CL/LF). + List members suggested : + The author prefers PFE at www.lancs.ac.uk/people/cpaap/pfe/ www.lancs.ac.uk/people/cpaap/pfe/ but its no longer being developed... How do I get 'User Manager' and 'Server Manager' Since I don't need to buy an NT Server CD now, how do I get the 'User Manager for - Domains', the 'Server Manager' ? Since I don't need to buy an NT Server CD now, how do I get + the 'User Manager for Domains', the 'Server Manager' ? + Microsoft distributes a version of + these tools called nexus for installation on Windows 95 systems. The + tools set includes + Microsoft distributes a version of these tools called nexus - for installation on Windows 95 systems. The tools set includes Click here to download the archived file - Click here to download the archived file ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXEftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE + The Windows NT 4.0 version of the 'User Manager for Domains' - and 'Server Manager' are available from Microsoft via ftp from - The Windows NT 4.0 version of the 'User Manager for + Domains' and 'Server Manager' are available from Microsoft via ftp + from ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXEftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE +

`The time setting from a Samba server does not work.`

`"trust account xxx should be in DOMAIN_GROUP_RID_USERS"`

`How do I get my samba server to become a member ( not PDC ) of an NT domain?`

In a domain that has a number of servers you only need one password database. - The machines that don't have their own ask the PDC to check for them. - This will work fine for a domain controlled by either a Samba or NT machine. - The following lines in smb.conf are typical, 'password server' points to the - samba machine (or an NT) that has the password list :

 
-
-		[global]
-		...
-		security = domain
-		workgroup = { Put your domain name here }
-		password server = { Put the ip of the PDC here }
-		encrypt passwords = yes
-		...	
-

The samba server in question will have to 'join the domain', that requires - the domain controller to have a machine account for it. This is no different - to the machine account requirements to allow a NTws to join the domain. For - example, if we want a unix box called sleepy to ask the PDC called grumpy - to do its authentication then grumpy will need an entry in its smbpasswd - (assuming it's also samba) that starts with sleepy$. It would have to be - created manually.

If the domain is controlled by an NTServer then the "Server Manager for Domains" - tool must be used to add 'sleepy' to the domain list.

In either case we then join the domain. If the domain is called forest - then on sleepy we would join the domain by typing :

smbpasswd -j forest

Note that the directory where the smbpasswd file would be - located should exist as this is where smbd will generate the MACHINE.SID file. This - might be /usr/local/samba/private/FOREST.SLEEPY.SID and - it contains the trust account password for the domain member. The permissions are - (and should remain) "rw-------

Note the Samba Servers without the password list will most likely still need an account - for each user, this means a line in its /etc/passwd. Because authentication - is being handled at the domain level the - /etc/passwd line does not need a password. - If the shares being offered are not user specific, ie a common (read only ?) - area or perhaps just printing then the user's - /etc/passwd does not need a home directory. A typical - line in /etc/passwd for a server that allows domain users to - connect to the samba shares but does not offer a home share ('cos that's on the PDC) - and does not allow logon to the unix prompt would be like this :

jblow:x:542:100:Joe Blow:/dev/null:/bin/false

When removing those 'dummy' users, watch the 'remove user' scripts, - some OS think they should remove a users directory even when its not owned by the user ! +> Please refer to the Domain Member + HOWTO for more information on this.
The username map = parameter might help you to avoid having - all those accounts created.
You should investigate the smb.conf parameter - 'add user script', it will be used to create accounts on - secondary servers when that account already exists on the PDC. Very nice. - Something like :
    [Global]
-    ....
-    add user script = /usr/sbin/adduser -n -g users -c User -d /dev/null -s /bin/false %U	
-    ....
-        

`Chapter 6. Troubleshooting and Bug Reporting`

`Diagnostic tools`

`What are some diagnostics tools I can use to debug the domain logon process and where can I find them?`

One of the best diagnostic tools for debugging problems is Samba itself. You can use the -d - option for both smbd and nmbd to specifiy what 'debug level' at which to run. See the man - pages on smbd, nmbd and smb.conf for more information on debugging options. The debug - level can range from 1 (the default) to around 100 but a debug level of about 20 will - normally help you find any errors that samba is encountering. Another helpful method - of debugging is to compile samba using the gcc -g flag. This will include debug - information in the binaries and allow you to attch gdb to the running smbd / nmbd - process. In order to attach gdb to an smbd process for an NT workstation, first - get the workstation to make the connection. Pressing ctrl-alt-delete and going down - to the domain box is sufficient (at least, on the first time you join the domain) to - generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation maintains an open - connection, and therefore there will be an smbd process running (assuming that you - haven't set a really short smbd idle timeout) So, in between pressing ctrl alt - delete, and actually typing in your password, you can gdb attach and continue.

One of the best diagnostic tools for debugging problems is Samba itself. + You can use the -d option for both smbd and nmbd to specifiy what + 'debug level' at which to run. See the man pages on smbd, nmbd and + smb.conf for more information on debugging options. The debug + level can range from 1 (the default) to 10 (100 for debugging passwords). + Another helpful method of debugging is to compile samba using the + gcc -g flag. This will include debug + information in the binaries and allow you to attch gdb to the + running smbd / nmbd process. In order to attach gdb to an smbd + process for an NT workstation, first get the workstation to make the + connection. Pressing ctrl-alt-delete and going down to the domain box + is sufficient (at least, on the first time you join the domain) to + generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation + maintains an open connection, and therefore there will be an smbd + process running (assuming that you haven't set a really short smbd + idle timeout) So, in between pressing ctrl alt delete, and actually + typing in your password, you can gdb attach and continue. + Some usefull samba commands worth investigating: + Some usefull samba commands worth investigating: An SMB enabled version of tcpdump is available from +> An SMB enabled version of tcpdump is available from ftp://samba.org/pub/samba/tcpdump-smb/ - Capconvert is a small C program for translating output from tcpdump-smb to CAP format - that can be read by netmon. You will need to use the raw output from tcp dump - ( ie. tcpdump -w output.dump ). Good news! Now you can convert - Solaris' snoop output as well. The C source code for snoop2cap is available for download. - http://www.tcpdup.org/. + Ethereal, another good packet sniffer for UNIX and Win32 + hosts, can be downloaded from http://www.ethereal.com. + For tracing things on the Microsoft Windows NT, Network Monitor (aka. netmon) is available - on the Microsoft Developer Network CD's, the Windows NT Server install CD and the SMS CD's. - The version of netmon that ships with SMS allows for dumping packets between any two - computers (ie. placing the network interface in promiscuous mode). The version - on the NT Server install CD will only allow monitoring of network traffic directed to the - local NT box and broadcasts on the local subnet. For tracing things on the Microsoft Windows NT, Network Monitor + (aka. netmon) is available on the Microsoft Developer Network CD's, + the Windows NT Server install CD and the SMS CD's. The version of + netmon that ships with SMS allows for dumping packets between any two + computers (ie. placing the network interface in promiscuous mode). + The version on the NT Server install CD will only allow monitoring + of network traffic directed to the local NT box and broadcasts on the + local subnet. Be aware that Ethereal can read and write netmon + formatted files. +

`How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?How do I install 'Network Monitor' on an NT Workstation +or a Windows 9x box?`

Installing netmon on an NT workstation requires a couple of steps. The following - are for installing Netmon V4.00.349, which comes with Microsoft Windows NT Server - 4.0, on Microsoft Windows NT Workstation 4.0. The process should be similar - for other version of Windows NT / Netmon. You will need both the Microsoft Windows - NT Server 4.0 Install CD and the Workstation 4.0 Install CD.

Installing netmon on an NT workstation requires a couple + of steps. The following are for installing Netmon V4.00.349, which comes + with Microsoft Windows NT Server 4.0, on Microsoft Windows NT + Workstation 4.0. The process should be similar for other version of + Windows NT / Netmon. You will need both the Microsoft Windows + NT Server 4.0 Install CD and the Workstation 4.0 Install CD. + Initially you will need to install 'Network Monitor Tools and Agent' on the - NT Server. To do this Initially you will need to install 'Network Monitor Tools and Agent' + on the NT Server. To do this + Goto Start - Settings - Control Panel - Network - Services - Add Goto Start - Settings - Control Panel - + Network - Services - Add Select the 'Network Monitor Tools and Agent' and click on 'OK'.Select the 'Network Monitor Tools and Agent' and + click on 'OK'. Click 'OK' on the Network Control Panel.Click 'OK' on the Network Control Panel. + Insert the Windows NT Server 4.0 install CD when prompted.Insert the Windows NT Server 4.0 install CD + when prompted. At this point the Netmon files should exist in At this point the Netmon files should exist in + %SYSTEMROOT%\System32\netmon\*.*. Two subdirectories exist as well, parsers\ which contains the necessary DLL's - for parsing the netmon packet dump, and + which contains the necessary DLL's for parsing the netmon packet + dump, and captures\. . + In order to install the Netmon tools on an NT Workstation, you will first need to - install the 'Network Monitor Agent' from the Workstation install CD. In order to install the Netmon tools on an NT Workstation, you will + first need to install the 'Network Monitor Agent' from the Workstation + install CD. + Goto Start - Settings - Control Panel - Network - Services - AddGoto Start - Settings - Control Panel - + Network - Services - Add Select the 'Network Monitor Agent' and click on 'OK'.Select the 'Network Monitor Agent' and click + on 'OK'. Click 'OK' on the Network Control Panel.Click 'OK' on the Network Control Panel. + Insert the Windows NT Workstation 4.0 install CD when prompted.Insert the Windows NT Workstation 4.0 install + CD when prompted. Now copy the files from the NT Server in %SYSTEMROOT%\System32\netmon\*.* to - %SYSTEMROOT%\System32\netmon\*.* on the Workstation and set permissions as - you deem appropriate for your site. You will need administrative rights on the - NT box to run netmon. Now copy the files from the NT Server in %SYSTEMROOT%\System32\netmon\*.* + to %SYSTEMROOT%\System32\netmon\*.* on the Workstation and set + permissions as you deem appropriate for your site. You will need + administrative rights on the NT box to run netmon. + To install Netmon on a Windows 9x box install the network monitor agent from - the Windows 9x CD (\admin\nettools\netmon). - There is a readme file located with the netmon driver files on the CD if you need - information on how to do this. Copy the files from a working Netmon installation. To install Netmon on a Windows 9x box install the network monitor agent + from the Windows 9x CD (\admin\nettools\netmon). There is a readme + file located with the netmon driver files on the CD if you need + information on how to do this. Copy the files from a working + Netmon installation. +

`What other help can I get ?`

There are many sources of information available in the form of mailing lists, RFC's - and documentation. The docs that come with the samba distribution contain very - good explanations of general SMB topics such as browsing.

There are many sources of information available in the form + of mailing lists, RFC's and documentation. The docs that come + with the samba distribution contain very good explanations of + general SMB topics such as browsing. URLs and similar There are a number of documents that no longer appear to live at their - origional home. Any one know where the following may be found ? CIFS/E Browser Protocol draft-leach-cifs-browser-spec-00.txt CIFS Remote Administration Protocol draft-leach-cifs-rap-spec-00.txt CIFS Logon and Pass Through Authentication draft-leach-cifs-logon-spec-00.txt A Common Internet File System (CIFS/1.0) Protocol draft-leach-cifs-v1-spec-01.txt CIFS Printing Specification draft-leach-cifs-print-spec-00.txt RFC1001 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Concepts and methods. - http://ds.internic.net/rfc/rfc1001.txt RFC1002 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Detailed specifications. - http://ds.internic.net/rfc/rfc1002.txt Microsoft's main CIFS page: http://www.microsoft.com/workshop/networking/cifs/ You should also refer to the MS archives at + ftp://ftp.microsoft.com/developr/drg/CIFS/" + How do I get help from the mailing lists ? How do I get off the mailing lists ? To have your name removed from a samba mailing list, go to the same place you went to to get on it. Go to http://samba.org, click on your nearest mirror - and then click on http://lists.samba.org, click + on your nearest mirror and then click on Support and then click on and + then click on Samba related mailing lists Samba related mailing lists. Or perhaps see here Please don't post messages to the list asking to be removed, you will just +> Please don't post messages to the list asking to be removed, you will just be refered to the above address (unless that process failed in some way...) Sections are either filespace services (used by the +>Sections are either file share services (used by the client as an extension of their native file systems) or printable services (used by the client to access print services on the host running the server). parameters in this section apply to the server as a whole, or are defaults for sections which do not specifically define certain items. See the notes - under paraMETERS for more information.

`paraMETRS`

PARAMETERSparameters define the specific attributes of sections. %h the internet hostname that Samba is running +>the Internet hostname that Samba is running on. %M the internet name of the client machine. +>the Internet name of the client machine. NOTE ABOUT USERNAME/PASSWORD VALIDATIONThere are a number of ways in which a user can connect - to a service. The server follows the following steps in determining + to a service. The server uses the following steps in determining if it will allow a connection to a specified service. If all the - steps fail then the connection request is rejected. If one of the - steps pass then the following steps are not checked. If the service is marked "guest only = yes" then steps 1 to 5 are skipped.add user script addprinter command allow trusted domains announce as announce version auto services bind interfaces only browse list change notify timeout character set client code page code page directory coding system config file deadtime debug hires timestamp debug pid debug timestamp debug uid debug leveldebuglevel default default service delete user script deleteprinter command dfree command dns proxy domain admin group domain admin users domain groups domain guest group domain guest users domain logons domain master encrypt passwords enhanced browsing enumports command getwd cache hide local users homedir map host msdfs hosts equiv interfaces keepalive kernel oplocks lanman auth lm announce lm interval load printers local master lock dir lock directory log file log level logon drive logon home logon path logon script lpq cache time machine password timeout mangled stack map to guest max disk size max log size max mux max open files max protocol max packetmax smbd processes max ttl max wins ttl max xmit message command min passwd length min password length min protocol min wins ttl name resolve order netbios aliases netbios name netbios scope nis homedir nt acl support nt pipe support nt smb support null passwords ole locking compatibilityoplock break wait time oplock break wait timeos level os levelos2 driver map panic action passwd chat passwd chat debug passwd program password level password server prefered master preferred master preload printcap printcap name printer driver file private dir protocol read bmpx read prediction read raw read size remote announce remote browse sync restrict anonymous root root dir root directory security server string shared mem sizeshow add printer wizard smb passwd file smbrun socket address socket options source environment ssl ssl CA certDir ssl CA certFile ssl ciphers ssl client cert ssl client key ssl compatibility ssl hosts ssl hosts resign ssl require clientcert ssl require servercert ssl server cert ssl server key ssl version stat cache stat cache size strip dot syslog syslog only template homedir template shell time offset time server timestamp logs unix password synctotal print jobs unix realnameunix password sync update encrypted use rhosts username level username map utmp directory valid chars winbind cache time winbind gid winbind separator winbind uid wins hook wins proxy wins server wins support workgroup write raw

COMPLETE LIST OF SERVICE PARAMETERS Here is a list of all service parameters. See the section of +>Here is a list of all service parameters. See the section on each parameter for details. Note that some are synonyms. admin users allow hosts alternate permissions available blocking locks browsable browseable case sensitive casesignames comment copy create mask create mode default case delete readonly delete veto files deny hosts directory directory mask directory mode directory security mask dont descend dos filemode dos filetime resolution dos filetimes exec fake directory create times fake oplocks follow symlinks force create mode force directory mode force directory security mode force group force security mode force user fstype group guest account guest ok guest only hide dot files hide files hosts allow hosts deny include inherit permissions invalid users level2 oplocks locking lppause command lpq command lpresume command lprm command magic output magic script mangle case mangle locks mangled map mangled names mangling char map archive map hidden map system max connections max print jobs min print space msdfs root only guest only user oplock contention limit oplocks path posix locking postexec postscript preexec preexec close preserve case print command print ok printable printer printer admin printer driver printer driver location printer name printing public queuepause command queueresume command read list read only root postexec root preexec root preexec close security mask set directory share modes short preserve case status strict locking strict sync sync always user username users utmp valid users veto files veto oplock files vfs object vfs options volume wide links writable write cache size write list write ok writeable

EXPLANATION OF EACH PARAMETERsmbd(8) under special circumstances decribed below. under special circumstances described below.Normally, a Samba server requires that UNIX users are created for all users accessing files on this server. For sites @@ -3309,10 +4233,9 @@ CLASS="PARAMETER" > and attempts to authenticate the given user with the given password. If the - authentication succeeds then smbdsmbd attempts to find a UNIX user in the UNIX password database to map the Windows user into. If this lookup fails, and add user script is set then smbd is set then smbd will call the specified script argument to be the user name to create. If this script successfully creates the user then smbdIf this script successfully creates the user then smbd + will continue on as though the UNIX user already existed. In this way, UNIX users are dynamically created to match existing Windows NT accounts. See also , password server, , + addprinter command (G) With the introduction of MS-RPC based printing + support for Windows NT/2000 clients in Samba 2.2, The MS Add + Printer Wizard (APW) icon is now also available in the + "Printers..." folder displayed a share listing. The APW + allows for printers to be add remotely to a Samba or Windows + NT/2000 print server. For a Samba host this means that the printer must be + physically added to underlying printing system. The addprinter command defines a script to be run which + will perform the necessary operations for adding the printer + to the print system and to add the appropriate service definition + to the smb.conf file in order that it can be + shared by smbd(8) + . The addprinter command is + automatically invoked with the following parameter (in + order: printer name share name port name driver name location Windows 9x driver location + All parameters are filled in from the PRINTER_INFO_2 structure sent + by the Windows NT/2000 client with one exception. The "Windows 9x + driver location" parameter is included for backwards compatibility + only. The remaining fields in the structure are generated from answers + to the APW questions. Once the addprinter command has + been executed, smbd will reparse the smb.conf to determine if the share defined by the APW + exists. If the sharename is still invalid, then smbd + will return an ACCESS_DENIED error to the client. See also deleteprinter command, printing, + show add + printer wizard Default: none Example: addprinter command = /usr/bin/addprinter + admin users (S) Synonym for This option only takes effect when the security option is set to - serversecurity option is set to + server or domaindomain. If it is set to no, then attempts to connect to a resource from a domain or workgroup other than the one which smbd is running @@ -3490,7 +4578,7 @@ CLASS="COMMAND" > will announce itself as, to a network neighborhood browse list. By default this is set to Windows NT. The valid options - are : "NT" (which is a synonym for "NT Server"), "NT Server", + are : "NT Server" (which can also be written as "NT"), "NT Workstation", "Win95" or "WfW" meaning Windows NT Server, Windows NT Workstation, Windows 95 and Windows for Workgroups respectively. Do not change this parameter unless you have a @@ -3510,7 +4598,7 @@ CLASS="COMMAND" > annouce version (G) auto services (G) This is a list of services that you want to be - automatically added to the browse lists. This is most useful - for homes and printers services that would otherwise not be - visible. Note that if you just want all printers in your - printcap file loaded then the This is a synonym for the load printerspreload option is easier. Default: no auto services Example: auto services = fred lp colorlp . NAME MANGLING. Default: case sensitive = no . This will output the code page. The default for USA MS-DOS, Windows 95, and Windows NT releases is code page 437. The default for western - european releases of the above operating systems is code page 850.This parameter tells , code page directory Default: codingsystem (G) code page directory (G)This parameter is used to determine how incoming - Shift-JIS Japanese characters are mapped from the incoming Define the location of the various client code page + files.See also client code pageclient + code page +> Default: code page directory = ${prefix}/lib/codepages + Example: code page directory = /usr/share/samba/codepages + codingsystem (G) This parameter is used to determine how incoming + Shift-JIS Japanese characters are mapped from the incoming client code page used by the client, into file names in the UNIX filesystem. Only useful if Default: coding system = <empty value> + Default: noneno value Example: debug timestamp (G) Samba 2.2 debug log messages are timestamped - by default. If you are running at a high debug level these timestamps - can be distracting. This boolean parameter allows timestamping - to be turned off. Default: debug timestamp = yes debug pid (G) debug timestamp (G) Samba 2.2 debug log messages are timestamped + by default. If you are running at a high debug level these timestamps + can be distracting. This boolean parameter allows timestamping + to be turned off. Default: debug timestamp = yes debug uid (G) debug level (G)debuglevel (G)The value of the parameter (an integer) allows @@ -4823,7 +5946,7 @@ NAME="DEFAULTCASE" > See the section on NAME MANGLING" NAME MANGLING. Also note the parameter. Default: default case = lower Example: default service = pub +CLASS="PROGRAMLISTING" +>[global] + default service = pub - [pub] - path = /%S - delete readonly (S) This parameter allows readonly files to be deleted. + This is not normal DOS semantics, but is allowed by UNIX. This option may be useful for running applications such + as rcs, where UNIX file ownership prevents changing file + permissions, and DOS semantics prevent deletion of a read only file. Default: delete readonly = nosmbd(8) under special circumstances - decribed below. Normally, a Samba server requires that UNIX users are created for all users accessing files on this server. For sites @@ -5077,21 +6224,99 @@ CLASS="COMMAND" > delete readonly (S) deleteprinter command (G)This parameter allows readonly files to be deleted. - This is not normal DOS semantics, but is allowed by UNIX.With the introduction of MS-RPC based printer + support for Windows NT/2000 clients in Samba 2.2, it is now + possible to delete printer at run time by issuing the + DeletePrinter() RPC call. This option may be useful for running applications such - as rcs, where UNIX file ownership prevents changing file - permissions, and DOS semantics prevent deletion of a read only file.For a Samba host this means that the printer must be + physically deleted from underlying printing system. The deleteprinter command defines a script to be run which + will perform the necessary operations for removing the printer + from the print system and from smb.conf. + Default: The deleteprinter command is + automatically called with only one parameter: "printer name". Once the deleteprinter command has + been executed, delete readonly = nosmbd will reparse the smb.conf to associated printer no longer exists. + If the sharename is still valid, then smbd + will return an ACCESS_DENIED error to the client. See also addprinter command, printing, + show add + printer wizard Default: none Example: deleteprinter command = /usr/bin/removeprinter + ./. The script should return two - integers in ascii. The first should be the total disk space in blocks, + integers in ASCII. The first should be the total disk space in blocks, and the second should be the number of available blocks. An optional third return value can give the block size in bytes. The default blocksize is 1024 bytes. If domain logons = yes + , then the default behavior is to enable the domain + master parameter. If domain logons is + not enabled (the default setting), then neither will domain + master be enabled by default.Default: domain master = nodomain master = auto dos filemode (S) The default behavior in Samba is to provide + UNIX-like behavor where only the owner of a file/directory is + able to change the permissions on it. However, this behavior + is often confusing to DOS/Windows users. Enabling this parameter + allows a user who has write access to the file (by whatever + means) to modify the permissions on it. Note that a user + belonging to the group owning the file will not be allowed to + change permissions if the group is only granted read access. + Ownership of the file/directory is not changed, only the permissions + are modified. Default: dos filemode = no dos filetime resolution (S) enhanced browsing (G) This option enables a couple of enhancements to + cross-subnet browse propogation that have been added in Samba + but which are not standard in Microsoft implementations. + These enhancements are currently only available in + the HEAD Samba CVS tree (not Samba 2.2.x). The first enhancement to browse propogation consists of a regular + wildcard query to a Samba WINS server for all Domain Master Browsers, + followed by a browse synchronisation with each of the returned + DMBs. The second enhancement consists of a regular randomised browse + synchronisation with all currently known DMBs. You may wish to disable this option if you have a problem with empty + workgroups not disappearing from browse lists. Due to the restrictions + of the browse protocols these enhancements can cause a empty workgroup + to stay around forever which can be annoying. In general you should leave this option enabled as it makes + cross-subnet browse propogation much more reliable. Default: enhanced browsing = yes enumports command (G) The concept of a "port" is fairly foreign + to UNIX hosts. Under Windows NT/2000 print servers, a port + is associated with a port monitor and generally takes the form of + a local port (i.e. LPT1:, COM1:, FILE:) or a remote port + (i.e. LPD Port Monitor, etc...). By default, Samba has only one + port defined--"Samba Printer Port". Under + Windows NT/2000, all printers must have a valid port name. + If you wish to have a list of ports displayed (smbd + does not use a port name for anything) other than + the default "Samba Printer Port", you + can define enumports command to point to + a program which should generate a list of ports, one per line, + to standard output. This listing will then be used in response + to the level 1 and 2 EnumPorts() RPC. Default: no enumports command Example: enumports command = /usr/bin/listports + exec (S) However, Unix time semantics mean that the create time reported by Samba will be updated whenever a file is created or - deleted in the directory. NMAKE therefore finds all object files - in the object directory bar the last one built are out of date - compared to the directory and rebuilds them. Enabling this option + or deleted in the directory. NMAKE finds all object files in + the object directory. The timestamp of the last one built is then + compared to the timestamp of the object dircetory. If the + directory's timestamp if newer, then all object files + will be rebuilt. Enabling this option ensures directories always predate their contents and an NMAKE build will proceed as expected. always be set on a - file by Samba. This is done by bitwise 'OR'ing these bits onto + file created by Samba. This is done by bitwise 'OR'ing these bits onto the mode bits of a file that is being created or having its permissions changed. The default for this parameter is (in octal) 000. The modes in this parameter are bitwise 'OR'ed onto the file @@ -6164,7 +7523,8 @@ CLASS="COMMAND" >force directory security mode (S)force directory + security mode (S) This parameter controls what UNIX permission bits @@ -6189,7 +7549,7 @@ CLASS="PARAMETER" > parameter. To allow a user to modify all the user/group/world permissions on a - directory, with restrictions set this parameter to 000. This can be very useful. In Samba 2.0.5 and above this parameter also causes the primary group of the forced user to be used as the primary group @@ -6508,7 +7866,7 @@ CLASS="CONSTANT" > Default: getwd cache = Nogetwd cache = yes (see below). Whatever privileges this - ser has will be available to any client connecting to the guest service. + user has will be available to any client connecting to the guest service. Typically this user will exist in the password file, but will not have a valid login. The user account "ftp" is often a good choice for this parameter. If a username is specified in a given service, @@ -6589,7 +7947,7 @@ NAME="GUESTOK" CLASS="CONSTANT" >yes for - a service, then no password is equired to connect to the service. + a service, then no password is required to connect to the service. Privileges will be those of the yes for a service, then only guest connections to the service are permitted. - This parameter will have no affect if Default: homedir map = auto.homehomedir map = <empty string> Example: hosts allow (S) host msdfs (G)A synonym for this parameter is This boolean parameter is only available + if Samba has been configured and compiled with the --with-msdfs option. If set to yes, + Samba will act as a Dfs server, and allow Dfs-aware clients + to browse Dfs trees hosted on the server. See also the msdfs root share level parameter. For + more information on setting up a Dfs tree on Samba, + refer to msdfs_setup.html. + Default: host msdfs = no hosts allow (S) A synonym for this parameter is allow hosts The "mask" parameters can either be a bit length (such as 24 for a C class network) or a full netmask in dotted - decmal form. The "IP" parameters above can either be a full dotted decimal IP address or a hostname which will be looked up via - the OSes normal hostname resolution mechanisms. For example, the following line: . Default: all active interfaces except 127.0.0.1 + that are broadcast capableDefault: keepalive = 0keepalive = 300 Example: keepalive = 60keepalive = 600 kernel oplocks (G) For UNIXs that support kernel based For UNIXes that support kernel based lanman auth (G) This parameter determines whether or not smbd will + attempt to authentication users using the LANMAN password hash. + If disabled, only clients which support NT password hashes (e.g. Windows + NT/2000 clients, smbclient, etc... but not Windows 95/98 or the MS DOS + network client) will be able to connect to the Samba host. Default : lanman auth = yes level2 oplocks (S) Once one of the clients which have a read-only oplock @@ -7510,8 +8932,7 @@ NAME="LEVEL2OPLOCKS" delete any read-ahead caches. It is recommended that this parameter be turned on - to speed access to shared executables (and also to test - the code :-). For more discussions on level2 oplocks see the CIFS spec. Default: level2 oplocks = Falselevel2 oplocks = yes Example: lm announce = truelm announce = yes Default: lock directory = /tmp/sambalock directory = ${prefix}/var/locks Example: lock directory = /usr/local/samba/var/lockslock directory = /var/run/samba/locks If locking = no, all lock and unlock requests - will appear to succeed and all lock queries will indicate that the - queried lock is clear., all lock and unlock + requests will appear to succeed and all lock queries will report + that the file in question is available for locking. If log file (G) This options allows you to override the name +>This option allows you to override the name of the Samba log file (also known as the debug file). This option takes the standard substitutions, allowing @@ -7960,7 +9381,7 @@ CLASS="USERINPUT" > logon home = \\%L\%U\profilelogon home = \\%N\%U\profile This tells Samba to return the above string, with @@ -8372,8 +9793,11 @@ CLASS="PARAMETER" >lpq command as the PATH may not be - available to the server. as the $PATH + may not be available to the server. See also the Example: lpq command = /usr/bin/lpq %plpq command = /usr/bin/lpq -P%p Scripts executed in this way will be deleted upon - completion, permissions permitting. If the script generates output, output will be sent to the file specified by the parameter (see above). Note that some shells are unable to interpret scripts - containing carriage-return-linefeed instead of linefeed as + containing CR/LF instead of CR as the end-of-line marker. Magic scripts must be executable NAME MANGLING Default: mangle case = no ;1 off the ends of filenames on some CDROMS (only visible - under some UNIXs). To do this use a map of (*;1 *;). Default: mangling char (S) This controls what character is used as - the magic character in name mangling. The default is a '~' - but this may interfere with some software. Use this option to set - it to whatever you prefer. Default: mangling char = ~ Example: mangling char = ^ mangled stack (G) mangling char (S) This controls what character is used as + the magic character in name mangling. The default is a '~' + but this may interfere with some software. Use this option to set + it to whatever you prefer. Default: mangling char = ~ Example: mangling char = ^ map archive (S) guest account. Note that this can cause problems as it means that any user incorrectly typing - their password will be silently logged on as a "guest" - and + their password will be silently logged on as "guest" - and will not know the reason they cannot access files they think they should - there will have been no message given to them that they got their password wrong. Helpdesk services will @@ -9303,6 +10733,163 @@ CLASS="COMMAND" >max print jobs (S) This parameter limits the maximum number of + jobs allowable in a Samba printer queue at any given moment. + If this number is exceeded, smbd(8) will remote "Out of Space" to the client. + See all total + print jobs. + Default: max print jobs = 1000 Example: max print jobs = 5000 max protocol (G) The value of the parameter (a string) is the highest + protocol level that will be supported by the server. Possible values are : CORE: Earliest version. No + concept of user names. COREPLUS: Slight improvements on + CORE for efficiency. LANMAN1: First modern version of the protocol. Long filename + support. LANMAN2: Updates to Lanman1 protocol. + NT1: Current up to date version of + the protocol. Used by Windows NT. Known as CIFS. Normally this option should not be set as the automatic + negotiation phase in the SMB protocol takes care of choosing + the appropriate protocol. See also min + protocol Default: max protocol = NT1 Example: max protocol = LANMAN1 max smbd processes (G) This parameter limits the maximum number of + smbd(8) + processes concurrently running on a system and is intended + as a stop gap to prevent degrading service to clients in the event + that the server has insufficient resources to handle more than this + number of connections. Remember that under normal operating + conditions, each user will have an smbd associated with him or her + to handle connections to all shares from a given host. + Default: max smbd processes = 0 ## no limit Example: max smbd processes = 1000 max ttl (G) min print space (S) min passwd length (G)This sets the minimum amount of free disk - space that must be available before a user will be able to spool - a print job. It is specified in kilobytes. The default is 0, which - means a user can always spool a print job. See also the Synonym for printing - parameter. Default: min print space = 0 Example: min print space = 2000 min passwd length (G)Synonym for min password lengthmin password length. This option sets the minimum length in characters - of a plaintext password than smbd will accept when performing + of a plaintext password that smbd will accept when performing UNIX password changing. See also min print space (S) This sets the minimum amount of free disk + space that must be available before a user will be able to spool + a print job. It is specified in kilobytes. The default is 0, which + means a user can always spool a print job. See also the printing + parameter. Default: min print space = 0 Example: min print space = 2000 min protocol (G) The value of the parameter (a string) is the + lowest SMB protocol dialect than Samba will support. Please refer + to the max protocol + parameter for a list of valid protocol names and a brief description + of each. You may also wish to refer to the C source code in + source/smbd/negprot.c for a listing of known protocol + dialects supported by clients. If you are viewing this parameter as a security measure, you should + also refer to the lanman + auth parameter. Otherwise, you should never need + to change this parameter. Default : min protocol = CORE Example : min protocol = NT1 # disable DOS + clients min wins ttl (G) msdfs root (S) This boolean parameter is only available if + Samba is configured and compiled with the --with-msdfs option. If set to yes>, + Samba treats the share as a Dfs root and allows clients to browse + the distributed file system tree rooted at the share directory. + Dfs links are specified in the share directory by symbolic + links of the form msdfs:serverA\shareA,serverB\shareB + and so on. For more information on setting up a Dfs tree + on Samba, refer to msdfs_setup.html + . See also host msdfs + Default: msdfs root = no name resolve order (G) This option is used by the programs in the Samba - suite to determine what naming services and in what order to resolve - host names to IP addresses. The option takes a space separated - string of different name resolution options. The options are :"lmhosts", "host", "wins" and "bcast". They cause names to be resolved as follows : You should not need to ever disable this parameter. Default: nt support = yesnt smb support = yes ole locking compatibility (G) This parameter allows an administrator to turn - off the byte range lock manipulation that is done within Samba to - give compatibility for OLE applications. Windows OLE applications - use byte range locking as a form of inter-process communication, by - locking ranges of bytes around the 2^32 region of a file range. This - can cause certain UNIX lock managers to crash or otherwise cause - problems. Setting this parameter to no means you - trust your UNIX lock manager to handle such cases correctly. Default: ole locking compatibility = yes only guest (S) A synonym for guest only. only user (S) user - list will be allowed. By default this option is disabled so a client - can supply a username to be used by the server. user list and is only really + useful in shave level + security. Note that this also means Samba won't try to deduce usernames from the service name. This can be annoying for @@ -10066,70 +11725,44 @@ CLASS="COMMAND" > oplocks (S) ole locking compatibility (G)This boolean option tells smbd whether to - issue oplocks (opportunistic locks) to file open requests on this - share. The oplock code can dramatically (approx. 30% or more) improve - the speed of access to files on Samba servers. It allows the clients - to aggressively cache files ocally and you may want to disable this - option for unreliable network environments (it is turned on by - default in Windows NT Servers). For more information see the file - Speed.txt in the Samba docs/ - directory.This parameter allows an administrator to turn + off the byte range lock manipulation that is done within Samba to + give compatibility for OLE applications. Windows OLE applications + use byte range locking as a form of inter-process communication, by + locking ranges of bytes around the 2^32 region of a file range. This + can cause certain UNIX lock managers to crash or otherwise cause + problems. Setting this parameter to no means you + trust your UNIX lock manager to handle such cases correctly. Oplocks may be selectively turned off on certain files on - a per share basis. See the veto oplock filesDefault: ole locking compatibility = yes parameter. On some systems - oplocks are recognized by the underlying operating system. This - allows data synchronization between all access to oplocked files, - whether it be via Samba or NFS or a local UNIX process. See the - kernel oplocks parameter for details. only guest (S)See also the kernel - oplocks and A synonym for level2 oplocks guest only parameters. Default: oplocks = yes . This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too quickly when that client issues an SMB that can cause an oplock - break request, then the client redirector can fail and not respond + break request, then the network client can fail and not respond to the break request. This tuning parameter (which is set in milliseconds) is the amount of time Samba will wait before sending an oplock break request to such (broken) clients. Default: oplock break wait time = 10oplock break wait time = 0 os level (G) oplocks (S)This integer value controls what level Samba - advertises itself as for browse elections. The value of this - parameter determines whether nmbd(8)This boolean option tells smbd whether to + issue oplocks (opportunistic locks) to file open requests on this + share. The oplock code can dramatically (approx. 30% or more) improve + the speed of access to files on Samba servers. It allows the clients + to aggressively cache files locally and you may want to disable this + option for unreliable network environments (it is turned on by + default in Windows NT Servers). For more information see the file + Speed.txt in the Samba docs/ - has a chance of becoming a local master browser for the Oplocks may be selectively turned off on certain files with a + share. See the WORKGROUP veto oplock files parameter. On some systems + oplocks are recognized by the underlying operating system. This + allows data synchronization between all access to oplocked files, + whether it be via Samba or NFS or a local UNIX process. See the + kernel oplocks parameter for details. See also the kernel + oplocks and level2 oplocks in the local broadcast area. The default is - zero, which means parameters. Default: nmbd will lose elections to - Windows machines. See oplocks = yes os level (G) This integer value controls what level Samba + advertises itself as for browse elections. The value of this + parameter determines whether nmbd(8) + has a chance of becoming a local master browser for the WORKGROUP in the local broadcast area. Note :By default, Samba will win + a local master browsing election over all Microsoft operating + systems except a Windows NT 4.0/2000 Domain Controller. This + means that a misconfigured Samba host can effectively isolate + a subnet for browsing purposes. See BROWSING.txt in the - Samba BROWSING.txt + in the Samba docs/ directory for details. directory + for details. Default: os2 driver map (G) The parameter is used to define the absolute + path to a file containing a mapping of Windows NT printer driver + names to OS/2 printer driver names. The format is: <nt driver name> = <os2 driver + name>.<device name> For example, a valid entry using the HP LaserJet 5 + printer driver woudl appear as HP LaserJet 5L = LASERJET.HP + LaserJet 5L. The need for the file is due to the printer driver namespace + problem described in the Samba + Printing HOWTO. For more details on OS/2 clients, please + refer to the OS2-Client-HOWTO + containing in the Samba documentation. Default: os2 driver map = <empty string> + panic action (G) If the send string in any part of the chat sequence is a fullstop ".", then no string is sent. Similarly, - is the expect string is a fullstop then no string is expected. Note that if the Default: passwd chat = *old*password* %o\n *new* - password* %n\n *new*password* %n\n *changed*passwd chat = *new*password* %n\n + *new*password* %n\n *changed* Example: passwd chat debug = no Example: passwd chat debug = yes This parameter defines the maximum number of characters that may be upper case in passwords. you can get Samba to do all its username/password validation via a remote server. This options sets the name of the password server to use. +>This option sets the name of the password server to use. It must be a NetBIOS name, so if the machine's NetBIOS name is - different from its internet name then you may have to add its NetBIOS + different from its Internet name then you may have to add its NetBIOS name to the lmhosts file which is stored in the same directory as the The password server much be a machine capable of using - the "LM1.2X002" or the "LM NT 0.12" protocol, and it must be in + the "LM1.2X002" or the "NT LM 0.12" protocol, and it must be in user level security mode. , which means the Samba server will use the incoming - client as the passwordserver. If you use this then you better - trust your clients, and you better restrict them with hosts allow! If the domain, then the list of machines in this option must be a list of Primary or Backup Domain controllers for the - Domain or the character '*', as the Samba server is cryptographicly - in that domain, and will use cryptographicly authenticated RPC calls + Domain or the character '*', as the Samba server is effectively + in that domain, and will use cryptographically authenticated RPC calls to authenticate the user logging on. The advantage of using security = domain posix locking (S) The smbd(8) + daemon maintains an database of file locks obtained by SMB clients. + The default behavior is to map this internal database to POSIX + locks. This means that file locks obtained by SMB clients are + consistent with those seen by POSIX compliant applications accessing + the files via a non-SMB method (e.g. NFS or local file access). + You should never need to disable this parameter. Default: posix locking = yes postexec (S) Default: preferred master = nopreferred master = auto preload Synonym for This is a list of services that you want to be + automatically added to the browse lists. This is most useful + for homes and printers services that would otherwise not be + visible. Note that if you just want all printers in your + printcap file loaded then the auto servicesload printers. option is easier. Default: no preloaded services Example: preload = fred lp colorlp derault case +>default case See the section on NAME - MANGLING" for a fuller discussion. Note that printing may fail on some UNIXs from the +>Note that printing may fail on some UNIXes from the nobody printer admin (S) This is a list of users that can do anything to - printers via the remote administration interfaces offered by MSRPC - (usually using a NT workstation). Note that the root user always - has admin rights. Default: printer admin = <empty string> - Example: printer admin = admin, @staff printcap name (G) printer (S) printer admin (S)This parameter specifies the name of the printer - to which print jobs spooled through a printable service will be sent. If specified in the [global] section, the printer - name given will be used for any printable service that does - not have its own printer name specified.This is a list of users that can do anything to + printers via the remote administration interfaces offered by MS-RPC + (usually using a NT workstation). Note that the root user always + has admin rights. Default: none (but may be lp - on many systems) Default: printer admin = <empty string> + Example: printer name = laserwriterprinter admin = admin, @staff printer driver (S) Note :This is a depreciated + parameter and will be removed in the next major release + following version 2.2. Please see the instructions in + PRINTER_DRIVER2.txt in the docs + of the Samba distribution for more information + on the new method of loading printer drivers onto a Samba server. + This option allows you to control the string that clients receive when they ask the server for the printer driver - associated with a printer. If you are using Windows95 or WindowsNT + associated with a printer. If you are using Windows95 or Windows NT then you can use this to automate the setup of printers on your system. option set and the client will give you a list of printer drivers. The appropriate strings are - shown in a scrollbox after you have chosen the printer manufacturer. See also printer driver file (G) Note :This is a depreciated + parameter and will be removed in the next major release + following version 2.2. Please see the instructions in + PRINTER_DRIVER2.txt in the docs + of the Samba distribution for more information + on the new method of loading printer drivers onto a Samba server. + This parameter tells Samba where the printer driver definition file, used when serving drivers to Windows 95 clients, is to be found. If this is not set, the default is : printer driver location (S) Note :This is a depreciated + parameter and will be removed in the next major release + following version 2.2. Please see the instructions in + PRINTER_DRIVER2.txt in the docs + of the Samba distribution for more information + on the new method of loading printer drivers onto a Samba server. + This parameter tells clients of a particular printer share where to find the printer driver files for the automatic installation of drivers for Windows 95 machines. If Samba is set up @@ -11673,12 +13483,40 @@ NAME="PRINTERNAME" >printer name (S) This parameter specifies the name of the printer + to which print jobs spooled through a printable service will be sent. If specified in the [global] section, the printer + name given will be used for any printable service that does + not have its own printer name specified. Default: none (but may be lp + on many systems) Example: printer name = laserwriter printer (S) Synonym for printer printer name. private dir(G) protocol (G)The Synonym for private dirmax protocol parameter - allows an administator to define a directory path used to hold the - various databases Samba will use to store things like a the machine - trust account information when acting as a domain member (i.e. where - the secrets.tdb file will be located), where the passdb.tbd file - will stored in the case of using the experiemental tdbsam support, - etc... Default: private dir = <compile time location - of smbpasswd> Example: private dir = /etc/smbprivate . protocol (G) The value of the parameter (a string) is the highest - protocol level that will be supported by the server. Possible values are : CORE: Earliest version. No - concept of user names. COREPLUS: Slight improvements on - CORE for efficiency. LANMAN1: First modern version of the protocol. Long filename - support. LANMAN2: Updates to Lanman1 protocol. - NT1: Current up to date version of - the protocol. Used by Windows NT. Known as CIFS. Normally this option should not be set as the automatic - negotiation phase in the SMB protocol takes care of choosing - the appropriate protocol. Default: protocol = NT1 Example: protocol = LANMAN1 public (S) public (S)Synonym for This parameter makes the use of macro expansions that rely - on the username (%U, %G, etc) consistant. NT 4.0 + on the username (%U, %G, etc) consistent. NT 4.0 likes to use anonymous connections when refreshing the share list, and this is a way to work around that.. Default: root postexec = <empty string> + parameter except that the command is run as root. This - is useful for mounting filesystems - (such as cdroms) after a connection is closed.See also . Default: root preexec = <empty string> + . Default: root preexec close = no The different settings will now be explained.. . shared mem size (G) It specifies the size of the shared memory (in - bytes) to use between smbd(8) - processes. This parameter defaults to one megabyte of shared - memory. It is possible that if you have a large erver with many - files open simultaneously that you may need to increase this - parameter. Signs that this parameter is set too low are users - reporting strange problems trying to save files (locking errors) - and error messages in the smbd log looking like ERROR - smb_shm_alloc : alloc of XX bytes failed. If your OS refuses the size that Samba asks for then - Samba will try a smaller size, reducing by a factor of 0.8 until - the OS accepts it. Default: shared mem size = 1048576 Example: shared mem size = 5242880 ; Set to 5mb for a - large number of files. short preserve case (S) smb passwd file (G) show add printer wizard (G)This option sets the path to the encrypted - smbpasswd file. By default the path to the smbpasswd file - is compiled into Samba.With the introduction of MS-RPC based printing support + for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will + appear on Samba hosts in the share listing. Normally this folder will + contain an icon for the MS Add Printer Wizard (APW). However, it is + possible to disable this feature regardless of the level of privilege + of the connected user. Default: smb passwd file= <compiled - default>Under normal circumstances, the Windows NT/2000 client will + open a handle on the printer server with OpenPrinterEx() asking for + Administrator privileges. If the user does not have administrative + access on the print server (i.e is not root or a member of the + printer admin group), the OpenPrinterEx() + call fails and the clients another open call with a request for + a lower privilege level. This should succeed, however the APW + icon will not be displayed. Disabling the show add printer wizard + parameter will always cause the OpenPrinterEx() on the server + to fail. Thus the APW icon will never be displayed. Note :This does not prevent the same user from having + administrative privilege on an individual printer. See also addprinter + command, deleteprinter command, printer admin Example: Default :smb passwd file = /usr/samba/private/smbpasswd - show add printer wizard = yes smbrun (G) smb passwd file (G)This sets the full path to the smbrun - binary. This defaults to the value in the Makefile. You must get this path right for many services - to work correctly. You should not need to change this parameter so - long as Samba is installed correctly.This option sets the path to the encrypted + smbpasswd file. By default the path to the smbpasswd file + is compiled into Samba. Default: smbrun=<compiled default> +>smb passwd file = ${prefix}/private/smbpasswd Example: smbrun = /usr/local/samba/bin/smbrun +>smb passwd file = /etc/samba/smbpasswd LOG_DEBUG. This paramter sets the threshold for sending messages +>This parameter sets the threshold for sending messages to syslog. Only messages with debug level less than this value will be sent to syslog. total print jobs (G) This parameter accepts an integer value which defines + a limit on the maximum number of print jobs that will be accepted + system wide at any given time. If a print job is submitted + by a client which will exceed this number, then smbd will return an + error indicating that no space is available on the server. The + default value of 0 means that no such limit exists. This parameter + can be used to prevent a server from exceeding its capacity and is + designed as a printing throttle. See also + max print jobs. + Default: total print jobs = 0 Example: total print jobs = 5000 unix password sync (G) unix realname (G) This boolean parameter when set causes samba - to supply the real name field from the unix password file to - the client. This isuseful for setting up mail clients and WWW - browsers on systems used by more than one person. Default: unix realname = no update encrypted (G) Note that searching though a groups database can take - quite some time, snd some clients may time out during the + quite some time, and some clients may time out during the search. See the section Default: The guest account if a guest service, - else the name of the service. Examples: If this parameter is set to non-zero the behavior changes. This parameter is a number that specifies the number of uppercase - combinations to try whilst trying to determine the UNIX user name. The + combinations to try while trying to determine the UNIX user name. The higher the number the more combinations will be tried, but the slower the discovery of usernames will be. Use this parameter when you have strange usernames on your UNIX machine, such as winbind cache time valid chars (G)NOTE: this parameter is only - available in Samba 3.0. This parameter specifies the number of seconds the - winbindd(8) daemon will cache - user and group information before querying a Windows NT server - again.The option allows you to specify additional + characters that should be considered valid by the server in + filenames. This is particularly useful for national character + sets, such as adding u-umlaut or a-ring. Default: winbind cache type = 15 winbind gid The option takes a list of characters in either integer + or character form with spaces between them. If you give two + characters with a colon between them then it will be taken as + an lowercase:uppercase pair. NOTE: this parameter is only - available in Samba 3.0.If you have an editor capable of entering the characters + into the config file then it is probably easiest to use this + method. Otherwise you can specify the characters in octal, + decimal or hexadecimal form using the usual C notation. The winbind gid parameter specifies the range of group - ids that are allocated by the winbindd(8) daemon. This range of group ids should have no - existing local or nis groups within it as strange conflicts can - occur otherwise.For example to add the single character 'Z' to the charset + (which is a pointless thing to do as it's already there) you could + do one of the following Default: winbind gid = <empty string> - Example: winbind gid = 10000-20000 winbind uid NOTE: this parameter is only - available in Samba 3.0. The winbind gid parameter specifies the range of group - ids that are allocated by the winbindd(8) daemon. This range of ids should have no - existing local or nis users within it as strange conflicts can - occur otherwise. Default: winbind uid = <empty string> - Example: winbind uid = 10000-20000 valid chars (G) The option allows you to specify additional - characters that should be considered valid by the server in - filenames. This is particularly useful for national character - sets, such as adding u-umlaut or a-ring. The option takes a list of characters in either integer - or character form with spaces between them. If you give two - characters with a colon between them then it will be taken as - an lowercase:uppercase pair. If you have an editor capable of entering the characters - into the config file then it is probably easiest to use this - method. Otherwise you can specify the characters in octal, - decimal or hexadecimal form using the usual C notation. For example to add the single character 'Z' to the charset - (which is a pointless thing to do as it's already there) you could - do one of the following valid chars = Z - valid chars = z:Z - valid chars = 0132:0172 - valid chars = Z + valid chars = z:Z + valid chars = 0132:0172 + The last two examples above actually add two characters, @@ -15603,6 +17297,49 @@ CLASS="COMMAND" > vfs object (S) This parameter specifies a shared object file that + is used for Samba VFS I/O operations. By default, normal + disk I/O operations are used but these can be overloaded + with a VFS object. The Samba VFS layer is new to Samba 2.2 and + must be enabled at compile time with --with-vfs. Default : no value vfs options (S) This parameter allows parameters to be passed + to the vfs layer at initialisation time. The Samba VFS layer + is new to Samba 2.2 and must be enabled at compile time + with --with-vfs. See also vfs object. Default : no value volume (S) wins proxy (G) winbind cache timeThis is a boolean that controls if NOTE: this parameter is only + available in Samba 3.0. This parameter specifies the number of seconds the + nmbd(8) will respond to broadcast name - queries on behalf of other hosts. You may need to set this - to yes for some older clients.winbindd(8) daemon will cache + user and group information before querying a Windows NT server + again.Default: wins proxy = nowinbind cache type = 15 wins server (G) winbind gidThis specifies the IP address (or DNS name: IP - address for preference) of the WINS server that NOTE: this parameter is only + available in Samba 3.0. The winbind gid parameter specifies the range of group + ids that are allocated by the nmbd(8) should register with. If you have a WINS server on - your network then you should set this to the WINS server's IP. winbindd(8) daemon. This range of group ids should have no + existing local or nis groups within it as strange conflicts can + occur otherwise. You should point this at your WINS server if you have a - multi-subnetted network. Default: winbind gid = <empty string> + Example: winbind gid = 10000-20000 winbind separatorNOTE. You need to set up Samba to point - to a WINS server if you have multiple subnets and wish cross-subnet - browsing to work correctly. NOTE: this parameter is only + available in Samba 3.0. See the documentation file This parameter allows an admin to define the character + used when listing a username of the form of DOMAIN + \user. This parameter + is only applicable when using the BROWSING.txt - in the docs/ directory of your Samba source distribution. pam_winbind.so + and nss_winbind.so modules for UNIX services. + Default: Example: winbind separator = \ Example: winbind separator = + winbind uid not enabledNOTE: this parameter is only + available in Samba 3.0. The winbind gid parameter specifies the range of group + ids that are allocated by the winbindd(8) daemon. This range of ids should have no + existing local or nis users within it as strange conflicts can + occur otherwise. Default: winbind uid = <empty string> + Example: wins server = 192.9.200.1winbind uid = 10000-20000 wins proxy (G) This is a boolean that controls if nmbd(8) will respond to broadcast name + queries on behalf of other hosts. You may need to set this + to yes for some older clients. Default: wins proxy = no wins server (G) This specifies the IP address (or DNS name: IP + address for preference) of the WINS server that nmbd(8) should register with. If you have a WINS server on + your network then you should set this to the WINS server's IP. You should point this at your WINS server if you have a + multi-subnetted network. NOTE. You need to set up Samba to point + to a WINS server if you have multiple subnets and wish cross-subnet + browsing to work correctly. See the documentation file BROWSING.txt + in the docs/ directory of your Samba source distribution. Default: not enabled Example: wins server = 192.9.200.1 wins support (G)This controls what workgroup your server will appear to be in when queried by clients. Note that this parameter also controls the Domain name used with the security=domainwrite cache size (S) If this integer parameter is set to non-zero value, + Samba will create an in-memory cache for each oplocked file + (it does not do this for + non-oplocked files). All writes that the client does not request + to be flushed directly to disk will be stored in this cache if possible. + The cache is flushed onto disk when a write comes in whose offset + would not fit into the cache or when the file is closed by the client. + Reads for the file are also served from this cache if the data is stored + within it. This cache allows Samba to batch client writes into a more + efficient write size for RAID disks (ie. writes may be tuned to + be the RAID stripe size) and can improve performance on systems + where the disk subsystem is a bottleneck but there is free + memory for userspace programs. The integer parameter specifies the size of this cache + (per oplocked file) in bytes. Default: write cache size = 0 Example: write cache size = 262144 for a 256k cache size per file. write list (S) write cache size (S) This integer parameter (new with Samba 2.0.7) - if set to non-zero causes Samba to create an in-memory cache for - each oplocked file (it does not do this for - non-oplocked files). All writes that the client does not request - to be flushed directly to disk will be stored in this cache if possible. - The cache is flushed onto disk when a write comes in whose offset - would not fit into the cache or when the file is closed by the client. - Reads for the file are also served from this cache if the data is stored - within it. This cache allows Samba to batch client writes into a more - efficient write size for RAID disks (ie. writes may be tuned to - be the RAID stripe size) and can improve performance on systems - where the disk subsystem is a bottleneck but there is free - memory for userspace programs. The integer parameter specifies the size of this cache - (per oplocked file) in bytes. Default: write cache size = 0 Example: write cache size = 262144 for a 256k cache size per file. write ok (S) WARNINGS VERSION SEE ALSO AUTHOR nmblookupsmbcacls {//server/share} {filename} [-U username] [-A acls] [-M acls] [-D acls] [-S acls] [-C name] [-G name] [-n] [-h] smbclient {servicename} [-b <buffer size>] [-d debuglevel] [-D Directory] [-S server] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E <terminal code>] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan] [password] {servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-S server] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E <terminal code>] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan] name resolve order (G) -R <name resolve order>This option is used by the programs in the Samba diff --git a/docs/htmldocs/smbmnt.8.html b/docs/htmldocs/smbmnt.8.html index 051684a291b..88a28b8a696 100644 --- a/docs/htmldocs/smbmnt.8.html +++ b/docs/htmldocs/smbmnt.8.html @@ -14,7 +14,7 @@ VLINK="#840084" ALINK="#0000FF" > smbmnt smbumount {mount-point} [-s <share>] [-r] [-u <uid>] [-g <gid>] [-f <mask>] [-d <mask>] smbmnt {mount-point} [-s <share>] [-r] [-u <uid>] [-g <gid>] [-f <mask>] [-d <mask>] [-o <options>] DESCRIPTION OPTIONSspecify the octal directory mask applied -o options list of options that are passed as-is to smbfs, if this + command is run on a 2.4 or higher linux kernel. + AUTHOR Volker Lendecke, Andrew Tridgell, Michael H. Warfield + and others. The current maintainer of smbfs and the userspace tools Urban Widmark. . + The SAMBA Mailing list + is the preferred place to ask questions regarding these programs. + The conversion of this manpage for Samba 2.2 was performed by Gerald Carter Name smbmount -- mount and smbfs filesystem smbmount -- mount an smbfs filesystem command when using the "-t smb" option. The kernel must support the smbfs filesystem. Options to smbmount are specified as a comma separated list - of key=value pairs.Options to smbmount are specified as a comma separated + list of key=value pairs. It is possible to send options other + than those listed here, assuming that smbfs supports them. If + you get mount failures, check your kernel log for errors on + unknown options. smbmount is a daemon. After mounting it keeps running until + the mounted smbfs is umounted. It will log things that happen + when in daemon mode using the "machine name" smbmount, so + typically this output will end up in log.smbmount. The + smbmount process may also be called mount.smbfs. OPTIONS specifies the username to connect as. If - this is not given then the environment variable $USER is used. This option can also take the - form "user%password" or "user/workgroup" or - "user/workgroup%password" to allow the password and workgroup + this is not given, then the environment variable USER is used. This option can also take the + form "user%password" or "user/workgroup" or + "user/workgroup%password" to allow the password and workgroup to be specified as part of the username. password=<arg> specifies the SMB password. If not given then - specifies the SMB password. If this + option is not given then the environment variable + PASSWD is used. If it can find + no password smbmount will prompt for a passeword, unless - the guest option is given. will prompt + for a passeword, unless the guest option is + given. credentials=<filename> specifies a file that contains a username + and/or password. The format of the file is: username = <value> + password = <value> + + This is preferred over having passwords in plaintext in a + shared file, such as /etc/fstab. Be sure to protect any + credentials file properly. + netbiosname=<arg> uid=<arg>sets the uid that files will be mounted as. +>sets the uid that will own all files on + the mounted filesystem. It may be specified as either a username or a numeric uid. gid=<arg>sets the gid that files will be mounted as. +>sets the gid that will own all files on + the mounted filesystem. It may be specified as either a groupname or a numeric gid. mount read-write iocharset=<arg> sets the charset used by the linux side for codepage + to charset translations (NLS). Argument should be the + name of a charset, like iso8859-1. (Note: only kernel + 2.4.0 or later) + codepage=<arg> sets the codepage the server uses. See the iocharset + option. Example value cp850. (Note: only kernel 2.4.0 + or later) + ttl=<arg> how long a directory listing is cached in milliseconds + (also affects visibility of file size and date + changes). A higher value means that changes on the + server take longer to be noticed but it can give + better performance on large directories, especially + over long distances. Default is 1000ms but something + like 10000ms (10 seconds) is probably more reasonable + in many cases. + (Note: only kernel 2.4.2 or later) + ENVIRONMENT VARIABLES The variable USER may contain the username of the + person using the client. This information is used only if the + protocol level is high enough to support session-level + passwords. The variable can be used to set both username and + password by using the format username%password. The variable PASSWD may contain the password of the + person using the client. This information is used only if the + protocol level is high enough to support session-level + passwords. The variable PASSWD_FILE may contain the pathname of + a file to read the password from. A single line of input is + read and used as password. BUGS Not many known smbmount bugs. But one smbfs bug is + important enough to mention here anyway: Mounts sometimes stop working. This is usually + caused by smbmount terminating. Since smbfs needs smbmount to + reconnect when the server disconnects, the mount will go + dead. A re-mount normally fixes this. At least 2 ways to + trigger this bug are known. Note that the typical response to a bugreport is suggestion + to try the latest version first. So please try doing that first, + and always include which versions you use of relevant software + when reporting bugs (minimum: samba, kernel, distribution) SEE ALSO Documentation/filesystems/smbfs.txt in the kernel source tree + may contain additional options and information. AUTHOR Volker Lendecke, Andrew Tridgell, Michael H. Warfield + and others. The current maintainer of smbfs and the userspace tools Urban Widmark . + The SAMBA Mailing list + is the preferred place to ask questions regarding these programs. + The conversion of this manpage for Samba 2.2 was performed by Gerald Carter -R name resolve orderThis option allows the user of smbclient to determine +>This option allows the user of smbpasswd to determine what name resolution services to use when looking up the NetBIOS name of the host being connected to. smbspool Name smbspool -- send print file to an SMB printer nmblookup -- send print file to an SMB printer AUTHOR Volker Lendecke, Andrew Tridgell, Michael H. Warfield + and others.The current maintainer of smbfs and the userspace tools Urban Widmark. . + The SAMBA Mailing list + is the preferred place to ask questions regarding these programs. + The conversion of this manpage for Samba 2.2 was performed by Gerald Carter Unifed Logons between Windows NT and UNIX using WinbindUnifed Logons between Windows NT and UNIX using Winbind Abstract Integration of UNIX and Microsoft Windows NT through + a unified logon has been considered a "holy grail" in heterogeneous + computing environments for a long time. We present winbind + , a component of the Samba suite of programs as a + solution to the unied logon problem. Winbind uses a UNIX implementation + of Microsoft RPC calls, Pluggable Authentication Modules, and the Name + Service Switch to allow Windows NT domain users to appear and operate + as UNIX users on a UNIX machine. This paper describes the winbind + system, explaining the functionality it provides, how it is configured, + and how it works internally. Introduction It is well known that UNIX and Microsoft Windows NT have + different models for representing user and group information and + use different technologies for implementing them. This fact has + made it difficult to integrate the two systems in a satisfactory + manner. One common solution in use today has been to create + identically named user accounts on both the UNIX and Windows systems + and use the Samba suite of programs to provide file and print services + between the two. This solution is far from perfect however, as + adding and deleting users on both sets of machines becomes a chore + and two sets of passwords are required both of which which + can lead to synchronization problems between the UNIX and Windows + systems and confusion for users. We divide the unifed logon problem for UNIX machines into + three smaller problems: Obtaining Windows NT user and group information + Authenticating Windows NT users + Password changing for Windows NT users + Ideally, a prospective solution to the unified logon problem + would satisfy all the above components without duplication of + information on the UNIX machines and without creating additional + tasks for the system administrator when maintaining users and + groups on either system. The winbind system provides a simple + and elegant solution to all three components of the unifed logon + problem. What Winbind Provides Winbind unifies UNIX and Windows NT account management by + allowing a UNIX box to become a full member of a NT domain. Once + this is done the UNIX box will see NT users and groups as if + they were native UNIX users and groups, allowing the NT domain + to be used in much the same manner that NIS+ is used within + UNIX-only environments. The end result is that whenever any + program on the UNIX machine asks the operating system to lookup + a user or group name, the query will be resolved by asking the + NT domain controller for the specied domain to do the lookup. + Because Winbind hooks into the operating system at a low level + (via the NSS name resolution modules in the C library) this + redirection to the NT domain controller is completely + transparent. Users on the UNIX machine can then use NT user and group + names as they would use "native" UNIX names. They can chown files + so that they are owned by NT domain users or even login to the + UNIX machine and run a UNIX X-Window session as a domain user. The only obvious indication that Winbind is being used is + that user and group names take the form DOMAIN\user and + DOMAIN\group. This is necessary as it allows Winbind to determine + that redirection to a domain controller is wanted for a particular + lookup and which trusted domain is being referenced. Additionally, Winbind provides a authentication service + that hooks into the Pluggable Authentication Modules (PAM) system + to provide authentication via a NT domain to any PAM enabled + applications. This capability solves the problem of synchronizing + passwords between systems as all passwords are stored in a single + location (on the domain controller). Target Uses Winbind is targeted at organizations that have an + existing NT based domain infrastructure into which they wish + to put UNIX workstations or servers. Winbind will allow these + organizations to deploy UNIX workstations without having to + maintain a separate account infrastructure. This greatly simplies + the administrative overhead of deploying UNIX workstations into + a NT based organization. Another interesting way in which we expect Winbind to + be used is as a central part of UNIX based appliances. Appliances + that provide file and print services to Microsoft based networks + will be able to use Winbind to provide seamless integration of + the appliance into the domain. How Winbind Works The winbind system is designed around a client/server + architecture. A long running winbindd daemon + listens on a UNIX domain socket waiting for requests + to arrive. These requests are generated by the NSS and PAM + clients and processed sequentially. The technologies used to implement winbind are described + in detail below. Microsoft Remote Procedure Calls Over the last two years, efforts have been underway + by various Samba Team members to decode various aspects of + the Microsoft Remote Procedure Call (MSRPC) system. This + system is used for most network related operations between + Windows NT machines including remote management, user authentication + and print spooling. Although initially this work was done + to aid the implementation of Primary Domain Controller (PDC) + functionality in Samba, it has also yielded a body of code which + can be used for other purposes. Winbind uses various MSRPC calls to enumerate domain users + and groups and to obtain detailed information about individual + users or groups. Other MSRPC calls can be used to authenticate + NT domain users and to change user passwords. By directly querying + a Windows PDC for user and group information, winbind maps the + NT account information onto UNIX user and group names. Name Service Switch The Name Service Switch, or NSS, is a feature that is + present in many UNIX operating systems. It allows system + information such as hostnames, mail aliases and user information + to be resolved from dierent sources. For example, a standalone + UNIX workstation may resolve system information from a series of + flat files stored on the local lesystem. A networked workstation + may first attempt to resolve system information from local files, + then consult a NIS database for user information or a DNS server + for hostname information. The NSS application programming interface allows winbind + to present itself as a source of system information when + resolving UNIX usernames and groups. Winbind uses this interface, + and information obtained from a Windows NT server using MSRPC + calls to provide a new source of account enumeration. Using standard + UNIX library calls, one can enumerate the users and groups on + a UNIX machine running winbind and see all users and groups in + a NT domain plus any trusted domain as though they were local + users and groups. The primary control le for NSS is /etc/nsswitch.conf + . When a UNIX application makes a request to do a lookup + the C library looks in /etc/nsswitch.conf + for a line which matches the service type being requested, for + example the "passwd" service type is used when user or group names + are looked up. This config line species which implementations + of that service should be tried andin what order. If the passwd + config line is: passwd: files example then the C library will first load a module called + /lib/libnss_files.so followed by + the module /lib/libnss_example.so. The + C library will dynamically load each of these modules in turn + and call resolver functions within the modules to try to resolve + the request. Once the request is resolved the C library returns the + result to the application. This NSS interface provides a very easy way for Winbind + to hook into the operating system. All that needs to be done + is to put libnss_winbind.so in /lib/ + then add "winbind" into /etc/nsswitch.conf at + the appropriate place. The C library will then call Winbind to + resolve user and group names. Pluggable Authentication Modules Pluggable Authentication Modules, also known as PAM, + is a system for abstracting authentication and authorization + technologies. With a PAM module it is possible to specify different + authentication methods for dierent system applications without + having to recompile these applications. PAM is also useful + for implementing a particular policy for authorization. For example, + a system administrator may only allow console logins from users + stored in the local password file but only allow users resolved from + a NIS database to log in over the network. Winbind uses the authentication management and password + management PAM interface to integrate Windows NT users into a + UNIX system. This allows Windows NT users to log in to a UNIX + machine and be authenticated against a suitable Primary Domain + Controller. These users can also change their passwords and have + this change take eect directly on the Primary Domain Controller. + PAM is congured by providing control files in the directory + /etc/pam.d/ for each of the services that + require authentication. When an authentication request is made + by an application the PAM code in the C library looks up this + control file to determine what modules to load to do the + authentication check and in what order. This interface makes adding + a new authentication service for Winbind very easy, all that needs + to be done is that the pam_winbind.so module + is copied to /lib/security/ and the pam + control files for relevant services are updated to allow + authentication via winbind. See the PAM documentation + for more details. User and Group ID Allocation When a user or group is created under Windows NT + is it allocated a numerical relative identier (RID). This is + slightly dierent to UNIX which has a range of numbers which are + used to identify users, and the same range in which to identify + groups. It is winbind's job to convert RIDs to UNIX id numbers and + vice versa. When winbind is congured it is given part of the UNIX + user id space and a part of the UNIX group id space in which to + store Windows NT users and groups. If a Windows NT user is + resolved for the first time, it is allocated the next UNIX id from + the range. The same process applies for Windows NT groups. Over + time, winbind will have mapped all Windows NT users and groups + to UNIX user ids and group ids. The results of this mapping are stored persistently in + a ID mapping database held in a tdb database). This ensures that + RIDs are mapped to UNIX IDs in a consistent way. Result Caching An active system can generate a lot of user and group + name lookups. To reduce the network cost of these lookups winbind + uses a caching scheme based on the SAM sequence number supplied + by NT domain controllers. User or group information returned + by a PDC is cached by winbind along with a sequence number also + returned by the PDC. This sequence number is incremented by + Windows NT whenever any user or group information is modied. If + a cached entry has expired, the sequence number is requested from + the PDC and compared against the sequence number of the cached entry. + If the sequence numbers do not match, then the cached information + is discarded and up to date information is requested directly + from the PDC. Installation and Configuration The easiest way to install winbind is by using the packages + provided in the pub/samba/appliance/ + directory on your nearest + Samba mirror. These packages provide snapshots of the Samba source + code and binaries already setup to provide the full functionality + of winbind. This setup is a little more complex than a normal Samba + build as winbind needs a small amount of functionality from a + development code branch called SAMBA_TNG. Once you have installed the packages you should read + the winbindd(8) man page which will provide you + with conguration information and give you sample conguration files. + You may also wish to update the main Samba daemons smbd and nmbd) + with a more recent development release, such as the recently + announced Samba 2.2 alpha release. Limitations Winbind has a number of limitations in its current + released version which we hope to overcome in future + releases: Winbind is currently only available for + the Linux operating system, although ports to other operating + systems are certainly possible. For such ports to be feasible, + we require the C library of the target operating system to + support the Name Service Switch and Pluggable Authentication + Modules systems. This is becoming more common as NSS and + PAM gain support among UNIX vendors. The mappings of Windows NT RIDs to UNIX ids + is not made algorithmically and depends on the order in which + unmapped users or groups are seen by winbind. It may be difficult + to recover the mappings of rid to UNIX id mapping if the file + containing this information is corrupted or destroyed. Currently the winbind PAM module does not take + into account possible workstation and logon time restrictions + that may be been set for Windows NT users. Building winbind from source is currently + quite tedious as it requires combining source code from two Samba + branches. Work is underway to solve this by providing all + the necessary functionality in the main Samba code branch. Conclusion The winbind system, through the use of the Name Service + Switch, Pluggable Authentication Modules, and appropriate + Microsoft RPC calls have allowed us to provide seamless + integration of Microsoft Windows NT domain users on a + UNIX system. The result is a great reduction in the administrative + cost of running a mixed UNIX and NT network. \ No newline at end of file diff --git a/docs/manpages/findsmb.1 b/docs/manpages/findsmb.1 index 39447e788dd..26e6e8de936 100644 --- a/docs/manpages/findsmb.1 +++ b/docs/manpages/findsmb.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "FINDSMB" "1" "23 February 2001" "" "" +.TH FINDSMB 1 "24 Mar 2001" "findsmb 2.2.0-alpha3" .SH NAME findsmb \- list info about machines that respond to SMB name queries on a subnet .SH SYNOPSIS @@ -11,12 +11,12 @@ findsmb \- list info about machines that respond to SMB name queries on a subne \fBfindsmb\fR [ \fBsubnet broadcast address\fR ] .SH "DESCRIPTION" .PP -This perl script is part of the Samba suite. +This perl script is part of the Sambasuite. .PP \fBfindsmb\fR is a perl script that prints out several pieces of information about machines on a subnet that respond to SMB name query requests. -It uses \fB nmblookup(1)\fR and \fBsmbclient(1)\fR to obtain this information. +It uses \fB nmblookup(1)\fRto obtain this information. .SH "OPTIONS" .TP \fBsubnet broadcast address\fR @@ -40,7 +40,7 @@ Machines that are running Windows, Windows 95 or Windows 98 will not show any information about the operating system or server version. .PP -The command must be run on a system without \fBnmbd\fR running. +The command must be run on a system without \fBnmbd\fRrunning. If \fBnmbd\fR is running on the system, you will only get the IP address and the DNS name of the machine. To get proper responses from Windows 95 and Windows 98 machines, @@ -72,10 +72,9 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBnmbd(8)\fR , +\fBnmbd(8)\fR, \fBsmbclient(1) -\fR , and \fBnmblookup(1)\fR -.SH "AUTHOR" +\fR.SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/lmhosts.5 b/docs/manpages/lmhosts.5 index d45c9861b1a..4026c9bad27 100644 --- a/docs/manpages/lmhosts.5 +++ b/docs/manpages/lmhosts.5 @@ -3,15 +3,15 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "LMHOSTS" "5" "23 February 2001" "" "" +.TH LMHOSTS 5 "24 Mar 2001" "lmhosts 2.2.0-alpha3" .SH NAME lmhosts \- The Samba NetBIOS hosts file .SH SYNOPSIS .PP -\fIlmhosts\fR is the Samba NetBIOS name to IP address mapping file. +\fIlmhosts\fR is the SambaNetBIOS name to IP address mapping file. .SH "DESCRIPTION" .PP -This file is part of the < Samba suite. +This file is part of the < Sambasuite. .PP \fIlmhosts\fR is the \fBSamba \fRNetBIOS name to IP address mapping file. It @@ -44,7 +44,7 @@ An example follows : .sp .nf # -#Sample Samba lmhosts file. +# Sample Samba lmhosts file. # 192.9.200.1 TESTPC 192.9.200.20 NTSERVER#20 @@ -67,7 +67,7 @@ be resolved. .PP The default location of the \fIlmhosts\fR file is in the same directory as the -smb.conf(5)> file. +smb.conf(5)>file. .PP .SH "VERSION" .PP @@ -76,8 +76,7 @@ the Samba suite. .SH "SEE ALSO" .PP \fBsmbclient(1) -\fR , smb.conf(5) , and \fB smbpasswd(8)\fR -.SH "AUTHOR" +\fR.SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/make_smbcodepage.1 b/docs/manpages/make_smbcodepage.1 index 7ab3cccabe0..d3ea6164d0e 100644 --- a/docs/manpages/make_smbcodepage.1 +++ b/docs/manpages/make_smbcodepage.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "MAKE_SMBCODEPAGE" "1" "23 February 2001" "" "" +.TH MAKE_SMBCODEPAGE 1 "24 Mar 2001" "make_smbcodepage 2.2.0-alpha3" .SH NAME make_smbcodepage \- construct a codepage file for Samba .SH SYNOPSIS @@ -11,7 +11,7 @@ make_smbcodepage \- construct a codepage file for Samba \fBmake_smbcodepage\fR \fBc|d\fR \fBcodepage\fR \fBinputfile\fR \fBoutputfile\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBmake_smbcodepage\fR compiles or de-compiles codepage files for use with the internationalization features @@ -123,9 +123,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBsmbd(8)\fR , -smb.conf(5) -.SH "AUTHOR" +\fBsmbd(8)\fR, +smb.conf(5).SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/make_unicodemap.1 b/docs/manpages/make_unicodemap.1 index 9319f9ba4e2..6ecd538cbec 100644 --- a/docs/manpages/make_unicodemap.1 +++ b/docs/manpages/make_unicodemap.1 @@ -1,4 +1,4 @@ -.TH MAKE_UNICODEMAP 1 "26 Apr 2000" "make_unicodemap 2.0.7" +.TH MAKE_UNICODEMAP 1 "24 Mar 2001" "make_unicodemap 2.2.0-alpha3" .PP .SH "NAME" make_unicodemap \- Construct a unicode map file for Samba diff --git a/docs/manpages/nmbd.8 b/docs/manpages/nmbd.8 index 9a6cf43b34e..de1786d03e2 100644 --- a/docs/manpages/nmbd.8 +++ b/docs/manpages/nmbd.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "NMBD" "8" "23 February 2001" "" "" +.TH NMBD 8 "24 Mar 2001" "nmbd 2.2.0-alpha3" .SH NAME nmbd \- NetBIOS name server to provide NetBIOS over IP naming services to clients .SH SYNOPSIS @@ -33,7 +33,7 @@ but this can be overridden with the \fB-n\fR option (see OPTIONS below). Thus \fBnmbd\fR will reply to broadcast queries for its own name(s). Additional names for \fBnmbd\fR to respond on can be set -via parameters in the \fI smb.conf(5)\fR configuration file. +via parameters in the \fI smb.conf(5)\fRconfiguration file. .PP \fBnmbd\fR can also be used as a WINS (Windows Internet Name Server) server. What this basically means @@ -75,8 +75,7 @@ for \fBnmbd\fR. NetBIOS lmhosts file. The lmhosts file is a list of NetBIOS names to IP addresses that is loaded by the nmbd server and used via the name -resolution mechanism name resolve order described in \fIsmb.conf(5)\fR -to resolve any NetBIOS name queries needed by the server. Note +resolution mechanism name resolve orderto resolve any NetBIOS name queries needed by the server. Note that the contents of this file are \fBNOT\fR used by \fBnmbd\fR to answer any name queries. Adding a line to this file affects name NetBIOS resolution @@ -86,7 +85,7 @@ The default path to this file is compiled into Samba as part of the build process. Common defaults are \fI/usr/local/samba/lib/lmhosts\fR, \fI/usr/samba/lib/lmhosts\fR or -\fI/etc/lmhosts\fR. See the \fIlmhosts(5)\fR man page for details on the +\fI/etc/lmhosts\fR. See the \fIlmhosts(5)\fRman page for details on the contents of this file. .TP \fB-V\fR @@ -112,8 +111,7 @@ and generate HUGE amounts of log data, most of which is extremely cryptic. Note that specifying this parameter here will override -the log level -parameter in the \fI smb.conf\fR file. +the log levelparameter in the \fI smb.conf\fRfile. .TP \fB-l \fR The -l parameter specifies a path @@ -131,8 +129,8 @@ part of the build process. Common defaults are \fI /usr/local/samba/var/log.nmb\ \fB-n \fR This option allows you to override the NetBIOS name that Samba uses for itself. This is identical -to setting the NetBIOS name parameter in the -\fIsmb.conf\fR file. However, a command +to setting the NetBIOS nameparameter in the +\fIsmb.conf\fRfile. However, a command line setting will take precedence over settings in \fIsmb.conf\fR. .TP @@ -150,7 +148,7 @@ this may be changed when Samba is autoconfigured. The file specified contains the configuration details required by the server. See -\fIsmb.conf(5)\fR for more information. +\fIsmb.conf(5)\fRfor more information. .SH "FILES" .TP \fB\fI/etc/inetd.conf\fB\fR @@ -177,20 +175,17 @@ See the section INSTALLATION below. .TP \fB\fI/usr/local/samba/lib/smb.conf\fB\fR This is the default location of the -\fIsmb.conf\fR -server configuration file. Other common places that systems +\fIsmb.conf\fRserver configuration file. Other common places that systems install this file are \fI/usr/samba/lib/smb.conf\fR and \fI/etc/smb.conf\fR. When run as a WINS server (see the -wins support -parameter in the \fI smb.conf(5)\fR man page), \fBnmbd\fR +wins supportparameter in the \fI smb.conf(5)\fRman page), \fBnmbd\fR will store the WINS database in the file \fIwins.dat\fR in the \fIvar/locks\fR directory configured under wherever Samba was configured to install itself. -If \fBnmbd\fR is acting as a \fB browse master\fR (see the local master -parameter in the \fI smb.conf(5)\fR man page), \fBnmbd\fR +If \fBnmbd\fR is acting as a \fB browse master\fR (see the local masterparameter in the \fI smb.conf(5)\fRman page), \fBnmbd\fR will store the browsing database in the file \fIbrowse.dat \fRin the \fIvar/locks\fR directory configured under wherever Samba was configured to install itself. @@ -220,10 +215,10 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBinetd(8)\fR, \fBsmbd(8)\fR , +\fBinetd(8)\fR, \fBsmbd(8)\fR, \fIsmb.conf(5)\fR - , \fBsmbclient(1) -\fR , \fB testparm(1)\fR , \fBtestprns(1)\fR , and the Internet RFC's +, \fBsmbclient(1) +\fR, and the Internet RFC's \fIrfc1001.txt\fR, \fIrfc1002.txt\fR. In addition the CIFS (formerly SMB) specification is available as a link from the Web page diff --git a/docs/manpages/nmblookup.1 b/docs/manpages/nmblookup.1 index 55cc9824029..7b61058746a 100644 --- a/docs/manpages/nmblookup.1 +++ b/docs/manpages/nmblookup.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "NMBLOOKUP" "1" "23 February 2001" "" "" +.TH NMBLOOKUP 1 "24 Mar 2001" "nmblookup 2.2.0-alpha3" .SH NAME nmblookup \- NetBIOS over TCP/IP client used to lookup NetBIOS names .SH SYNOPSIS @@ -11,7 +11,7 @@ nmblookup \- NetBIOS over TCP/IP client used to lookup NetBIOS names \fBnmblookup\fR [ \fB-M\fR ] [ \fB-R\fR ] [ \fB-S\fR ] [ \fB-r\fR ] [ \fB-A\fR ] [ \fB-h\fR ] [ \fB-B \fR ] [ \fB-U \fR ] [ \fB-d \fR ] [ \fB-s \fR ] [ \fB-i \fR ] [ \fB-T\fR ] \fBname\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBnmblookup\fR is used to query NetBIOS names and map them to IP addresses in a network using NetBIOS over TCP/IP @@ -45,8 +45,7 @@ datagrams. The reason for this option is a bug in Windows 95 where it ignores the source port of the requesting packet and only replies to UDP port 137. Unfortunately, on most UNIX systems root privilage is needed to bind to this port, and -in addition, if the nmbd(8) -daemon is running on this machine it also binds to this port. +in addition, if the nmbd(8)daemon is running on this machine it also binds to this port. .TP \fB-A\fR Interpret \fIname\fR as @@ -60,7 +59,7 @@ Send the query to the given broadcast address. Without this option the default behavior of nmblookup is to send the query to the broadcast address of the network interfaces as either auto-detected or defined in the \fIinterfaces\fR - parameter of the \fIsmb.conf (5)\fR file. +parameter of the \fIsmb.conf (5)\fR file. .TP \fB-U \fR Do a unicast query to the specified address or @@ -84,11 +83,11 @@ Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic. Note that specifying this parameter here will override -the \fI log level\fR parameter in the \fI smb.conf(5)\fR file. +the \fI log level\fRparameter in the \fI smb.conf(5)\fR file. .TP \fB-s \fR This parameter specifies the pathname to -the Samba configuration file, smb.conf(5) . This file controls all aspects of +the Samba configuration file, smb.conf(5). This file controls all aspects of the Samba setup on the machine. .TP \fB-i \fR @@ -137,9 +136,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBnmbd(8)\fR , -samba(7) , and smb.conf(5) -.SH "AUTHOR" +\fBnmbd(8)\fR, +samba(7).SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/rpcclient.1 b/docs/manpages/rpcclient.1 index a7ce2e3b475..0a684dd0da5 100644 --- a/docs/manpages/rpcclient.1 +++ b/docs/manpages/rpcclient.1 @@ -3,73 +3,79 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "RPCCLIENT" "1" "28 February 2001" "" "" +.TH "RPCCLIENT" "1" "28 March 2001" "" "" .SH NAME -rpcclient \- developer's tool to testing client side MS-RPC functions +rpcclient \- tool for executing client side MS-RPC functions .SH SYNOPSIS .sp -\fBnmblookup\fR [ \fB-d debuglevel\fR ] [ \fB-S server\fR ] [ \fB-U username\fR ] [ \fB-W workgroup\fR ] [ \fB-n \fR ] [ \fB-A authfile\fR ] [ \fB-N\fR ] [ \fB-l logfile\fR ] [ \fB-I destinationIP\fR ] [ \fB-E \fR ] [ \fB-c \fR ] [ \fB-i scope\fR ] [ \fB-O \fR ] [ \fB-s \fR ] +\fBrpcclient\fR \fBserver\fR [ \fB-A authfile\fR ] [ \fB-c \fR ] [ \fB-d debuglevel\fR ] [ \fB-h\fR ] [ \fB-l logfile\fR ] [ \fB-N\fR ] [ \fB-s \fR ] [ \fB-U username[%password]\fR ] [ \fB-W workgroup\fR ] [ \fB-N\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP -\fBrpcclient\fR is a utility for developers for -executing various MS-RPC functions. It's primary use is for testing -Samba's own MS-RPC server implementation, however many administrators -have written scripts around it to manage Windows NT clients from +\fBrpcclient\fR is a utility initially developed +to test MS-RPC functionality in Samba itself. It has undergone +several stages of development and stability. Many system administrators +have now written scripts around it to manage Windows NT clients from their UNIX workstation. .SH "OPTIONS" .TP +\fBserver\fR +NetBIOS name of Server to which to connect. +The server can be any SMB/CIFS server. The name is +resolved using the \fIname resolve order\fRline from +\fIsmb.conf(5)\fR. +.TP +\fB-A filename\fR +This option allows +you to specify a file from which to read the username and +password used in the connection. The format of the file is + +.sp +.nf + username = + password = + domain = + +.sp +.fi + +Make certain that the permissions on the file restrict +access from unwanted users. +.TP +\fB-c 'command string'\fR +execute semicolon separated commands (listed +below)) +.TP \fB-d debuglevel\fR set the debuglevel. Debug level 0 is the lowest and 100 being the highest. This should be set to 100 if you are -planning on submitting a bug report to the Samba team -(see BUGS.txt). +planning on submitting a bug report to the Samba team (see BUGS.txt). .TP -\fB-S server\fR -NetBIOS name of Server to which you wish to -connect. The server can be any SMB/CIFS server. The name is -resolved using either the \fIname resolve order\fR -line or by using the -R option. +\fB-h\fR +Print a summary of command line options. .TP \fB-l logbasename\fR File name for log/debug files. .client will be appended. The log file is never removed by the client. .TP -\fB-n netbios name\fR -NetBIOS name of the -local machine. This option is only needed if your Samba client -cannot find it automatically. Samba should use the uppercase -of the machine's hostname. -.TP \fB-N\fR -tells rpcclient not to ask for a password. -\fBrpcclient\fR will prompt the user by default. -.TP -\fB-I destinationIP\fR -The IP address of the server specified with -the -S option. Only needed when the server's NetBIOS name cannot -be resolved using WINS or broadcast and isn't found in the LMHOSTS -file. +instruct \fBrpcclient\fR not to ask +for a password. By default, \fBrpcclient\fR will prompt +for a password. See also the \fI-U\fR option. .TP -\fB-E\fR -causes \fBrpcclient\fR to write -messages to stderr instead of stdout. +\fB-s smb.conf\fR +Specifies the location of the all important +\fIsmb.conf\fR file. .TP -\fB-U username[%pass]\fR +\fB-U username[%password]\fR Sets the SMB username or username and password. -If %pass is not specified, The user will be prompted. The client -will first check the USER environment variable, then the -\fI$LOGNAME\fR variable and if either exist, the -string is uppercased. Anything in these variables following a '%' -sign will be treated as the password. If these environmental -variables are not found, the username GUEST -is used. -If the password is not included in these environment -variables (using the %pass syntax), rpcclient will look for -a \fI$PASSWD\fR environment variable from which -to read the password. +If %password is not specified, The user will be prompted. The +client will first check the \fBUSER\fR environment variable, then the +\fBLOGNAME\fR variable and if either exist, the +string is uppercased. If these environmental variables are not +found, the username GUEST is used. A third option is to use a credentials file which contains the plaintext of the username and password. This @@ -79,29 +85,12 @@ variables. If this method is used, make certain that the permissions on the file restrict access from unwanted users. See the \fI-A\fR for more details. -Be cautious about including passwords in scripts or in -the \fI$PASSWD\fR environment variable. Also, on +Be cautious about including passwords in scripts. Also, on many systems the command line of a running process may be seen -via the \fBps\fR command to be safe always allow +via the \fBps\fR command. To be safe always allow \fBrpcclient\fR to prompt for a password and type it in directly. .TP -\fB-A filename\fR -This option allows -you to specify a file from which to read the username and -password used in the connection. The format of the file is - -.sp -.nf -username = -password = - -.sp -.fi - -Make certain that the permissions on the file restrict -access from unwanted users. -.TP \fB-W domain\fR Set the SMB domain of the username. This overrides the default domain which is the domain of the @@ -109,118 +98,65 @@ server specified with the \fI-S\fR option. If the domain specified is the same as the server's NetBIOS name, it causes the client to log on using the server's local SAM (as opposed to the Domain SAM). -.TP -\fB-P\fR -operate in promptless mode. Without this -mode (the default) \fBrpcclient\fR displays a -prompt of the form '[domain\\username@host]$' -.TP -\fB-c 'command string'\fR -execute semicolon separated commands (listed -below)) -.TP -\fB-t terminalcode\fR -This tells the Samba client how to interpret -the incoming filenames, in regards to character sets. The list -here is not complete. For a complete list see your local Samba -source. Some valid options are sjis, euc, jis7, jis8, junet -and hex. -.TP -\fB-O socket options\fR -These socket options are the same as in -\fIsmb.conf\fR (under the \fIsocket options -\fRsection). -.TP -\fB-s smb.conf\fR -Specifies the location of the all important -\fIsmb.conf\fR file. -.TP -\fB-i scope\fR -Defines the NetBIOS scope. For more -information on NetBIOS scopes, see rfc1001 and rfc1002. NetBIOS -scopes are rarely used. .SH "COMMANDS" .PP -\fBSPOOLSS Commands\fR +\fBLSARPC\fR .TP 0.2i \(bu -\fBspoolenum\fR - Execute an EnumPrinters() -call. This lists the various installed and share printers. Refer -to the MS Platform SDK documentation for more details of the various -flags and calling options. +\fBlsaquery\fR .TP 0.2i \(bu -\fBspoolenumports level -\fR- Executes an EnumPorts() call using the specified -info level. Currently only info level 1 and 2 are supported. +\fBlookupsids\fR .TP 0.2i \(bu -\fBspoolenumdata\fR - Enumerate all -printer setting data stored on the server. On Windows NT clients, -these values are stored in the registry, while Samba servers -store them in the printers TDB. This command corresponds -to the MS Platform SDK GetPrinterData() function. -.TP 0.2i -\(bu -\fBspooljobs printer\fR - List the jobs -and status of a given printer. -This command corresponds to the MS Platform SDK EnumJobs() -function. +\fBlookupnames\fR .TP 0.2i \(bu -\fBspoolopen printer -\fR- Execute an OpenPrinterEx() and ClosePrinter() RPC -against a given printer. +\fBenumtrusts\fR +.PP +.PP +.PP +\fBSAMR\fR +.PP .TP 0.2i \(bu -\fBspoolgetdata printer -\fR- Retrieve the data for a given printer setting. See -the \fBspoolenumdata\fR command for more information. -This command corresponds to the GetPrinterData() MS Platform -SDK function. +\fBqueryuser\fR .TP 0.2i \(bu -\fBspoolgetprinter printer -\fR- Retrieve the current printer information. This command -corresponds to the GetPrinter() MS Platform SDK function. +\fBquerygroup\fR .TP 0.2i \(bu -\fBspoolgetprinterdriver -printer\fR - Retrieve the printer driver information -(such as driver file, config file, dependent files, etc...) for -the given printer. This command corresponds to the GetPrinterDriver() -MS Platform SDK function. +\fBqueryusergroups\fR .TP 0.2i \(bu -\fBspoolgetprinterdriverdir -arch\fR - Execute a GetPrinterDriverDirectory() -RPC to retreive the SMB share name and subdirectory for -storing printer driver files for a given architecture. Possible -values for \fIarch\fR are "Windows 4.0" -(for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows -Alpha_AXP", and "Windows NT R4000". +\fBquerygroupmem\fR +.PP +.PP +.PP +\fBSPOOLSS\fR +.PP .TP 0.2i \(bu -\fBspooladdprinterdriver -arch config\fR - Execute an -AddPrinterDriver() RPC to install the printer driver information -on the server. Note that the driver files should already exist -in the directory returned by spoolgetprinterdriverdir. Possible -values for \fIarch\fR are the same as those for -the \fBspooolgetprintedriverdir\fR command. +\fBadddriver \fR +- Execute an AddPrinterDriver() RPC to install the printer driver +information on the server. Note that the driver files should +already exist in the directory returned by +\fBgetdriverdir\fR. Possible values for +\fIarch\fR are the same as those for +the \fBgetdriverdir\fR command. The \fIconfig\fR parameter is defined as follows: .sp .nf -Long Printer Name:\\ -Driver File Name:\\ -Data File Name:\\ -Config File Name:\\ -Help File Name:\\ -Language Monitor Name:\\ -Default Data Type:\\ -Comma Separated list of Files + Long Printer Name:\\ + Driver File Name:\\ + Data File Name:\\ + Config File Name:\\ + Help File Name:\\ + Language Monitor Name:\\ + Default Data Type:\\ + Comma Separated list of Files .sp .fi @@ -235,33 +171,105 @@ driver must already be installed prior to adding the driver or else the RPC will fail. .TP 0.2i \(bu -\fBspooladdprinter printername -sharename drivername port -\fR- Add a printer on the remote server. This printer +\fBaddprinter + \fR +- Add a printer on the remote server. This printer will be automatically shared. Be aware that the printer driver -must already be installed on the server (see addprinterdriver) -and the \fIport\fRmust be a valid port name. -.PP -\fBGeneral Commands\fR -.PP +must already be installed on the server (see \fBadddriver\fR) +and the \fIport\fRmust be a valid port name (see +\fBenumports\fR. +.TP 0.2i +\(bu +\fBenumdata\fR - Enumerate all +printer setting data stored on the server. On Windows NT clients, +these values are stored in the registry, while Samba servers +store them in the printers TDB. This command corresponds +to the MS Platform SDK GetPrinterData() function (* This +command is currently unimplemented). .TP 0.2i \(bu -\fBset\fR - Set miscellaneous -\fBrpcclient\fR command line options during a -running session. +\fBenumjobs \fR +- List the jobs and status of a given printer. +This command corresponds to the MS Platform SDK EnumJobs() +function (* This command is currently unimplemented). +.TP 0.2i +\(bu +\fBenumports [level]\fR +- Executes an EnumPorts() call using the specified +info level. Currently only info levels 1 and 2 are supported. +.TP 0.2i +\(bu +\fBenumdrivers [level]\fR +- Execute an EnumPrinterDrivers() call. This lists the various installed +printer drivers for all architectures. Refer to the MS Platform SDK +documentation for more details of the various flags and calling +options. Currently supported info levels are 1, 2, and 3. +.TP 0.2i +\(bu +\fBenumprinters [level]\fR +- Execute an EnumPrinters() call. This lists the various installed +and share printers. Refer to the MS Platform SDK documentation for +more details of the various flags and calling options. Currently +supported info levels are 0, 1, and 2. +.TP 0.2i +\(bu +\fBgetdata \fR +- Retrieve the data for a given printer setting. See +the \fBenumdata\fR command for more information. +This command corresponds to the GetPrinterData() MS Platform +SDK function (* This command is currently unimplemented). +.TP 0.2i +\(bu +\fBgetdriver \fR +- Retrieve the printer driver information (such as driver file, +config file, dependent files, etc...) for +the given printer. This command corresponds to the GetPrinterDriver() +MS Platform SDK function. Currently info level 1, 2, and 3 are supported. +.TP 0.2i +\(bu +\fBgetdriverdir \fR +- Execute a GetPrinterDriverDirectory() +RPC to retreive the SMB share name and subdirectory for +storing printer driver files for a given architecture. Possible +values for \fIarch\fR are "Windows 4.0" +(for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows +Alpha_AXP", and "Windows NT R4000". +.TP 0.2i +\(bu +\fBgetprinter \fR +- Retrieve the current printer information. This command +corresponds to the GetPrinter() MS Platform SDK function. +.TP 0.2i +\(bu +\fBopenprinter \fR +- Execute an OpenPrinterEx() and ClosePrinter() RPC +against a given printer. +.TP 0.2i +\(bu +\fBsetdriver \fR +- Execute a SetPrinter() command to update the printer driver associated +with an installed printer. The printer driver must already be correctly +installed on the print server. + +See also the \fBenumprinters\fR and +\fBenumdrivers\fR commands for obtaining a list of +of installed printers and drivers. +.PP +\fBGENERAL OPTIONS\fR +.PP .TP 0.2i \(bu -\fBuse\fR - Connect to a rmeote SMB -server. \fBrpcclient\fR has the ability to -maintain connections to multiple server simulaneously. +\fBdebuglevel\fR - Set the current debug level +used to log information. .TP 0.2i \(bu -\fBhelp\fR - Print a listing of all +\fBhelp (?)\fR - Print a listing of all known commands or extended help on a particular command. .TP 0.2i \(bu -\fBquit\fR - Exit \fBrpcclient -\fR.SH "BUGS" +\fBquit (exit)\fR - Exit \fBrpcclient +\fR\&. +.SH "BUGS" .PP \fBrpcclient\fR is designed as a developer testing tool and may not be robust in certain areas (such as command line parsing). @@ -279,15 +287,15 @@ to be... a bit flakey in places. .PP The development of Samba's implementation is also a bit rough, and as more of the services are understood, it can even result in -versions of \fBsmbd(8)\fR and \fBrpcclient\fR +versions of \fBsmbd(8)\fR and \fBrpcclient(1)\fR that are incompatible for some commands or services. Additionally, the developers are sending reports to Microsoft, and problems found or reported to Microsoft are fixed in Service Packs, which may result in incompatibilities." .SH "VERSION" .PP -This man page is correct for version 2.2 of -the Samba suite. +This man page is correct for version 2.2 of the Samba +suite. .SH "AUTHOR" .PP The original Samba software and related utilities @@ -295,6 +303,7 @@ 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. .PP -The original rpcclient man page was written by Matthew Geddes, -Luke Kenneth Casson, and Gerald Carter. The conversion to -DocBook for Samba 2.2 was done by Gerald Carter +The original rpcclient man page was written by Matthew +Geddes, Luke Kenneth Casson, and rewriten by Gerald Carter. +The conversion to DocBook for Samba 2.2 was done by Gerald +Carter. diff --git a/docs/manpages/samba.7 b/docs/manpages/samba.7 index 45f55a602ce..0a12cb936d0 100644 --- a/docs/manpages/samba.7 +++ b/docs/manpages/samba.7 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SAMBA" "7" "23 February 2001" "" "" +.TH SAMBA 7 "24 Mar 2001" "samba 2.2.0-alpha3" .SH NAME SAMBA \- A Windows SMB/CIFS fileserver for UNIX .SH SYNOPSIS @@ -125,7 +125,7 @@ Samba. The project would have been unmanageable without it. .PP In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see -the Samba Web pages at http://samba.org/samba/samba-thanks.html . +the Samba Web pages at http://samba.org/samba/samba-thanks.html. .SH "AUTHOR" .PP The original Samba software and related utilities diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5 index 7ae2aaa6e7f..d0ea635f98f 100644 --- a/docs/manpages/smb.conf.5 +++ b/docs/manpages/smb.conf.5 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMB.CONF" "5" "23 February 2001" "" "" +.TH "SMB.CONF" "5" "19 April 2001" "" "" .SH NAME smb.conf \- The configuration file for the Samba suite .SH "SYNOPSIS" @@ -13,7 +13,7 @@ file for the Samba suite. \fIsmb.conf\fR contains runtime configuration information for the Samba programs. The \fIsmb.conf\fR file is designed to be configured and administered by the \fBswat(8)\fR - program. The complete description of the file format and +program. The complete description of the file format and possible parameters held within are here for reference purposes. .SH "FILE FORMAT" .PP @@ -65,7 +65,7 @@ given plus a description of the access rights which are granted to the user of the service. Some housekeeping options are also specifiable. .PP -Sections are either filespace services (used by the +Sections are either file share services (used by the client as an extension of their native file systems) or printable services (used by the client to access print services on the host running the server). @@ -123,7 +123,7 @@ elsewhere): parameters in this section apply to the server as a whole, or are defaults for sections which do not specifically define certain items. See the notes -under paraMETERS for more information. +under PARAMETERS for more information. .SS "THE HOMES SECTION" .PP If a section called homes is included in the @@ -289,7 +289,7 @@ printers are defined on the system you may be able to use of printers. See the "printcap name" option for more details. .PP -.SH "PARAMETRS" +.SH "PARAMETERS" .PP parameters define the specific attributes of sections. .PP @@ -349,7 +349,7 @@ by %u. the Samba version. .TP \fB%h\fR -the internet hostname that Samba is running +the Internet hostname that Samba is running on. .TP \fB%m\fR @@ -362,7 +362,7 @@ to change your config based on what the client calls you. Your server can have a "dual personality". .TP \fB%M\fR -the internet name of the client machine. +the Internet name of the client machine. .TP \fB%N\fR the name of your NIS home directory server. @@ -455,10 +455,10 @@ NT server, in that it is case insensitive but case preserving. .SH "NOTE ABOUT USERNAME/PASSWORD VALIDATION" .PP There are a number of ways in which a user can connect -to a service. The server follows the following steps in determining +to a service. The server uses the following steps in determining if it will allow a connection to a specified service. If all the -steps fail then the connection request is rejected. If one of the -steps pass then the following steps are not checked. +steps fail, then the connection request is rejected. However, if one of the +steps succeeds, then the following steps are not checked. .PP If the service is marked "guest only = yes" then steps 1 to 5 are skipped. @@ -503,842 +503,940 @@ Here is a list of all global parameters. See the section of each parameter for details. Note that some are synonyms. .TP 0.2i \(bu -\fIadd user script\fR +\fIadd user script\fR .TP 0.2i \(bu -\fIallow trusted domains\fR +\fIaddprinter command\fR .TP 0.2i \(bu -\fIannounce as\fR +\fIallow trusted domains\fR .TP 0.2i \(bu -\fIannounce version\fR +\fIannounce as\fR .TP 0.2i \(bu -\fIauto services\fR +\fIannounce version\fR .TP 0.2i \(bu -\fIbind interfaces only\fR +\fIauto services\fR +.TP 0.2i +\(bu +\fIbind interfaces only\fR .TP 0.2i \(bu \fIbrowse list\fR .TP 0.2i \(bu -\fIchange notify timeout\fR +\fIchange notify timeout\fR +.TP 0.2i +\(bu +\fIcharacter set\fR .TP 0.2i \(bu -\fIcharacter set\fR +\fIclient code page\fR .TP 0.2i \(bu -\fIclient code page\fR +\fIcode page directory\fR .TP 0.2i \(bu \fIcoding system\fR .TP 0.2i \(bu -\fIconfig file\fR +\fIconfig file\fR .TP 0.2i \(bu -\fIdeadtime\fR +\fIdeadtime\fR .TP 0.2i \(bu -\fIdebug hires timestamp\fR +\fIdebug hires timestamp\fR .TP 0.2i \(bu -\fIdebug pid\fR +\fIdebug pid\fR .TP 0.2i \(bu \fIdebug timestamp\fR .TP 0.2i \(bu -\fIdebug uid\fR +\fIdebug uid\fR .TP 0.2i \(bu -\fIdebug level\fR +\fIdebuglevel\fR +.TP 0.2i +\(bu +\fIdefault\fR .TP 0.2i \(bu -\fIdefault\fR +\fIdefault service\fR .TP 0.2i \(bu -\fIdefault service\fR +\fIdelete user script\fR .TP 0.2i \(bu -\fIdelete user script\fR +\fIdeleteprinter command\fR .TP 0.2i \(bu -\fIdfree command\fR +\fIdfree command\fR .TP 0.2i \(bu -\fIdns proxy\fR +\fIdns proxy\fR .TP 0.2i \(bu -\fIdomain admin group\fR +\fIdomain admin group\fR .TP 0.2i \(bu -\fIdomain admin users\fR +\fIdomain admin users\fR .TP 0.2i \(bu \fIdomain groups\fR .TP 0.2i \(bu -\fIdomain guest group\fR +\fIdomain guest group\fR +.TP 0.2i +\(bu +\fIdomain guest users\fR +.TP 0.2i +\(bu +\fIdomain logons\fR +.TP 0.2i +\(bu +\fIdomain master\fR .TP 0.2i \(bu -\fIdomain guest users\fR +\fIencrypt passwords\fR .TP 0.2i \(bu -\fIdomain logons\fR +\fIenhanced browsing\fR .TP 0.2i \(bu -\fIdomain master\fR +\fIenumports command\fR .TP 0.2i \(bu -\fIencrypt passwords\fR +\fIgetwd cache\fR .TP 0.2i \(bu -\fIgetwd cache\fR +\fIhide local users\fR .TP 0.2i \(bu -\fIhide local users\fR +\fIhomedir map\fR .TP 0.2i \(bu -\fIhomedir map\fR +\fIhost msdfs\fR .TP 0.2i \(bu -\fIhosts equiv\fR +\fIhosts equiv\fR .TP 0.2i \(bu \fIinterfaces\fR .TP 0.2i \(bu -\fIkeepalive\fR +\fIkeepalive\fR .TP 0.2i \(bu -\fIkernel oplocks\fR +\fIkernel oplocks\fR .TP 0.2i \(bu -\fIlm announce\fR +\fIlanman auth\fR .TP 0.2i \(bu -\fIlm interval\fR +\fIlm announce\fR .TP 0.2i \(bu -\fIload printers\fR +\fIlm interval\fR .TP 0.2i \(bu -\fIlocal master\fR +\fIload printers\fR .TP 0.2i \(bu -\fIlock dir\fR +\fIlocal master\fR .TP 0.2i \(bu -\fIlock directory\fR +\fIlock dir\fR .TP 0.2i \(bu -\fIlog file\fR +\fIlock directory\fR .TP 0.2i \(bu -\fIlog level\fR +\fIlog file\fR .TP 0.2i \(bu -\fIlogon drive\fR +\fIlog level\fR .TP 0.2i \(bu -\fIlogon home\fR +\fIlogon drive\fR .TP 0.2i \(bu -\fIlogon path\fR +\fIlogon home\fR .TP 0.2i \(bu -\fIlogon script\fR +\fIlogon path\fR .TP 0.2i \(bu -\fIlpq cache time\fR +\fIlogon script\fR .TP 0.2i \(bu -\fImachine password timeout\fR +\fIlpq cache time\fR .TP 0.2i \(bu -\fImangled stack\fR +\fImachine password timeout\fR .TP 0.2i \(bu -\fImap to guest\fR +\fImangled stack\fR .TP 0.2i \(bu -\fImax disk size\fR +\fImap to guest\fR .TP 0.2i \(bu -\fImax log size\fR +\fImax disk size\fR .TP 0.2i \(bu -\fImax mux\fR +\fImax log size\fR .TP 0.2i \(bu -\fImax open files\fR +\fImax mux\fR .TP 0.2i \(bu -\fImax packet\fR +\fImax open files\fR .TP 0.2i \(bu -\fImax ttl\fR +\fImax protocol\fR .TP 0.2i \(bu -\fImax wins ttl\fR +\fImax smbd processes\fR .TP 0.2i \(bu -\fImax xmit\fR +\fImax ttl\fR .TP 0.2i \(bu -\fImessage command\fR +\fImax wins ttl\fR .TP 0.2i \(bu -\fImin passwd length\fR +\fImax xmit\fR .TP 0.2i \(bu -\fImin password length\fR +\fImessage command\fR .TP 0.2i \(bu -\fImin wins ttl\fR +\fImin passwd length\fR .TP 0.2i \(bu -\fIname resolve order\fR +\fImin password length\fR .TP 0.2i \(bu -\fInetbios aliases\fR +\fImin protocol\fR .TP 0.2i \(bu -\fInetbios name\fR +\fImin wins ttl\fR .TP 0.2i \(bu -\fInetbios scope\fR +\fIname resolve order\fR .TP 0.2i \(bu -\fInis homedir\fR +\fInetbios aliases\fR .TP 0.2i \(bu -\fInt acl support\fR +\fInetbios name\fR .TP 0.2i \(bu -\fInt pipe support\fR +\fInetbios scope\fR .TP 0.2i \(bu -\fInt smb support\fR +\fInis homedir\fR .TP 0.2i \(bu -\fInull passwords\fR +\fInt acl support\fR .TP 0.2i \(bu -\fIole locking compatibility\fR +\fInt pipe support\fR .TP 0.2i \(bu -\fIoplock break wait time\fR +\fInt smb support\fR .TP 0.2i \(bu -\fIos level\fR +\fInull passwords\fR .TP 0.2i \(bu -\fIpanic action\fR +\fIoplock break wait time\fR .TP 0.2i \(bu -\fIpasswd chat\fR +\fIos level\fR .TP 0.2i \(bu -\fIpasswd chat debug\fR +\fIos2 driver map\fR .TP 0.2i \(bu -\fIpasswd program\fR +\fIpanic action\fR .TP 0.2i \(bu -\fIpassword level\fR +\fIpasswd chat\fR .TP 0.2i \(bu -\fIpassword server\fR +\fIpasswd chat debug\fR .TP 0.2i \(bu -\fIprefered master\fR +\fIpasswd program\fR .TP 0.2i \(bu -\fIpreferred master\fR +\fIpassword level\fR .TP 0.2i \(bu -\fIpreload\fR +\fIpassword server\fR .TP 0.2i \(bu -\fIprintcap\fR +\fIprefered master\fR .TP 0.2i \(bu -\fIprintcap name\fR +\fIpreferred master\fR .TP 0.2i \(bu -\fIprinter driver file\fR +\fIpreload\fR .TP 0.2i \(bu -\fIprivate dir\fR +\fIprintcap\fR .TP 0.2i \(bu -\fIprotocol\fR +\fIprintcap name\fR .TP 0.2i \(bu -\fIread bmpx\fR +\fIprinter driver file\fR .TP 0.2i \(bu -\fIread prediction\fR +\fIprotocol\fR .TP 0.2i \(bu -\fIread raw\fR +\fIread bmpx\fR .TP 0.2i \(bu -\fIread size\fR +\fIread raw\fR .TP 0.2i \(bu -\fIremote announce\fR +\fIread size\fR .TP 0.2i \(bu -\fIremote browse sync\fR +\fIremote announce\fR .TP 0.2i \(bu -\fIrestrict anonymous\fR +\fIremote browse sync\fR .TP 0.2i \(bu -\fIroot\fR +\fIrestrict anonymous\fR .TP 0.2i \(bu -\fIroot dir\fR +\fIroot\fR .TP 0.2i \(bu -\fIroot directory\fR +\fIroot dir\fR .TP 0.2i \(bu -\fIsecurity\fR +\fIroot directory\fR .TP 0.2i \(bu -\fIserver string\fR +\fIsecurity\fR .TP 0.2i \(bu -\fIshared mem size\fR +\fIserver string\fR .TP 0.2i \(bu -\fIsmb passwd file\fR +\fIshow add printer wizard\fR .TP 0.2i \(bu -\fIsmbrun\fR +\fIsmb passwd file\fR .TP 0.2i \(bu -\fIsocket address\fR +\fIsocket address\fR .TP 0.2i \(bu -\fIsocket options\fR +\fIsocket options\fR .TP 0.2i \(bu -\fIsource environment\fR +\fIsource environment\fR .TP 0.2i \(bu -\fIssl\fR +\fIssl\fR .TP 0.2i \(bu -\fIssl CA certDir\fR +\fIssl CA certDir\fR .TP 0.2i \(bu -\fIssl CA certFile\fR +\fIssl CA certFile\fR .TP 0.2i \(bu -\fIssl ciphers\fR +\fIssl ciphers\fR .TP 0.2i \(bu -\fIssl client cert\fR +\fIssl client cert\fR .TP 0.2i \(bu \fIssl client key\fR .TP 0.2i \(bu -\fIssl compatibility\fR +\fIssl compatibility\fR .TP 0.2i \(bu -\fIssl hosts\fR +\fIssl hosts\fR .TP 0.2i \(bu -\fIssl hosts resign\fR +\fIssl hosts resign\fR .TP 0.2i \(bu \fIssl require clientcert\fR .TP 0.2i \(bu -\fIssl require servercert\fR +\fIssl require servercert\fR .TP 0.2i \(bu -\fIssl server cert\fR +\fIssl server cert\fR .TP 0.2i \(bu -\fIssl server key\fR +\fIssl server key\fR .TP 0.2i \(bu -\fIssl version\fR +\fIssl version\fR .TP 0.2i \(bu -\fIstat cache\fR +\fIstat cache\fR .TP 0.2i \(bu -\fIstat cache size\fR +\fIstat cache size\fR .TP 0.2i \(bu -\fIstrip dot\fR +\fIstrip dot\fR .TP 0.2i \(bu -\fIsyslog\fR +\fIsyslog\fR .TP 0.2i \(bu -\fIsyslog only\fR +\fIsyslog only\fR .TP 0.2i \(bu \fItemplate homedir\fR .TP 0.2i \(bu -\fItemplate shell\fR +\fItemplate shell\fR +.TP 0.2i +\(bu +\fItime offset\fR .TP 0.2i \(bu -\fItime offset\fR +\fItime server\fR .TP 0.2i \(bu -\fItime server\fR +\fItimestamp logs\fR .TP 0.2i \(bu -\fItimestamp logs\fR +\fItotal print jobs\fR .TP 0.2i \(bu -\fIunix password sync\fR +\fIunix password sync\fR .TP 0.2i \(bu -\fIunix realname\fR +\fIupdate encrypted\fR .TP 0.2i \(bu -\fIupdate encrypted\fR +\fIuse rhosts\fR .TP 0.2i \(bu -\fIuse rhosts\fR +\fIusername level\fR .TP 0.2i \(bu -\fIusername level\fR +\fIusername map\fR .TP 0.2i \(bu -\fIusername map\fR +\fIutmp directory\fR .TP 0.2i \(bu -\fIutmp directory\fR +\fIvalid chars\fR .TP 0.2i \(bu -\fIvalid chars\fR +\fIwinbind cache time\fR .TP 0.2i \(bu -\fIwinbind cache time\fR +\fIwinbind gid\fR .TP 0.2i \(bu -\fIwinbind gid\fR +\fIwinbind separator\fR .TP 0.2i \(bu -\fIwinbind uid\fR +\fIwinbind uid\fR .TP 0.2i \(bu -\fIwins hook\fR +\fIwins hook\fR .TP 0.2i \(bu -\fIwins proxy\fR +\fIwins proxy\fR .TP 0.2i \(bu -\fIwins server\fR +\fIwins server\fR .TP 0.2i \(bu -\fIwins support\fR +\fIwins support\fR .TP 0.2i \(bu -\fIworkgroup\fR +\fIworkgroup\fR .TP 0.2i \(bu -\fIwrite raw\fR +\fIwrite raw\fR .SH "COMPLETE LIST OF SERVICE PARAMETERS" .PP -Here is a list of all service parameters. See the section of +Here is a list of all service parameters. See the section on each parameter for details. Note that some are synonyms. .TP 0.2i \(bu -\fIadmin users\fR -.TP 0.2i -\(bu -\fIallow hosts\fR +\fIadmin users\fR .TP 0.2i \(bu -\fIalternate permissions\fR +\fIallow hosts\fR .TP 0.2i \(bu -\fIavailable\fR +\fIavailable\fR .TP 0.2i \(bu \fIblocking locks\fR .TP 0.2i \(bu -\fIbrowsable\fR +\fIbrowsable\fR .TP 0.2i \(bu -\fIbrowseable\fR +\fIbrowseable\fR .TP 0.2i \(bu -\fIcase sensitive\fR +\fIcase sensitive\fR .TP 0.2i \(bu -\fIcasesignames\fR +\fIcasesignames\fR .TP 0.2i \(bu -\fIcomment\fR +\fIcomment\fR .TP 0.2i \(bu -\fIcopy\fR +\fIcopy\fR .TP 0.2i \(bu -\fIcreate mask\fR +\fIcreate mask\fR .TP 0.2i \(bu -\fIcreate mode\fR +\fIcreate mode\fR .TP 0.2i \(bu -\fIdefault case\fR +\fIdefault case\fR .TP 0.2i \(bu -\fIdelete readonly\fR +\fIdelete readonly\fR .TP 0.2i \(bu -\fIdelete veto files\fR +\fIdelete veto files\fR .TP 0.2i \(bu -\fIdeny hosts\fR +\fIdeny hosts\fR .TP 0.2i \(bu -\fIdirectory\fR +\fIdirectory\fR .TP 0.2i \(bu -\fIdirectory mask\fR +\fIdirectory mask\fR .TP 0.2i \(bu -\fIdirectory mode\fR +\fIdirectory mode\fR .TP 0.2i \(bu \fIdirectory security mask\fR .TP 0.2i \(bu -\fIdont descend\fR +\fIdont descend\fR .TP 0.2i \(bu -\fIdos filetime resolution\fR +\fIdos filemode\fR .TP 0.2i \(bu -\fIdos filetimes\fR +\fIdos filetime resolution\fR .TP 0.2i \(bu -\fIexec\fR +\fIdos filetimes\fR .TP 0.2i \(bu -\fIfake directory create times\fR +\fIexec\fR .TP 0.2i \(bu -\fIfake oplocks\fR +\fIfake directory create times\fR .TP 0.2i \(bu -\fIfollow symlinks\fR +\fIfake oplocks\fR .TP 0.2i \(bu -\fIforce create mode\fR +\fIfollow symlinks\fR .TP 0.2i \(bu -\fIforce directory mode\fR +\fIforce create mode\fR .TP 0.2i \(bu -\fIforce directory security mode\fR +\fIforce directory mode\fR .TP 0.2i \(bu -\fIforce group\fR +\fIforce directory security mode\fR .TP 0.2i \(bu -\fIforce security mode\fR +\fIforce group\fR .TP 0.2i \(bu -\fIforce user\fR +\fIforce security mode\fR .TP 0.2i \(bu -\fIfstype\fR +\fIforce user\fR .TP 0.2i \(bu -\fIgroup\fR +\fIfstype\fR .TP 0.2i \(bu -\fIguest account\fR +\fIgroup\fR .TP 0.2i \(bu -\fIguest ok\fR +\fIguest account\fR .TP 0.2i \(bu -\fIguest only\fR +\fIguest ok\fR .TP 0.2i \(bu -\fIhide dot files\fR +\fIguest only\fR .TP 0.2i \(bu -\fIhide files\fR +\fIhide dot files\fR .TP 0.2i \(bu -\fIhosts allow\fR +\fIhide files\fR .TP 0.2i \(bu -\fIhosts deny\fR +\fIhosts allow\fR .TP 0.2i \(bu -\fIinclude\fR +\fIhosts deny\fR .TP 0.2i \(bu -\fIinherit permissions\fR +\fIinclude\fR .TP 0.2i \(bu -\fIinvalid users\fR +\fIinherit permissions\fR .TP 0.2i \(bu -\fIlevel2 oplocks\fR +\fIinvalid users\fR .TP 0.2i \(bu -\fIlocking\fR +\fIlevel2 oplocks\fR .TP 0.2i \(bu -\fIlppause command\fR +\fIlocking\fR .TP 0.2i \(bu -\fIlpq command\fR +\fIlppause command\fR .TP 0.2i \(bu -\fIlpresume command\fR +\fIlpq command\fR .TP 0.2i \(bu -\fIlprm command\fR +\fIlpresume command\fR .TP 0.2i \(bu -\fImagic output\fR +\fIlprm command\fR .TP 0.2i \(bu -\fImagic script\fR +\fImagic output\fR .TP 0.2i \(bu -\fImangle case\fR +\fImagic script\fR .TP 0.2i \(bu -\fImangle locks\fR +\fImangle case\fR .TP 0.2i \(bu -\fImangled map\fR +\fImangled map\fR .TP 0.2i \(bu -\fImangled names\fR +\fImangled names\fR .TP 0.2i \(bu -\fImangling char\fR +\fImangling char\fR .TP 0.2i \(bu -\fImap archive\fR +\fImap archive\fR .TP 0.2i \(bu \fImap hidden\fR .TP 0.2i \(bu -\fImap system\fR +\fImap system\fR +.TP 0.2i +\(bu +\fImax connections\fR +.TP 0.2i +\(bu +\fImax print jobs\fR +.TP 0.2i +\(bu +\fImin print space\fR .TP 0.2i \(bu -\fImax connections\fR +\fImsdfs root\fR .TP 0.2i \(bu -\fImin print space\fR +\fIonly guest\fR .TP 0.2i \(bu -\fIonly guest\fR +\fIonly user\fR .TP 0.2i \(bu -\fIonly user\fR +\fIoplock contention limit\fR .TP 0.2i \(bu -\fIoplock contention limit\fR +\fIoplocks\fR .TP 0.2i \(bu -\fIoplocks\fR +\fIpath\fR .TP 0.2i \(bu -\fIpath\fR +\fIposix locking\fR .TP 0.2i \(bu -\fIpostexec\fR +\fIpostexec\fR .TP 0.2i \(bu -\fIpostscript\fR +\fIpostscript\fR .TP 0.2i \(bu -\fIpreexec\fR +\fIpreexec\fR .TP 0.2i \(bu -\fIpreexec close\fR +\fIpreexec close\fR .TP 0.2i \(bu -\fIpreserve case\fR +\fIpreserve case\fR .TP 0.2i \(bu -\fIprint command\fR +\fIprint command\fR .TP 0.2i \(bu -\fIprint ok\fR +\fIprint ok\fR .TP 0.2i \(bu -\fIprintable\fR +\fIprintable\fR .TP 0.2i \(bu -\fIprinter\fR +\fIprinter\fR .TP 0.2i \(bu -\fIprinter admin\fR +\fIprinter admin\fR .TP 0.2i \(bu -\fIprinter driver\fR +\fIprinter driver\fR .TP 0.2i \(bu -\fIprinter driver location\fR +\fIprinter driver location\fR .TP 0.2i \(bu -\fIprinter name\fR +\fIprinter name\fR .TP 0.2i \(bu \fIprinting\fR .TP 0.2i \(bu -\fIpublic\fR +\fIpublic\fR .TP 0.2i \(bu -\fIqueuepause command\fR +\fIqueuepause command\fR .TP 0.2i \(bu -\fIqueueresume command\fR +\fIqueueresume command\fR .TP 0.2i \(bu -\fIread list\fR +\fIread list\fR .TP 0.2i \(bu \fIread only\fR .TP 0.2i \(bu -\fIroot postexec\fR +\fIroot postexec\fR .TP 0.2i \(bu -\fIroot preexec\fR +\fIroot preexec\fR .TP 0.2i \(bu -\fIroot preexec close\fR +\fIroot preexec close\fR .TP 0.2i \(bu -\fIsecurity mask\fR +\fIsecurity mask\fR .TP 0.2i \(bu \fIset directory\fR .TP 0.2i \(bu -\fIshare modes\fR +\fIshare modes\fR .TP 0.2i \(bu -\fIshort preserve case\fR +\fIshort preserve case\fR .TP 0.2i \(bu -\fIstatus\fR +\fIstatus\fR .TP 0.2i \(bu -\fIstrict locking\fR +\fIstrict locking\fR .TP 0.2i \(bu \fIstrict sync\fR .TP 0.2i \(bu -\fIsync always\fR +\fIsync always\fR .TP 0.2i \(bu -\fIuser\fR +\fIuser\fR .TP 0.2i \(bu -\fIusername\fR +\fIusername\fR .TP 0.2i \(bu -\fIusers\fR +\fIusers\fR .TP 0.2i \(bu -\fIutmp\fR +\fIutmp\fR .TP 0.2i \(bu -\fIvalid users\fR +\fIvalid users\fR .TP 0.2i \(bu -\fIveto files\fR +\fIveto files\fR +.TP 0.2i +\(bu +\fIveto oplock files\fR .TP 0.2i \(bu -\fIveto oplock files\fR +\fIvfs object\fR .TP 0.2i \(bu -\fIvolume\fR +\fIvfs options\fR .TP 0.2i \(bu -\fIwide links\fR +\fIvolume\fR .TP 0.2i \(bu -\fIwritable\fR +\fIwide links\fR .TP 0.2i \(bu -\fIwrite cache size\fR +\fIwritable\fR +.TP 0.2i +\(bu +\fIwrite cache size\fR .TP 0.2i \(bu \fIwrite list\fR .TP 0.2i \(bu -\fIwrite ok\fR +\fIwrite ok\fR .TP 0.2i \(bu -\fIwriteable\fR +\fIwriteable\fR .SH "EXPLANATION OF EACH PARAMETER" .TP \fBadd user script (G)\fR This is the full pathname to a script that will be run \fBAS ROOT\fR by smbd(8) - under special circumstances decribed below. +under special circumstances described below. Normally, a Samba server requires that UNIX users are created for all users accessing files on this server. For sites that use Windows NT account databases as their primary user database creating these users and keeping the user list in sync with the -Windows NT PDC is an onerous task. This option allows smbd to create the required UNIX users +Windows NT PDC is an onerous task. This option allows smbdto create the required UNIX users \fBON DEMAND\fR when a user accesses the Samba server. -In order to use this option, smbd -must be set to \fIsecurity=server\fR or \fI security=domain\fR and \fIadd user script\fR +In order to use this option, smbdmust be set to \fIsecurity=server\fR or \fI security=domain\fR and \fIadd user script\fR must be set to a full pathname for a script that will create a UNIX user given one argument of \fI%u\fR, which expands into the UNIX user name to create. When the Windows user attempts to access the Samba server, -at login (session setup in the SMB protocol) time, smbd contacts the \fIpassword server\fR and +at login (session setup in the SMB protocol) time, smbdcontacts the \fIpassword server\fR and attempts to authenticate the given user with the given password. If the -authentication succeeds then smbd +authentication succeeds then \fBsmbd\fR attempts to find a UNIX user in the UNIX password database to map the Windows user into. If this lookup fails, and \fIadd user script -\fRis set then smbd will +\fRis set then \fBsmbd\fR will call the specified script \fBAS ROOT\fR, expanding any \fI%u\fR argument to be the user name to create. -If this script successfully creates the user then smbd will continue on as though the UNIX user +If this script successfully creates the user then \fBsmbd +\fRwill continue on as though the UNIX user already existed. In this way, UNIX users are dynamically created to match existing Windows NT accounts. -See also \fI security\fR , \fIpassword server\fR , \fIdelete user -script\fR . +See also \fI security\fR, \fIpassword server\fR, +\fIdelete user +script\fR. Default: \fBadd user script = \fR Example: \fBadd user script = /usr/local/samba/bin/add_user %u\fR .TP +\fBaddprinter command (G)\fR +With the introduction of MS-RPC based printing +support for Windows NT/2000 clients in Samba 2.2, The MS Add +Printer Wizard (APW) icon is now also available in the +"Printers..." folder displayed a share listing. The APW +allows for printers to be add remotely to a Samba or Windows +NT/2000 print server. + +For a Samba host this means that the printer must be +physically added to underlying printing system. The \fI addprinter command\fR defines a script to be run which +will perform the necessary operations for adding the printer +to the print system and to add the appropriate service definition +to the \fIsmb.conf\fR file in order that it can be +shared by \fBsmbd(8)\fR +. + +The \fIaddprinter command\fR is +automatically invoked with the following parameter (in +order: +.RS +.TP 0.2i +\(bu +\fIprinter name\fR +.TP 0.2i +\(bu +\fIshare name\fR +.TP 0.2i +\(bu +\fIport name\fR +.TP 0.2i +\(bu +\fIdriver name\fR +.TP 0.2i +\(bu +\fIlocation\fR +.TP 0.2i +\(bu +\fIWindows 9x driver location\fR +.RE +.PP +All parameters are filled in from the PRINTER_INFO_2 structure sent +by the Windows NT/2000 client with one exception. The "Windows 9x +driver location" parameter is included for backwards compatibility +only. The remaining fields in the structure are generated from answers +to the APW questions. +.PP +.PP +Once the \fIaddprinter command\fR has +been executed, \fBsmbd\fR will reparse the \fI smb.conf\fR to determine if the share defined by the APW +exists. If the sharename is still invalid, then \fBsmbd +\fRwill return an ACCESS_DENIED error to the client. +.PP +.PP +See also \fI deleteprinter command\fR, \fIprinting\fR, +\fIshow add +printer wizard\fR +.PP +.PP +Default: \fBnone\fR +.PP +.PP +Example: \fBaddprinter command = /usr/bin/addprinter +\fR.PP +.TP \fBadmin users (S)\fR This is a list of users who will be granted administrative privileges on the share. This means that they @@ -1353,11 +1451,11 @@ Default: \fBno admin users\fR Example: \fBadmin users = jason\fR .TP \fBallow hosts (S)\fR -Synonym for \fIhosts allow\fR . +Synonym for \fIhosts allow\fR. .TP \fBallow trusted domains (G)\fR -This option only takes effect when the security option is set to -\fIserver\fR or \fIdomain\fR. +This option only takes effect when the \fIsecurity\fR option is set to +server or domain. If it is set to no, then attempts to connect to a resource from a domain or workgroup other than the one which smbd is running in will fail, even if that domain is trusted by the remote server @@ -1376,10 +1474,9 @@ Default: \fBallow trusted domains = yes\fR .TP \fBannounce as (G)\fR This specifies what type of server -\fBnmbd\fR -will announce itself as, to a network neighborhood browse +\fBnmbd\fRwill announce itself as, to a network neighborhood browse list. By default this is set to Windows NT. The valid options -are : "NT" (which is a synonym for "NT Server"), "NT Server", +are : "NT Server" (which can also be written as "NT"), "NT Workstation", "Win95" or "WfW" meaning Windows NT Server, Windows NT Workstation, Windows 95 and Windows for Workgroups respectively. Do not change this parameter unless you have a @@ -1402,17 +1499,7 @@ Default: \fBannounce version = 4.2\fR Example: \fBannounce version = 2.0\fR .TP \fBauto services (G)\fR -This is a list of services that you want to be -automatically added to the browse lists. This is most useful -for homes and printers services that would otherwise not be -visible. - -Note that if you just want all printers in your -printcap file loaded then the \fIload printers\fR option is easier. - -Default: \fBno auto services\fR - -Example: \fBauto services = fred lp colorlp\fR +This is a synonym for the \fIpreload\fR. .TP \fBavailable (S)\fR This parameter lets you "turn off" a service. If @@ -1425,8 +1512,8 @@ Default: \fBavailable = yes\fR \fBbind interfaces only (G)\fR This global parameter allows the Samba admin to limit what interfaces on a machine will serve smb requests. If -affects file service smbd(8) and -name service nmbd(8) in slightly +affects file service smbd(8)and +name service nmbd(8)in slightly different ways. For name service it causes \fBnmbd\fR to bind @@ -1446,8 +1533,7 @@ send packets that arrive through any interfaces not listed in the does defeat this simple check, however so it must not be used seriously as a security feature for \fBnmbd\fR. -For file service it causes smbd(8) -to bind only to the interface list given in the interfaces parameter. This restricts the networks that +For file service it causes smbd(8)to bind only to the interface list given in the interfaces parameter. This restricts the networks that \fBsmbd\fR will serve to packets coming in those interfaces. Note that you should not use this parameter for machines that are serving PPP or other intermittent or non-broadcast network @@ -1455,8 +1541,7 @@ interfaces as it will not cope with non-permanent interfaces. If \fIbind interfaces only\fR is set then unless the network address \fB127.0.0.1\fR is added -to the \fIinterfaces\fR parameter list \fBsmbpasswd(8)\fR -and \fBswat(8)\fR may +to the \fIinterfaces\fR parameter list \fBsmbpasswd(8)\fRand \fBswat(8)\fRmay not work as expected due to the reasons covered below. To change a users SMB password, the \fBsmbpasswd\fR @@ -1467,7 +1552,7 @@ network address \fB127.0.0.1\fR is added to the \fIinterfaces\fR parameter list then \fB smbpasswd\fR will fail to connect in it's default mode. \fBsmbpasswd\fR can be forced to use the primary IP interface of the local host by using its \fI-r remote machine\fR - parameter, with \fIremote machine\fR set +parameter, with \fIremote machine\fR set to the IP name of the primary interface of the local host. The \fBswat\fR status page tries to connect with @@ -1480,7 +1565,7 @@ and \fBnmbd\fR. Default: \fBbind interfaces only = no\fR .TP \fBblocking locks (S)\fR -This parameter controls the behavior of smbd(8) when given a request by a client +This parameter controls the behavior of smbd(8)when given a request by a client to obtain a byte range lock on a region of an open file, and the request has a time limit associated with it. @@ -1500,7 +1585,7 @@ Default: \fBblocking locks = yes\fR See the \fI browseable\fR. .TP \fBbrowse list (G)\fR -This controls whether \fBsmbd(8)\fR will serve a browse list to +This controls whether \fBsmbd(8)\fRwill serve a browse list to a client doing a \fBNetServerEnum\fR call. Normally set to true. You should never need to change this. @@ -1515,6 +1600,8 @@ Default: \fBbrowseable = yes\fR .TP \fBcase sensitive (S)\fR See the discussion in the section NAME MANGLING. + +Default: \fBcase sensitive = no\fR .TP \fBcasesignames (S)\fR Synonym for case @@ -1524,7 +1611,7 @@ sensitive. This SMB allows a client to tell a server to "watch" a particular directory for any changes and only reply to the SMB request when a change has occurred. Such constant scanning of -a directory is expensive under UNIX, hence an \fBsmbd(8)\fR daemon only performs such a scan +a directory is expensive under UNIX, hence an \fBsmbd(8)\fRdaemon only performs such a scan on each requested directory once every \fIchange notify timeout\fR seconds. @@ -1604,12 +1691,11 @@ page a Windows or DOS client is using, open a DOS command prompt and type the command \fBchcp\fR. This will output the code page. The default for USA MS-DOS, Windows 95, and Windows NT releases is code page 437. The default for western -european releases of the above operating systems is code page 850. +European releases of the above operating systems is code page 850. -This parameter tells smbd(8) -which of the \fIcodepage.XXX +This parameter tells smbd(8)which of the \fIcodepage.XXX \fRfiles to dynamically load on startup. These files, -described more fully in the manual page \fBmake_smbcodepage(1)\fR , tell \fB smbd\fR how to map lower to upper case characters to provide +described more fully in the manual page \fBmake_smbcodepage(1)\fR, tell \fB smbd\fR how to map lower to upper case characters to provide the case insensitivity of filenames that Windows clients expect. Samba currently ships with the following code page files : @@ -1670,7 +1756,7 @@ to 850. .PP .PP See also : \fIvalid -chars\fR +chars\fR, \fIcode page directory\fR .PP .PP Default: \fBclient code page = 850\fR @@ -1679,6 +1765,17 @@ Default: \fBclient code page = 850\fR Example: \fBclient code page = 936\fR .PP .TP +\fBcode page directory (G)\fR +Define the location of the various client code page +files. + +See also \fIclient +code page\fR + +Default: \fBcode page directory = ${prefix}/lib/codepages +\fR +Example: \fBcode page directory = /usr/share/samba/codepages +\fR.TP \fBcodingsystem (G)\fR This parameter is used to determine how incoming Shift-JIS Japanese characters are mapped from the incoming \fIclient code page\fR @@ -1722,6 +1819,8 @@ the Columbia AppleTalk Program (CAP), i.e. :AB. This is used for compatibility between Samba and CAP. .RE .PP +Default: \fBcoding system = \fR +.PP .TP \fBcomment (S)\fR This is a text field that is seen next to a share @@ -1766,7 +1865,7 @@ create similar services easily. Note that the service being copied must occur earlier in the configuration file than the service doing the copying. -Default: \fBnone\fR +Default: \fBno value\fR Example: \fBcopy = otherservice\fR .TP @@ -1840,14 +1939,6 @@ effect. Default: \fBdebug hires timestamp = no\fR .TP -\fBdebug timestamp (G)\fR -Samba 2.2 debug log messages are timestamped -by default. If you are running at a high \fIdebug level\fR these timestamps -can be distracting. This boolean parameter allows timestamping -to be turned off. - -Default: \fBdebug timestamp = yes\fR -.TP \fBdebug pid (G)\fR When using only one log file for more then one forked smbd-process there may be hard to follow which process @@ -1859,6 +1950,14 @@ effect. Default: \fBdebug pid = no\fR .TP +\fBdebug timestamp (G)\fR +Samba 2.2 debug log messages are timestamped +by default. If you are running at a high \fIdebug level\fR these timestamps +can be distracting. This boolean parameter allows timestamping +to be turned off. + +Default: \fBdebug timestamp = yes\fR +.TP \fBdebug uid (G)\fR Samba is sometimes run as root and sometime run as the connected user, this boolean parameter inserts the @@ -1870,7 +1969,7 @@ effect. Default: \fBdebug uid = no\fR .TP -\fBdebug level (G)\fR +\fBdebuglevel (G)\fR The value of the parameter (an integer) allows the debug level (logging level) to be specified in the \fIsmb.conf\fR file. This is to give greater @@ -1885,7 +1984,9 @@ Example: \fBdebug level = 3\fR A synonym for \fI default service\fR. .TP \fBdefault case (S)\fR -See the section on NAME MANGLING". Also note the \fIshort preserve case"\fR parameter. +See the section on NAME MANGLING. Also note the \fIshort preserve case"\fR parameter. + +Default: \fBdefault case = lower\fR .TP \fBdefault service (G)\fR This parameter specifies the name of a service @@ -1909,20 +2010,32 @@ used in the default service will get mapped to a "/". This allows for interesting things. Example: + .sp .nf - default service = pub +[global] + default service = pub - [pub] - path = /%S +[pub] + path = /%S .sp .fi .TP +\fBdelete readonly (S)\fR +This parameter allows readonly files to be deleted. +This is not normal DOS semantics, but is allowed by UNIX. + +This option may be useful for running applications such +as rcs, where UNIX file ownership prevents changing file +permissions, and DOS semantics prevent deletion of a read only file. + +Default: \fBdelete readonly = no\fR +.TP \fBdelete user script (G)\fR This is the full pathname to a script that will -be run \fBAS ROOT\fR by \fBsmbd(8)\fR under special circumstances -decribed below. +be run \fBAS ROOT\fR by \fBsmbd(8)\fRunder special circumstances +described below. Normally, a Samba server requires that UNIX users are created for all users accessing files on this server. For sites @@ -1972,16 +2085,33 @@ Default: \fBdelete user script = Example: \fBdelete user script = /usr/local/samba/bin/del_user %u\fR .TP -\fBdelete readonly (S)\fR -This parameter allows readonly files to be deleted. -This is not normal DOS semantics, but is allowed by UNIX. +\fBdeleteprinter command (G)\fR +With the introduction of MS-RPC based printer +support for Windows NT/2000 clients in Samba 2.2, it is now +possible to delete printer at run time by issuing the +DeletePrinter() RPC call. -This option may be useful for running applications such -as rcs, where UNIX file ownership prevents changing file -permissions, and DOS semantics prevent deletion of a read only file. +For a Samba host this means that the printer must be +physically deleted from underlying printing system. The \fI deleteprinter command\fR defines a script to be run which +will perform the necessary operations for removing the printer +from the print system and from \fIsmb.conf\fR. -Default: \fBdelete readonly = no\fR -.TP +The \fIdeleteprinter command\fR is +automatically called with only one parameter: \fI "printer name"\fR. + +Once the \fIdeleteprinter command\fR has +been executed, \fBsmbd\fR will reparse the \fI smb.conf\fR to associated printer no longer exists. +If the sharename is still valid, then \fBsmbd +\fRwill return an ACCESS_DENIED error to the client. + +See also \fI addprinter command\fR, \fIprinting\fR, +\fIshow add +printer wizard\fR + +Default: \fBnone\fR + +Example: \fBdeleteprinter command = /usr/bin/removeprinter +\fR.TP \fBdelete veto files (S)\fR This option is used when Samba is attempting to delete a directory that contains one or more vetoed directories @@ -2026,7 +2156,7 @@ this function. The external program will be passed a single parameter indicating a directory in the filesystem being queried. This will typically consist of the string \fI./\fR. The script should return two -integers in ascii. The first should be the total disk space in blocks, +integers in ASCII. The first should be the total disk space in blocks, and the second should be the number of available blocks. An optional third return value can give the block size in bytes. The default blocksize is 1024 bytes. @@ -2142,8 +2272,7 @@ directory mask>\fR Example: \fBdirectory security mask = 0777\fR .TP \fBdns proxy (G)\fR -Specifies that nmbd(8) -when acting as a WINS server and finding that a NetBIOS name has not +Specifies that nmbd(8)when acting as a WINS server and finding that a NetBIOS name has not been registered, should treat the NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server for that name on behalf of the name-querying client. @@ -2211,14 +2340,13 @@ the file DOMAINS.txt in the Samba documentation directory \fIdocs/ Default: \fBdomain logons = no\fR .TP \fBdomain master (G)\fR -Tell \fB nmbd(8)\fR to enable WAN-wide browse list +Tell \fB nmbd(8)\fRto enable WAN-wide browse list collation. Setting this option causes \fBnmbd\fR to claim a special domain specific NetBIOS name that identifies it as a domain master browser for its given \fIworkgroup\fR. Local master browsers in the same \fIworkgroup\fR on broadcast-isolated subnets will give this \fBnmbd\fR their local browse lists, -and then ask \fBsmbd(8)\fR -for a complete copy of the browse list for the whole wide area +and then ask \fBsmbd(8)\fRfor a complete copy of the browse list for the whole wide area network. Browser clients will then contact their local master browser, and will receive the domain-wide browse list, instead of just the list for their broadcast-isolated subnet. @@ -2233,7 +2361,13 @@ the special name for a \fIworkgroup\fR before a Windows NT PDC is able to do so then cross subnet browsing will behave strangely and may fail. -Default: \fBdomain master = no\fR +If \fBdomain logons = yes\fR +, then the default behavior is to enable the \fIdomain +master\fR parameter. If \fIdomain logons\fR is +not enabled (the default setting), then neither will \fIdomain +master\fR be enabled by default. + +Default: \fBdomain master = auto\fR .TP \fBdont descend (S)\fR There are certain directories on some systems @@ -2251,13 +2385,27 @@ to descend)\fR Example: \fBdont descend = /proc,/dev\fR .TP +\fBdos filemode (S)\fR +The default behavior in Samba is to provide +UNIX-like behavor where only the owner of a file/directory is +able to change the permissions on it. However, this behavior +is often confusing to DOS/Windows users. Enabling this parameter +allows a user who has write access to the file (by whatever +means) to modify the permissions on it. Note that a user +belonging to the group owning the file will not be allowed to +change permissions if the group is only granted read access. +Ownership of the file/directory is not changed, only the permissions +are modified. + +Default: \fBdos filemode = no\fR +.TP \fBdos filetime resolution (S)\fR Under the DOS and Windows FAT filesystem, the finest granularity on time resolution is two seconds. Setting this parameter for a share causes Samba to round the reported time down to the nearest two second boundary when a query call that requires one second resolution is made to \fBsmbd(8)\fR - . +. This option is mainly used as a compatibility option for Visual C++ when used against Samba shares. If oplocks are enabled on a @@ -2292,15 +2440,58 @@ Samba see the file ENCRYPTION.txt in the Samba documentation directory \fIdocs/\fR shipped with the source code. In order for encrypted passwords to work correctly -\fBsmbd(8)\fR must either +\fBsmbd(8)\fRmust either have access to a local \fIsmbpasswd(5) -\fR file (see the \fB smbpasswd(8)\fR program for information on how to set up +\fRprogram for information on how to set up and maintain this file), or set the security=[serve|domain] parameter which causes \fBsmbd\fR to authenticate against another server. Default: \fBencrypt passwords = no\fR .TP +\fBenhanced browsing (G)\fR +This option enables a couple of enhancements to +cross-subnet browse propogation that have been added in Samba +but which are not standard in Microsoft implementations. +\fBThese enhancements are currently only available in +the HEAD Samba CVS tree (not Samba 2.2.x).\fR + +The first enhancement to browse propogation consists of a regular +wildcard query to a Samba WINS server for all Domain Master Browsers, +followed by a browse synchronisation with each of the returned +DMBs. The second enhancement consists of a regular randomised browse +synchronisation with all currently known DMBs. + +You may wish to disable this option if you have a problem with empty +workgroups not disappearing from browse lists. Due to the restrictions +of the browse protocols these enhancements can cause a empty workgroup +to stay around forever which can be annoying. + +In general you should leave this option enabled as it makes +cross-subnet browse propogation much more reliable. + +Default: \fBenhanced browsing = yes\fR +.TP +\fBenumports command (G)\fR +The concept of a "port" is fairly foreign +to UNIX hosts. Under Windows NT/2000 print servers, a port +is associated with a port monitor and generally takes the form of +a local port (i.e. LPT1:, COM1:, FILE:) or a remote port +(i.e. LPD Port Monitor, etc...). By default, Samba has only one +port defined--"Samba Printer Port". Under +Windows NT/2000, all printers must have a valid port name. +If you wish to have a list of ports displayed (\fBsmbd +\fRdoes not use a port name for anything) other than +the default "Samba Printer Port", you +can define \fIenumports command\fR to point to +a program which should generate a list of ports, one per line, +to standard output. This listing will then be used in response +to the level 1 and 2 EnumPorts() RPC. + +Default: \fBno enumports command\fR + +Example: \fBenumports command = /usr/bin/listports +\fR.TP \fBexec (S)\fR This is a synonym for \fIpreexec\fR. .TP @@ -2323,9 +2514,11 @@ timestamp than the object files it contains. However, Unix time semantics mean that the create time reported by Samba will be updated whenever a file is created or -deleted in the directory. NMAKE therefore finds all object files -in the object directory bar the last one built are out of date -compared to the directory and rebuilds them. Enabling this option +or deleted in the directory. NMAKE finds all object files in +the object directory. The timestamp of the last one built is then +compared to the timestamp of the object dircetory. If the +directory's timestamp if newer, then all object files +will be rebuilt. Enabling this option ensures directories always predate their contents and an NMAKE build will proceed as expected. @@ -2339,7 +2532,7 @@ that it is the only one accessing the file and it will aggressively cache file data. With some oplock types the client may even cache file open/close operations. This can give enormous performance benefits. -When you set \fBfake oplocks = yes\fR, \fBsmbd(8)\fR will +When you set \fBfake oplocks = yes\fR, \fBsmbd(8)\fRwill always grant oplock requests no matter how many clients are using the file. @@ -2358,8 +2551,7 @@ Default: \fBfake oplocks = no\fR .TP \fBfollow symlinks (S)\fR This parameter allows the Samba administrator -to stop \fBsmbd(8)\fR -from following symbolic links in a particular share. Setting this +to stop \fBsmbd(8)\fRfrom following symbolic links in a particular share. Setting this parameter to no prevents any file or directory that is a symbolic link from being followed (the user will get an error). This option is very useful to stop users from adding a @@ -2375,7 +2567,7 @@ Default: \fBfollow symlinks = yes\fR \fBforce create mode (S)\fR This parameter specifies a set of UNIX mode bit permissions that will \fBalways\fR be set on a -file by Samba. This is done by bitwise 'OR'ing these bits onto +file created by Samba. This is done by bitwise 'OR'ing these bits onto the mode bits of a file that is being created or having its permissions changed. The default for this parameter is (in octal) 000. The modes in this parameter are bitwise 'OR'ed onto the file @@ -2419,7 +2611,7 @@ would force all created directories to have read and execute permissions set for 'group' and 'other' as well as the read/write/execute bits set for the 'user'. .TP -\fBforce directory security mode (S)\fR +\fBforce directory security mode (S)\fR This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating the UNIX permission on a directory using the native NT security dialog box. @@ -2434,7 +2626,7 @@ If not set explicitly this parameter is set to the same value as the \fIforce directory mode\fR parameter. To allow a user to modify all the user/group/world permissions on a -directory, with restrictions set this parameter to 000. +directory without restrictions, set this parameter to 000. \fBNote\fR that users who can access the Samba server through other means can easily bypass this restriction, @@ -2528,9 +2720,7 @@ This user name only gets used once a connection is established. Thus clients still need to connect as a valid user and supply a valid password. Once connected, all file operations will be performed as the "forced user", no matter what username the client connected -as. - -This can be very useful. +as. This can be very useful. In Samba 2.0.5 and above this parameter also causes the primary group of the forced user to be used as the primary group @@ -2547,7 +2737,7 @@ Example: \fBforce user = auser\fR This parameter allows the administrator to configure the string that specifies the type of filesystem a share is using that is reported by \fBsmbd(8) -\fR when a client queries the filesystem type +\fRwhen a client queries the filesystem type for a share. The default type is NTFS for compatibility with Windows NT but this can be changed to other strings such as Samba or FAT @@ -2564,7 +2754,7 @@ calls. This can have a significant impact on performance, especially when the \fIwide links\fR parameter is set to False. -Default: \fBgetwd cache = No\fR +Default: \fBgetwd cache = yes\fR .TP \fBgroup (S)\fR Synonym for \fIforce @@ -2573,7 +2763,7 @@ group\fR. \fBguest account (S)\fR This is a username which will be used for access to services which are specified as \fI guest ok\fR (see below). Whatever privileges this -ser has will be available to any client connecting to the guest service. +user has will be available to any client connecting to the guest service. Typically this user will exist in the password file, but will not have a valid login. The user account "ftp" is often a good choice for this parameter. If a username is specified in a given service, @@ -2592,7 +2782,7 @@ Example: \fBguest account = ftp\fR .TP \fBguest ok (S)\fR If this parameter is yes for -a service, then no password is equired to connect to the service. +a service, then no password is required to connect to the service. Privileges will be those of the \fI guest account\fR. See the section below on \fI security\fR for more information about this option. @@ -2602,7 +2792,7 @@ Default: \fBguest ok = no\fR \fBguest only (S)\fR If this parameter is yes for a service, then only guest connections to the service are permitted. -This parameter will have no affect if \fIguest ok\fR is not set for the service. +This parameter will have no effect if \fIguest ok\fR is not set for the service. See the section below on \fI security\fR for more information about this option. @@ -2655,7 +2845,7 @@ Default: \fBhide local users = no\fR .TP \fBhomedir map (G)\fR If\fInis homedir -\fRis True, and \fBsmbd(8)\fR is also acting +\fRis True, and \fBsmbd(8)\fRis also acting as a Win95/98 \fIlogon server\fR then this parameter specifies the NIS (or YP) map from which the server for the user's home directory should be extracted. At present, only the Sun @@ -2675,10 +2865,22 @@ See also \fInis homedir\fR , \fIdomain logons\fR \&. -Default: \fBhomedir map = auto.home\fR +Default: \fBhomedir map = \fR Example: \fBhomedir map = amd.homedir\fR .TP +\fBhost msdfs (G)\fR +This boolean parameter is only available +if Samba has been configured and compiled with the \fB --with-msdfs\fR option. If set to yes, +Samba will act as a Dfs server, and allow Dfs-aware clients +to browse Dfs trees hosted on the server. + +See also the \fI msdfs root\fR share level parameter. For +more information on setting up a Dfs tree on Samba, +refer to msdfs_setup.html. + +Default: \fBhost msdfs = no\fR +.TP \fBhosts allow (S)\fR A synonym for this parameter is \fIallow hosts\fR. @@ -2728,7 +2930,7 @@ deny access from one particular host Note that access still requires suitable user-level passwords. See \fBtestparm(1)\fR - for a way of testing your host access to see if it does +for a way of testing your host access to see if it does what you expect. Default: \fBnone (i.e., all hosts permitted access) @@ -2840,12 +3042,12 @@ a broadcast/mask pair. .PP The "mask" parameters can either be a bit length (such as 24 for a C class network) or a full netmask in dotted -decmal form. +decimal form. .PP .PP The "IP" parameters above can either be a full dotted decimal IP address or a hostname which will be looked up via -the OSes normal hostname resolution mechanisms. +the OS's normal hostname resolution mechanisms. .PP .PP For example, the following line: @@ -2862,6 +3064,10 @@ The netmasks of the latter two interfaces would be set to 255.255.255.0. See also \fIbind interfaces only\fR. .PP +.PP +Default: \fBall active interfaces except 127.0.0.1 +that are broadcast capable\fR +.PP .TP \fBinvalid users (S)\fR This is a list of users that should not be allowed @@ -2905,19 +3111,19 @@ Keepalives should, in general, not be needed if the socket being used has the SO_KEEPALIVE attribute set on it (see \fIsocket options\fR). Basically you should only use this option if you strike difficulties. -Default: \fBkeepalive = 0\fR +Default: \fBkeepalive = 300\fR -Example: \fBkeepalive = 60\fR +Example: \fBkeepalive = 600\fR .TP \fBkernel oplocks (G)\fR -For UNIXs that support kernel based \fIoplocks\fR +For UNIXes that support kernel based \fIoplocks\fR (currently only IRIX and the Linux 2.4 kernel), this parameter allows the use of them to be turned on or off. Kernel oplocks support allows Samba \fIoplocks \fRto be broken whenever a local UNIX process or NFS operation accesses a file that \fBsmbd(8)\fR - has oplocked. This allows complete data consistency between +has oplocked. This allows complete data consistency between SMB/CIFS, NFS and local file access (and is a \fBvery\fR cool feature :-). @@ -2931,6 +3137,15 @@ and \fIlevel2 oplocks Default: \fBkernel oplocks = yes\fR .TP +\fBlanman auth (G)\fR +This parameter determines whether or not smbd will +attempt to authentication users using the LANMAN password hash. +If disabled, only clients which support NT password hashes (e.g. Windows +NT/2000 clients, smbclient, etc... but not Windows 95/98 or the MS DOS +network client) will be able to connect to the Samba host. + +Default : \fBlanman auth = yes\fR +.TP \fBlevel2 oplocks (S)\fR This parameter controls whether Samba supports level2 (read-only) oplocks on a share. @@ -2942,7 +3157,7 @@ of releasing all oplocks on a second open, as in traditional, exclusive oplocks). This allows all openers of the file that support level2 oplocks to cache the file for read-ahead only (ie. they may not cache writes or lock requests) and increases performance -for many acesses of files that are not commonly written (such as +for many accesses of files that are not commonly written (such as application .EXE files). Once one of the clients which have a read-only oplock @@ -2951,8 +3166,7 @@ or waited for) and told to break their oplocks to "none" and delete any read-ahead caches. It is recommended that this parameter be turned on -to speed access to shared executables (and also to test -the code :-). +to speed access to shared executables. For more discussions on level2 oplocks see the CIFS spec. @@ -2967,10 +3181,10 @@ See also the \fIoplocks\fR and \fIkernel oplocks\fR parameters. -Default: \fBlevel2 oplocks = False\fR +Default: \fBlevel2 oplocks = yes\fR .TP \fBlm announce (G)\fR -This parameter determines if \fBnmbd(8)\fR will produce Lanman announce +This parameter determines if \fBnmbd(8)\fRwill produce Lanman announce broadcasts that are needed by OS/2 clients in order for them to see the Samba server in their browse list. This parameter can have three values, true, false, or @@ -2989,7 +3203,7 @@ See also \fIlm interval Default: \fBlm announce = auto\fR -Example: \fBlm announce = true\fR +Example: \fBlm announce = yes\fR .TP \fBlm interval (G)\fR If Samba is set to produce Lanman announce @@ -3015,7 +3229,7 @@ more details. Default: \fBload printers = yes\fR .TP \fBlocal master (G)\fR -This option allows \fB nmbd(8)\fR to try and become a local master browser +This option allows \fB nmbd(8)\fRto try and become a local master browser on a subnet. If set to False then \fB nmbd\fR will not attempt to become a local master browser on a subnet and will also lose in all browsing elections. By default this value is set to true. Setting this value to true doesn't @@ -3036,18 +3250,18 @@ files will be placed. The lock files are used to implement the \fImax connections\fR option. -Default: \fBlock directory = /tmp/samba\fR +Default: \fBlock directory = ${prefix}/var/locks\fR -Example: \fBlock directory = /usr/local/samba/var/locks\fR +Example: \fBlock directory = /var/run/samba/locks\fR .TP \fBlocking (S)\fR This controls whether or not locking will be performed by the server in response to lock requests from the client. -If \fBlocking = no\fR, all lock and unlock requests -will appear to succeed and all lock queries will indicate that the -queried lock is clear. +If \fBlocking = no\fR, all lock and unlock +requests will appear to succeed and all lock queries will report +that the file in question is available for locking. If \fBlocking = yes\fR, real locking will be performed by the server. @@ -3064,7 +3278,7 @@ You should never need to set this parameter. Default: \fBlocking = yes\fR .TP \fBlog file (G)\fR -This options allows you to override the name +This option allows you to override the name of the Samba log file (also known as the debug file). This option takes the standard substitutions, allowing @@ -3103,7 +3317,7 @@ This parameter can be used with Win9X workstations to ensure that roaming profiles are stored in a subdirectory of the user's home directory. This is done in the following way: -\fBlogon home = \\\\%L\\%U\\profile\fR +\fBlogon home = \\\\%N\\%U\\profile\fR This tells Samba to return the above string, with substitutions made when a client requests the info, generally @@ -3291,15 +3505,15 @@ is put in its place. Otherwise it is placed at the end of the command. Note that it is good practice to include the absolute path -in the \fIlpq command\fR as the PATH may not be -available to the server. +in the \fIlpq command\fR as the \fB$PATH +\fRmay not be available to the server. See also the \fIprinting \fRparameter. Default: \fBdepends on the setting of \fI printing\fB\fR -Example: \fBlpq command = /usr/bin/lpq %p\fR +Example: \fBlpq command = /usr/bin/lpq -P%p\fR .TP \fBlpresume command (S)\fR This parameter specifies the command to be @@ -3363,14 +3577,14 @@ Example 2: \fBlprm command = /usr/bin/cancel %p-%j \fBmachine password timeout (G)\fR If a Samba server is a member of an Windows NT Domain (see the security=domain) -parameter) then periodically a running smbd(8) process will try and change the MACHINE ACCOUNT +parameter) then periodically a running smbd(8)process will try and change the MACHINE ACCOUNT PASSWORD stored in the TDB called \fIprivate/secrets.tdb \fR\&. This parameter specifies how often this password will be changed, in seconds. The default is one week (expressed in seconds), the same as a Windows NT Domain member server. See also \fBsmbpasswd(8) -\fR , and the security=domain) parameter. +\fR, and the security=domain) parameter. Default: \fBmachine password timeout = 604800\fR .TP @@ -3395,13 +3609,14 @@ This allows a UNIX script to be sent to the Samba host and executed on behalf of the connected user. Scripts executed in this way will be deleted upon -completion, permissions permitting. +completion assuming that the user has the appripriate level +of priviledge and the ile permissions allow the deletion. If the script generates output, output will be sent to the file specified by the \fI magic output\fR parameter (see above). Note that some shells are unable to interpret scripts -containing carriage-return-linefeed instead of linefeed as +containing CR/LF instead of CR as the end-of-line marker. Magic scripts must be executable \fBas is\fR on the host, which for some hosts and some shells will require filtering at the DOS end. @@ -3415,6 +3630,8 @@ Example: \fBmagic script = user.csh\fR .TP \fBmangle case (S)\fR See the section on NAME MANGLING + +Default: \fBmangle case = no\fR .TP \fBmangled map (S)\fR This is for those who want to directly map UNIX @@ -3432,7 +3649,7 @@ you would use: One very useful case is to remove the annoying \fI;1 \fRoff the ends of filenames on some CDROMS (only visible -under some UNIXs). To do this use a map of (*;1 *;). +under some UNIXes). To do this use a map of (*;1 *;). Default: \fBno mangled map\fR @@ -3501,19 +3718,9 @@ do not change between sessions. Default: \fBmangled names = yes\fR .PP .TP -\fBmangling char (S)\fR -This controls what character is used as -the \fBmagic\fR character in name mangling. The default is a '~' -but this may interfere with some software. Use this option to set -it to whatever you prefer. - -Default: \fBmangling char = ~\fR - -Example: \fBmangling char = ^\fR -.TP \fBmangled stack (G)\fR This parameter controls the number of mangled names -that should be cached in the Samba server smbd(8) . +that should be cached in the Samba server smbd(8). This stack is a list of recently mangled base names (extensions are only maintained if they are longer than 3 characters @@ -3531,6 +3738,16 @@ Default: \fBmangled stack = 50\fR Example: \fBmangled stack = 100\fR .TP +\fBmangling char (S)\fR +This controls what character is used as +the \fBmagic\fR character in name mangling. The default is a '~' +but this may interfere with some software. Use this option to set +it to whatever you prefer. + +Default: \fBmangling char = ~\fR + +Example: \fBmangling char = ^\fR +.TP \fBmap archive (S)\fR This controls whether the DOS archive attribute should be mapped to the UNIX owner execute bit. The DOS archive bit @@ -3571,7 +3788,7 @@ This parameter is only useful in security modes other than \fIsecurity=share\fR and domain. This parameter can take three different values, which tell -smbd(8) what to do with user +smbd(8)what to do with user login requests that don't match a valid UNIX user in some way. The three settings are : @@ -3593,7 +3810,7 @@ Bad Password - Means user logins with an invalid password are treated as a guest login and mapped into the guest account. Note that this can cause problems as it means that any user incorrectly typing -their password will be silently logged on as a "guest" - and +their password will be silently logged on as "guest" - and will not know the reason they cannot access files they think they should - there will have been no message given to them that they got their password wrong. Helpdesk services will @@ -3679,7 +3896,7 @@ Default: \fBmax mux = 50\fR .TP \fBmax open files (G)\fR This parameter limits the maximum number of -open files that one smbd(8) file +open files that one smbd(8)file serving process may have open for a client at any one time. The default for this parameter is set very high (10,000) as Samba uses only one bit per unopened file. @@ -3690,9 +3907,74 @@ this parameter so you should never need to touch this parameter. Default: \fBmax open files = 10000\fR .TP +\fBmax print jobs (S)\fR +This parameter limits the maximum number of +jobs allowable in a Samba printer queue at any given moment. +If this number is exceeded, \fB smbd(8)\fRwill remote "Out of Space" to the client. +See all \fItotal +print jobs\fR. + +Default: \fBmax print jobs = 1000\fR + +Example: \fBmax print jobs = 5000\fR +.TP +\fBmax protocol (G)\fR +The value of the parameter (a string) is the highest +protocol level that will be supported by the server. + +Possible values are : +.RS +.TP 0.2i +\(bu +CORE: Earliest version. No +concept of user names. +.TP 0.2i +\(bu +COREPLUS: Slight improvements on +CORE for efficiency. +.TP 0.2i +\(bu +LANMAN1: First \fB modern\fR version of the protocol. Long filename +support. +.TP 0.2i +\(bu +LANMAN2: Updates to Lanman1 protocol. +.TP 0.2i +\(bu +NT1: Current up to date version of +the protocol. Used by Windows NT. Known as CIFS. +.RE +.PP +Normally this option should not be set as the automatic +negotiation phase in the SMB protocol takes care of choosing +the appropriate protocol. +.PP +.PP +See also \fImin +protocol\fR +.PP +.PP +Default: \fBmax protocol = NT1\fR +.PP +.PP +Example: \fBmax protocol = LANMAN1\fR +.PP +.TP +\fBmax smbd processes (G)\fR +This parameter limits the maximum number of +\fBsmbd(8)\fRprocesses concurrently running on a system and is intended +as a stop gap to prevent degrading service to clients in the event +that the server has insufficient resources to handle more than this +number of connections. Remember that under normal operating +conditions, each user will have an smbd associated with him or her +to handle connections to all shares from a given host. + +Default: \fBmax smbd processes = 0\fR ## no limit + +Example: \fBmax smbd processes = 1000\fR +.TP \fBmax ttl (G)\fR -This option tells nmbd(8) -what the default 'time to live' of NetBIOS names should be (in seconds) +This option tells nmbd(8)what the default 'time to live' of NetBIOS names should be (in seconds) when \fBnmbd\fR is requesting a name using either a broadcast packet or from a WINS server. You should never need to change this parameter. The default is 3 days. @@ -3701,7 +3983,7 @@ Default: \fBmax ttl = 259200\fR .TP \fBmax wins ttl (G)\fR This option tells nmbd(8) - when acting as a WINS server ( \fIwins support=yes\fR) what the maximum +when acting as a WINS server ( \fIwins support=yes\fR) what the maximum \&'time to live' of NetBIOS names that \fBnmbd\fR will grant will be (in seconds). You should never need to change this parameter. The default is 6 days (518400 seconds). @@ -3792,6 +4074,20 @@ Example: \fBmessage command = csh -c 'xedit %s; rm %s' &\fR .PP .TP +\fBmin passwd length (G)\fR +Synonym for \fImin password length\fR. +.TP +\fBmin password length (G)\fR +This option sets the minimum length in characters +of a plaintext password that \fBsmbd\fR will accept when performing +UNIX password changing. + +See also \fIunix +password sync\fR, \fIpasswd program\fR and \fIpasswd chat debug\fR +\&. + +Default: \fBmin password length = 5\fR +.TP \fBmin print space (S)\fR This sets the minimum amount of free disk space that must be available before a user will be able to spool @@ -3805,34 +4101,53 @@ Default: \fBmin print space = 0\fR Example: \fBmin print space = 2000\fR .TP -\fBmin passwd length (G)\fR -Synonym for \fImin password length\fR. -.TP -\fBmin password length (G)\fR -This option sets the minimum length in characters -of a plaintext password than smbd will accept when performing -UNIX password changing. +\fBmin protocol (G)\fR +The value of the parameter (a string) is the +lowest SMB protocol dialect than Samba will support. Please refer +to the \fImax protocol\fR +parameter for a list of valid protocol names and a brief description +of each. You may also wish to refer to the C source code in +\fIsource/smbd/negprot.c\fR for a listing of known protocol +dialects supported by clients. + +If you are viewing this parameter as a security measure, you should +also refer to the \fIlanman +auth\fR parameter. Otherwise, you should never need +to change this parameter. -See also \fIunix -password sync\fR, \fIpasswd program\fR and \fIpasswd chat debug\fR -\&. +Default : \fBmin protocol = CORE\fR -Default: \fBmin password length = 5\fR +Example : \fBmin protocol = NT1\fR # disable DOS +clients .TP \fBmin wins ttl (G)\fR -This option tells nmbd(8) -when acting as a WINS server (\fI wins support = yes\fR) what the minimum 'time to live' +This option tells nmbd(8)when acting as a WINS server (\fI wins support = yes\fR) what the minimum 'time to live' of NetBIOS names that \fBnmbd\fR will grant will be (in seconds). You should never need to change this parameter. The default is 6 hours (21600 seconds). Default: \fBmin wins ttl = 21600\fR .TP +\fBmsdfs root (S)\fR +This boolean parameter is only available if +Samba is configured and compiled with the \fB --with-msdfs\fR option. If set to yes>, +Samba treats the share as a Dfs root and allows clients to browse +the distributed file system tree rooted at the share directory. +Dfs links are specified in the share directory by symbolic +links of the form \fImsdfs:serverA\\shareA,serverB\\shareB +\fRand so on. For more information on setting up a Dfs tree +on Samba, refer to msdfs_setup.html +. + +See also \fIhost msdfs +\fR +Default: \fBmsdfs root = no\fR +.TP \fBname resolve order (G)\fR This option is used by the programs in the Samba -suite to determine what naming services and in what order to resolve -host names to IP addresses. The option takes a space separated -string of different name resolution options. +suite to determine what naming services to use and in what order +to resolve host names to IP addresses. The option takes a space +separated string of name resolution options. The options are :"lmhosts", "host", "wins" and "bcast". They cause names to be resolved as follows : @@ -3841,7 +4156,7 @@ cause names to be resolved as follows : \(bu lmhosts : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has -no name type attached to the NetBIOS name (see the lmhosts(5) for details) then +no name type attached to the NetBIOS name (see the lmhosts(5)for details) then any name type matches for lookup. .TP 0.2i \(bu @@ -3879,7 +4194,7 @@ system hostname lookup. .PP .TP \fBnetbios aliases (G)\fR -This is a list of NetBIOS names that nmbd(8) will advertise as additional +This is a list of NetBIOS names that nmbd(8)will advertise as additional names by which the Samba server is known. This allows one machine to appear in browse lists under multiple names. If a machine is acting as a browse server or logon server none @@ -3943,14 +4258,14 @@ Default: \fBnis homedir = no\fR .TP \fBnt acl support (G)\fR This boolean parameter controls whether -smbd(8) will attempt to map +smbd(8)will attempt to map UNIX permissions into Windows NT access control lists. Default: \fBnt acl support = yes\fR .TP \fBnt pipe support (G)\fR This boolean parameter controls whether -smbd(8) will allow Windows NT +smbd(8)will allow Windows NT clients to connect to the NT SMB specific IPC$ pipes. This is a developer debugging option and can be left alone. @@ -3958,7 +4273,7 @@ alone. Default: \fBnt pipe support = yes\fR .TP \fBnt smb support (G)\fR -This boolean parameter controls whether smbd(8) will negotiate NT specific SMB +This boolean parameter controls whether smbd(8)will negotiate NT specific SMB support with Windows NT clients. Although this is a developer debugging option and should be left alone, benchmarking has discovered that Windows NT clients give faster performance with this option @@ -3968,36 +4283,27 @@ exactly the same SMB calls that versions prior to Samba 2.0 offered. This information may be of use if any users are having problems with NT SMB support. -Default: \fBnt support = yes\fR +You should not need to ever disable this parameter. + +Default: \fBnt smb support = yes\fR .TP \fBnull passwords (G)\fR Allow or disallow client access to accounts that have null passwords. -See also smbpasswd (5) . +See also smbpasswd (5). Default: \fBnull passwords = no\fR .TP -\fBole locking compatibility (G)\fR -This parameter allows an administrator to turn -off the byte range lock manipulation that is done within Samba to -give compatibility for OLE applications. Windows OLE applications -use byte range locking as a form of inter-process communication, by -locking ranges of bytes around the 2^32 region of a file range. This -can cause certain UNIX lock managers to crash or otherwise cause -problems. Setting this parameter to no means you -trust your UNIX lock manager to handle such cases correctly. - -Default: \fBole locking compatibility = yes\fR -.TP -\fBonly guest (S)\fR -A synonym for \fI guest only\fR. -.TP \fBonly user (S)\fR This is a boolean option that controls whether connections with usernames not in the \fIuser\fR -list will be allowed. By default this option is disabled so a client -can supply a username to be used by the server. +list will be allowed. By default this option is disabled so that a +client can supply a username to be used by the server. Enabling +this parameter will force the server to only user the login +names from the \fIuser\fR list and is only really +useful in shave level +security. Note that this also means Samba won't try to deduce usernames from the service name. This can be annoying for @@ -4011,34 +4317,26 @@ parameter. Default: \fBonly user = no\fR .TP -\fBoplocks (S)\fR -This boolean option tells smbd whether to -issue oplocks (opportunistic locks) to file open requests on this -share. The oplock code can dramatically (approx. 30% or more) improve -the speed of access to files on Samba servers. It allows the clients -to aggressively cache files ocally and you may want to disable this -option for unreliable network environments (it is turned on by -default in Windows NT Servers). For more information see the file -\fISpeed.txt\fR in the Samba \fIdocs/\fR -directory. - -Oplocks may be selectively turned off on certain files on -a per share basis. See the \fI veto oplock files\fR parameter. On some systems -oplocks are recognized by the underlying operating system. This -allows data synchronization between all access to oplocked files, -whether it be via Samba or NFS or a local UNIX process. See the -\fIkernel oplocks\fR parameter for details. - -See also the \fIkernel -oplocks\fR and \fI level2 oplocks\fR parameters. +\fBole locking compatibility (G)\fR +This parameter allows an administrator to turn +off the byte range lock manipulation that is done within Samba to +give compatibility for OLE applications. Windows OLE applications +use byte range locking as a form of inter-process communication, by +locking ranges of bytes around the 2^32 region of a file range. This +can cause certain UNIX lock managers to crash or otherwise cause +problems. Setting this parameter to no means you +trust your UNIX lock manager to handle such cases correctly. -Default: \fBoplocks = yes\fR +Default: \fBole locking compatibility = yes\fR +.TP +\fBonly guest (S)\fR +A synonym for \fI guest only\fR. .TP \fBoplock break wait time (G)\fR This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too quickly when that client issues an SMB that can cause an oplock -break request, then the client redirector can fail and not respond +break request, then the network client can fail and not respond to the break request. This tuning parameter (which is set in milliseconds) is the amount of time Samba will wait before sending an oplock break request to such (broken) clients. @@ -4046,11 +4344,11 @@ request to such (broken) clients. \fBDO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ AND UNDERSTOOD THE SAMBA OPLOCK CODE\fR. -Default: \fBoplock break wait time = 10\fR +Default: \fBoplock break wait time = 0\fR .TP \fBoplock contention limit (S)\fR This is a \fBvery\fR advanced -smbd(8) tuning option to +smbd(8)tuning option to improve the efficiency of the granting of oplocks under multiple client contention for the same file. @@ -4065,23 +4363,69 @@ AND UNDERSTOOD THE SAMBA OPLOCK CODE\fR. Default: \fBoplock contention limit = 2\fR .TP +\fBoplocks (S)\fR +This boolean option tells smbd whether to +issue oplocks (opportunistic locks) to file open requests on this +share. The oplock code can dramatically (approx. 30% or more) improve +the speed of access to files on Samba servers. It allows the clients +to aggressively cache files locally and you may want to disable this +option for unreliable network environments (it is turned on by +default in Windows NT Servers). For more information see the file +\fISpeed.txt\fR in the Samba \fIdocs/\fR +directory. + +Oplocks may be selectively turned off on certain files with a +share. See the \fI veto oplock files\fR parameter. On some systems +oplocks are recognized by the underlying operating system. This +allows data synchronization between all access to oplocked files, +whether it be via Samba or NFS or a local UNIX process. See the +\fIkernel oplocks\fR parameter for details. + +See also the \fIkernel +oplocks\fR and \fI level2 oplocks\fR parameters. + +Default: \fBoplocks = yes\fR +.TP \fBos level (G)\fR This integer value controls what level Samba advertises itself as for browse elections. The value of this -parameter determines whether nmbd(8) -has a chance of becoming a local master browser for the \fI WORKGROUP\fR in the local broadcast area. The default is -zero, which means \fBnmbd\fR will lose elections to -Windows machines. See \fIBROWSING.txt\fR in the -Samba \fIdocs/\fR directory for details. +parameter determines whether nmbd(8)has a chance of becoming a local master browser for the \fI WORKGROUP\fR in the local broadcast area. + +\fBNote :\fRBy default, Samba will win +a local master browsing election over all Microsoft operating +systems except a Windows NT 4.0/2000 Domain Controller. This +means that a misconfigured Samba host can effectively isolate +a subnet for browsing purposes. See \fIBROWSING.txt +\fRin the Samba \fIdocs/\fR directory +for details. Default: \fBos level = 20\fR Example: \fBos level = 65 \fR .TP +\fBos2 driver map (G)\fR +The parameter is used to define the absolute +path to a file containing a mapping of Windows NT printer driver +names to OS/2 printer driver names. The format is: + + = . + +For example, a valid entry using the HP LaserJet 5 +printer driver woudl appear as \fBHP LaserJet 5L = LASERJET.HP +LaserJet 5L\fR. + +The need for the file is due to the printer driver namespace +problem described in the Samba +Printing HOWTO. For more details on OS/2 clients, please +refer to the OS2-Client-HOWTO +containing in the Samba documentation. + +Default: \fBos2 driver map = +\fR.TP \fBpanic action (G)\fR This is a Samba developer option that allows a -system command to be called when either smbd(8) or nmbd(8) -crashes. This is usually used to draw attention to the fact that +system command to be called when either smbd(8)crashes. This is usually used to draw attention to the fact that a problem occurred. Default: \fBpanic action = \fR @@ -4090,9 +4434,9 @@ Example: \fBpanic action = "/bin/sleep 90000"\fR .TP \fBpasswd chat (G)\fR This string controls the \fB"chat"\fR -conversation that takes places between smbd and the local password changing +conversation that takes places between smbdand the local password changing program to change the users password. The string describes a -sequence of response-receive pairs that smbd(8) uses to determine what to send to the +sequence of response-receive pairs that smbd(8)uses to determine what to send to the \fIpasswd program\fR and what to expect back. If the expected output is not received then the password is not changed. @@ -4115,7 +4459,7 @@ in them into a single string. If the send string in any part of the chat sequence is a fullstop ".", then no string is sent. Similarly, -is the expect string is a fullstop then no string is expected. +if the expect string is a fullstop then no string is expected. Note that if the \fIunix password sync\fR parameter is set to true, then this @@ -4127,8 +4471,8 @@ to "" (the empty string). See also \fIunix password sync\fR, \fI passwd program\fR and \fIpasswd chat debug\fR. -Default: \fBpasswd chat = *old*password* %o\\n *new* -password* %n\\n *new*password* %n\\n *changed*\fR +Default: \fBpasswd chat = *new*password* %n\\n +*new*password* %n\\n *changed*\fR Example: \fBpasswd chat = "*Enter OLD password*" %o\\n "*Enter NEW password*" %n\\n "*Reenter NEW password*" %n\\n "*Password @@ -4138,7 +4482,7 @@ changed*"\fR This boolean specifies if the passwd chat script parameter is run in \fBdebug\fR mode. In this mode the strings passed to and received from the passwd chat are printed -in the smbd(8) log with a +in the smbd(8)log with a \fIdebug level\fR of 100. This is a dangerous option as it will allow plaintext passwords to be seen in the \fBsmbd\fR log. It is available to help @@ -4152,8 +4496,6 @@ See also <\fIpasswd chat\fR \&. Default: \fBpasswd chat debug = no\fR - -Example: \fBpasswd chat debug = yes\fR .TP \fBpasswd program (G)\fR The name of a program that can be used to set @@ -4171,7 +4513,7 @@ it. password sync\fR parameter is set to True then this program is called \fBAS ROOT\fR before the SMB password in the smbpasswd(5) - file is changed. If this UNIX password change fails, then +file is changed. If this UNIX password change fails, then \fBsmbd\fR will fail to change the SMB password also (this is by design). @@ -4193,7 +4535,10 @@ Some client/server combinations have difficulty with mixed-case passwords. One offending client is Windows for Workgroups, which for some reason forces passwords to upper case when using the LANMAN1 protocol, but leaves them alone when -using COREPLUS! +using COREPLUS! Another problem child is the Windows 95/98 +family of operating systems. These clients upper case clear +text passwords even when NT LM 0.12 selected by the protocol +negotiation request/response. This parameter defines the maximum number of characters that may be upper case in passwords. @@ -4229,9 +4574,9 @@ as a WinNT box) with this option, and using \fBsecurity = domain \fRor \fBsecurity = server\fR you can get Samba to do all its username/password validation via a remote server. -This options sets the name of the password server to use. +This option sets the name of the password server to use. It must be a NetBIOS name, so if the machine's NetBIOS name is -different from its internet name then you may have to add its NetBIOS +different from its Internet name then you may have to add its NetBIOS name to the lmhosts file which is stored in the same directory as the \fIsmb.conf\fR file. @@ -4241,7 +4586,7 @@ resolve order\fR and so may resolved by any method and order described in that parameter. The password server much be a machine capable of using -the "LM1.2X002" or the "LM NT 0.12" protocol, and it must be in +the "LM1.2X002" or the "NT LM 0.12" protocol, and it must be in user level security mode. \fBNOTE:\fR Using a password server @@ -4256,14 +4601,14 @@ server! The name of the password server takes the standard substitutions, but probably the only useful one is \fI%m \fR, which means the Samba server will use the incoming -client as the passwordserver. If you use this then you better -trust your clients, and you better restrict them with hosts allow! +client as the password server. If you use this then you better +trust your clients, and you had better restrict them with hosts allow! If the \fIsecurity\fR parameter is set to domain, then the list of machines in this option must be a list of Primary or Backup Domain controllers for the -Domain or the character '*', as the Samba server is cryptographicly -in that domain, and will use cryptographicly authenticated RPC calls +Domain or the character '*', as the Samba server is effectively +in that domain, and will use cryptographically authenticated RPC calls to authenticate the user logging on. The advantage of using \fB security = domain\fR is that if you list several hosts in the \fIpassword server\fR option then \fBsmbd \fRwill try each in turn till it finds one that responds. This @@ -4336,6 +4681,16 @@ Default: \fBnone\fR Example: \fBpath = /home/fred\fR .TP +\fBposix locking (S)\fR +The \fBsmbd(8)\fRdaemon maintains an database of file locks obtained by SMB clients. +The default behavior is to map this internal database to POSIX +locks. This means that file locks obtained by SMB clients are +consistent with those seen by POSIX compliant applications accessing +the files via a non-SMB method (e.g. NFS or local file access). +You should never need to disable this parameter. + +Default: \fBposix locking = yes\fR +.TP \fBpostexec (S)\fR This option specifies a command to be run whenever the service is disconnected. It takes the usual @@ -4396,7 +4751,7 @@ return code from \fIpreexec Default: \fBpreexec close = no\fR .TP \fBpreferred master (G)\fR -This boolean parameter controls if nmbd(8) is a preferred master browser +This boolean parameter controls if nmbd(8)is a preferred master browser for its workgroup. If this is set to true, on startup, \fBnmbd\fR @@ -4414,24 +4769,34 @@ capabilities. See also \fIos level\fR \&. -Default: \fBpreferred master = no\fR +Default: \fBpreferred master = auto\fR .TP \fBprefered master (G)\fR Synonym for \fI preferred master\fR for people who cannot spell :-). .TP \fBpreload\fR -Synonym for \fI auto services\fR. +This is a list of services that you want to be +automatically added to the browse lists. This is most useful +for homes and printers services that would otherwise not be +visible. + +Note that if you just want all printers in your +printcap file loaded then the \fIload printers\fR option is easier. + +Default: \fBno preloaded services\fR + +Example: \fBpreload = fred lp colorlp\fR .TP \fBpreserve case (S)\fR This controls if new filenames are created with the case that the client passes, or if they are forced to -be the \fIderault case +be the \fIdefault case \fR\&. Default: \fBpreserve case = yes\fR See the section on NAME -MANGLING" for a fuller discussion. +MANGLING for a fuller discussion. .TP \fBprint command (S)\fR After a print job has finished spooling to @@ -4465,7 +4830,7 @@ If there is neither a specified print command for a printable service nor a global print command, spool files will be created but not processed and (most importantly) not removed. -Note that printing may fail on some UNIXs from the +Note that printing may fail on some UNIXes from the nobody account. If this happens then create an alternative guest account that can print and set the \fIguest account\fR in the [global] section. @@ -4517,16 +4882,6 @@ Default: \fBprintable = no\fR \fBprintcap (G)\fR Synonym for \fI printcap name\fR. .TP -\fBprinter admin (S)\fR -This is a list of users that can do anything to -printers via the remote administration interfaces offered by MSRPC -(usually using a NT workstation). Note that the root user always -has admin rights. - -Default: \fBprinter admin = \fR - -Example: \fBprinter admin = admin, @staff\fR -.TP \fBprintcap name (G)\fR This parameter may be used to override the compiled-in default printcap name used by the server (usually \fI /etc/printcap\fR). See the discussion of the [printers] section above for reasons @@ -4566,23 +4921,27 @@ Default: \fBprintcap name = /etc/printcap\fR Example: \fBprintcap name = /etc/myprintcap\fR .TP -\fBprinter (S)\fR -This parameter specifies the name of the printer -to which print jobs spooled through a printable service will be sent. - -If specified in the [global] section, the printer -name given will be used for any printable service that does -not have its own printer name specified. +\fBprinter admin (S)\fR +This is a list of users that can do anything to +printers via the remote administration interfaces offered by MS-RPC +(usually using a NT workstation). Note that the root user always +has admin rights. -Default: \fBnone (but may be lp -on many systems)\fR +Default: \fBprinter admin = \fR -Example: \fBprinter name = laserwriter\fR +Example: \fBprinter admin = admin, @staff\fR .TP \fBprinter driver (S)\fR +\fBNote :\fRThis is a depreciated +parameter and will be removed in the next major release +following version 2.2. Please see the instructions in +\fIPRINTER_DRIVER2.txt\fR in the \fIdocs +\fRof the Samba distribution for more information +on the new method of loading printer drivers onto a Samba server. + This option allows you to control the string that clients receive when they ask the server for the printer driver -associated with a printer. If you are using Windows95 or WindowsNT +associated with a printer. If you are using Windows95 or Windows NT then you can use this to automate the setup of printers on your system. @@ -4591,7 +4950,7 @@ sensitive) that describes the appropriate printer driver for your system. If you don't know the exact string to use then you should first try with no \fI printer driver\fR option set and the client will give you a list of printer drivers. The appropriate strings are -shown in a scrollbox after you have chosen the printer manufacturer. +shown in a scroll box after you have chosen the printer manufacturer. See also \fIprinter driver file\fR. @@ -4599,6 +4958,13 @@ driver file\fR. Example: \fBprinter driver = HP LaserJet 4L\fR .TP \fBprinter driver file (G)\fR +\fBNote :\fRThis is a depreciated +parameter and will be removed in the next major release +following version 2.2. Please see the instructions in +\fIPRINTER_DRIVER2.txt\fR in the \fIdocs +\fRof the Samba distribution for more information +on the new method of loading printer drivers onto a Samba server. + This parameter tells Samba where the printer driver definition file, used when serving drivers to Windows 95 clients, is to be found. If this is not set, the default is : @@ -4620,6 +4986,13 @@ Example: \fBprinter driver file = /usr/local/samba/printers/drivers.def\fR .TP \fBprinter driver location (S)\fR +\fBNote :\fRThis is a depreciated +parameter and will be removed in the next major release +following version 2.2. Please see the instructions in +\fIPRINTER_DRIVER2.txt\fR in the \fIdocs +\fRof the Samba distribution for more information +on the new method of loading printer drivers onto a Samba server. + This parameter tells clients of a particular printer share where to find the printer driver files for the automatic installation of drivers for Windows 95 machines. If Samba is set up @@ -4639,7 +5012,20 @@ Default: \fBnone\fR Example: \fBprinter driver location = \\\\MACHINE\\PRINTER$ \fR.TP \fBprinter name (S)\fR -Synonym for \fI printer\fR. +This parameter specifies the name of the printer +to which print jobs spooled through a printable service will be sent. + +If specified in the [global] section, the printer +name given will be used for any printable service that does +not have its own printer name specified. + +Default: \fBnone (but may be lp +on many systems)\fR + +Example: \fBprinter name = laserwriter\fR +.TP +\fBprinter (S)\fR +Synonym for \fI printer name\fR. .TP \fBprinting (S)\fR This parameters controls how printer status @@ -4658,63 +5044,14 @@ QNX, SOFTQ, and CUPS. To see what the defaults are for the other print -commands when using the various options use the testparm(1) program. +commands when using the various options use the testparm(1)program. This option can be set on a per printer basis See also the discussion in the [printers] section. .TP -\fBprivate dir(G)\fR -The \fIprivate dir\fR parameter -allows an administator to define a directory path used to hold the -various databases Samba will use to store things like a the machine -trust account information when acting as a domain member (i.e. where -the secrets.tdb file will be located), where the passdb.tbd file -will stored in the case of using the experiemental tdbsam support, -etc... - -Default: \fBprivate dir = \fR - -Example: \fBprivate dir = /etc/smbprivate\fR -.TP \fBprotocol (G)\fR -The value of the parameter (a string) is the highest -protocol level that will be supported by the server. - -Possible values are : -.RS -.TP 0.2i -\(bu -CORE: Earliest version. No -concept of user names. -.TP 0.2i -\(bu -COREPLUS: Slight improvements on -CORE for efficiency. -.TP 0.2i -\(bu -LANMAN1: First \fB modern\fR version of the protocol. Long filename -support. -.TP 0.2i -\(bu -LANMAN2: Updates to Lanman1 protocol. -.TP 0.2i -\(bu -NT1: Current up to date version of -the protocol. Used by Windows NT. Known as CIFS. -.RE -.PP -Normally this option should not be set as the automatic -negotiation phase in the SMB protocol takes care of choosing -the appropriate protocol. -.PP -.PP -Default: \fBprotocol = NT1\fR -.PP -.PP -Example: \fBprotocol = LANMAN1\fR -.PP +Synonym for \fImax protocol\fR. .TP \fBpublic (S)\fR Synonym for \fIguest @@ -4770,7 +5107,7 @@ Default: \fBdepends on the setting of \fIprinting\fB\fR Example: \fBqueuepause command = enable %p \fR.TP \fBread bmpx (G)\fR -This boolean parameter controls whether smbd(8) will support the "Read +This boolean parameter controls whether smbd(8)will support the "Read Block Multiplex" SMB. This is now rarely used and defaults to no. You should never need to set this parameter. @@ -4836,7 +5173,7 @@ Default: \fBread size = 16384\fR Example: \fBread size = 8192\fR .TP \fBremote announce (G)\fR -This option allows you to setup nmbd(8) to periodically announce itself +This option allows you to setup nmbd(8)to periodically announce itself to arbitrary IP addresses with an arbitrary workgroup name. This is useful if you want your Samba server to appear @@ -4865,7 +5202,7 @@ in the \fIdocs/\fR directory. Default: \fBremote announce = \fR.TP \fBremote browse sync (G)\fR -This option allows you to setup nmbd(8) to periodically request +This option allows you to setup nmbd(8)to periodically request synchronization of browse lists with the master browser of a samba server that is on a remote segment. This option will allow you to gain browse lists for multiple workgroups across routed networks. This @@ -4900,10 +5237,10 @@ case where the server is expecting the client to send a username, but it doesn't. Setting it to true will force these anonymous connections to be denied, and the client will be required to always supply a username and password when connecting. Use of this parameter -is only recommened for homogenous NT client environments. +is only recommended for homogeneous NT client environments. This parameter makes the use of macro expansions that rely -on the username (%U, %G, etc) consistant. NT 4.0 +on the username (%U, %G, etc) consistent. NT 4.0 likes to use anonymous connections when refreshing the share list, and this is a way to work around that. @@ -4959,20 +5296,26 @@ is useful for unmounting filesystems (such as cdroms) after a connection is closed. See also \fI postexec\fR. -.TP + +Default: \fBroot postexec = +\fR.TP \fBroot preexec (S)\fR This is the same as the \fIpreexec\fR parameter except that the command is run as root. This -is useful for mounting filesystems -(such as cdroms) after a connection is closed. +is useful for mounting filesystems (such as cdroms) after a +connection is closed. See also \fI preexec\fR and \fIpreexec close\fR. -.TP + +Default: \fBroot preexec = +\fR.TP \fBroot preexec close (S)\fR This is the same as the \fIpreexec close \fRparameter except that the command is run as root. See also \fI preexec\fR and \fIpreexec close\fR. + +Default: \fBroot preexec close = no\fR .TP \fBsecurity (G)\fR This option affects how clients respond to @@ -4980,7 +5323,7 @@ Samba and is one of the most important settings in the \fI smb.conf\fR file. The option sets the "security mode bit" in replies to protocol negotiations with smbd(8) - to turn share level security on or off. Clients decide +to turn share level security on or off. Clients decide based on this bit whether (and how) to transfer user and password information to the server. @@ -5156,7 +5499,7 @@ parameter. \fBSECURITY = DOMAIN \fR.PP .PP -This mode will only work correctly if smbpasswd(8) has been used to add this +This mode will only work correctly if smbpasswd(8)has been used to add this machine into a Windows NT Domain. It expects the \fIencrypted passwords\fR parameter to be set to true. In this mode Samba will try to validate the username/password by passing @@ -5293,26 +5636,6 @@ off as many Windows applications will break if you do so. Default: \fBshare modes = yes\fR .TP -\fBshared mem size (G)\fR -It specifies the size of the shared memory (in -bytes) to use between smbd(8) -processes. This parameter defaults to one megabyte of shared -memory. It is possible that if you have a large erver with many -files open simultaneously that you may need to increase this -parameter. Signs that this parameter is set too low are users -reporting strange problems trying to save files (locking errors) -and error messages in the smbd log looking like \fBERROR -smb_shm_alloc : alloc of XX bytes failed\fR. - -If your OS refuses the size that Samba asks for then -Samba will try a smaller size, reducing by a factor of 0.8 until -the OS accepts it. - -Default: \fBshared mem size = 1048576\fR - -Example: \fBshared mem size = 5242880 ; Set to 5mb for a -large number of files.\fR -.TP \fBshort preserve case (S)\fR This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of @@ -5326,29 +5649,41 @@ See the section on NAME MANGLING. Default: \fBshort preserve case = yes\fR .TP +\fBshow add printer wizard (G)\fR +With the introduction of MS-RPC based printing support +for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will +appear on Samba hosts in the share listing. Normally this folder will +contain an icon for the MS Add Printer Wizard (APW). However, it is +possible to disable this feature regardless of the level of privilege +of the connected user. + +Under normal circumstances, the Windows NT/2000 client will +open a handle on the printer server with OpenPrinterEx() asking for +Administrator privileges. If the user does not have administrative +access on the print server (i.e is not root or a member of the +\fIprinter admin\fR group), the OpenPrinterEx() +call fails and the clients another open call with a request for +a lower privilege level. This should succeed, however the APW +icon will not be displayed. + +Disabling the \fIshow add printer wizard\fR +parameter will always cause the OpenPrinterEx() on the server +to fail. Thus the APW icon will never be displayed. \fB Note :\fRThis does not prevent the same user from having +administrative privilege on an individual printer. + +See also \fIaddprinter +command\fR, \fIdeleteprinter command\fR, \fIprinter admin\fR + +Default :\fBshow add printer wizard = yes\fR +.TP \fBsmb passwd file (G)\fR This option sets the path to the encrypted smbpasswd file. By default the path to the smbpasswd file is compiled into Samba. -Default: \fBsmb passwd file= \fR - -Example: \fBsmb passwd file = /usr/samba/private/smbpasswd -\fR.TP -\fBsmbrun (G)\fR -This sets the full path to the \fBsmbrun -\fRbinary. This defaults to the value in the \fI Makefile\fR. - -You must get this path right for many services -to work correctly. - -You should not need to change this parameter so -long as Samba is installed correctly. - -Default: \fBsmbrun= +Default: \fBsmb passwd file = ${prefix}/private/smbpasswd \fR -Example: \fBsmbrun = /usr/local/samba/bin/smbrun +Example: \fBsmb passwd file = /etc/samba/smbpasswd \fR.TP \fBsocket address (G)\fR This option allows you to control what @@ -5565,7 +5900,7 @@ given at configure time. this code is \fBNOT\fR enabled by default in any current binary version of Samba. -The certificate in this file is used by \fBsmbclient(1)\fR if it exists. It's needed +The certificate in this file is used by \fBsmbclient(1)\fRif it exists. It's needed if the server requires a client certificate. Default: \fBssl client cert = /usr/local/ssl/certs/smbclient.pem @@ -5580,7 +5915,7 @@ given at configure time. this code is \fBNOT\fR enabled by default in any current binary version of Samba. -This is the private key for \fBsmbclient(1)\fR . It's only needed if the +This is the private key for \fBsmbclient(1)\fR. It's only needed if the client should have a certificate. Default: \fBssl client key = /usr/local/ssl/private/smbclient.pem @@ -5672,7 +6007,7 @@ current binary version of Samba. If this variable is set to yes, the \fBsmbclient(1)\fR - will request a certificate from the server. Same as +will request a certificate from the server. Same as \fIssl require clientcert\fR for the server. @@ -5734,7 +6069,7 @@ Security) is the new standard for SSL. Default: \fBssl version = "ssl2or3"\fR .TP \fBstat cache (G)\fR -This parameter determines if smbd(8) will use a cache in order to +This parameter determines if smbd(8)will use a cache in order to speed up case insensitive name mappings. You should never need to change this parameter. @@ -5749,8 +6084,7 @@ Default: \fBstat cache size = 50\fR .TP \fBstatus (G)\fR This enables or disables logging of connections -to a status file that smbstatus(1) -can read. +to a status file that smbstatus(1)can read. With this disabled \fBsmbstatus\fR won't be able to tell you what connections are active. You should never need to @@ -5825,7 +6159,7 @@ level one maps onto LOG_WARNING, debug level two maps onto LOG_NOTICE, debug level three maps onto LOG_INFO. All higher levels are mapped to LOG_DEBUG. -This paramter sets the threshold for sending messages +This parameter sets the threshold for sending messages to syslog. Only messages with debug level less than this value will be sent to syslog. @@ -5843,7 +6177,7 @@ Default: \fBsyslog only = no\fR only available in Samba 3.0. When filling out the user information for a Windows NT -user, the winbindd(8) daemon +user, the winbindd(8)daemon uses this parameter to fill in the home directory for that user. If the string \fI%D\fR is present it is substituted with the user's Windows NT domain name. If the string \fI%U @@ -5857,7 +6191,7 @@ Default: \fBtemplate homedir = /home/%D/%U\fR only available in Samba 3.0. When filling out the user information for a Windows NT -user, the winbindd(8) daemon +user, the winbindd(8)daemon uses this parameter to fill in the login shell for that user. Default: \fBtemplate shell = /bin/false\fR @@ -5874,7 +6208,7 @@ Example: \fBtime offset = 60\fR .TP \fBtime server (G)\fR This parameter determines if -nmbd(8) advertises itself as a time server to Windows +nmbd(8)advertises itself as a time server to Windows clients. Default: \fBtime server = no\fR @@ -5882,6 +6216,21 @@ Default: \fBtime server = no\fR \fBtimestamp logs (G)\fR Synonym for \fI debug timestamp\fR. .TP +\fBtotal print jobs (G)\fR +This parameter accepts an integer value which defines +a limit on the maximum number of print jobs that will be accepted +system wide at any given time. If a print job is submitted +by a client which will exceed this number, then smbd will return an +error indicating that no space is available on the server. The +default value of 0 means that no such limit exists. This parameter +can be used to prevent a server from exceeding its capacity and is +designed as a printing throttle. See also +\fImax print jobs\fR. + +Default: \fBtotal print jobs = 0\fR + +Example: \fBtotal print jobs = 5000\fR +.TP \fBunix password sync (G)\fR This boolean parameter controls whether Samba attempts to synchronize the UNIX password with the SMB password @@ -5897,14 +6246,6 @@ program\fR, \fI passwd chat\fR. Default: \fBunix password sync = no\fR .TP -\fBunix realname (G)\fR -This boolean parameter when set causes samba -to supply the real name field from the unix password file to -the client. This isuseful for setting up mail clients and WWW -browsers on systems used by more than one person. - -Default: \fBunix realname = no\fR -.TP \fBupdate encrypted (G)\fR This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed) @@ -5998,7 +6339,7 @@ is compiled with netgroup support) and will expand to a list of all users in the netgroup group of that name. Note that searching though a groups database can take -quite some time, snd some clients may time out during the +quite some time, and some clients may time out during the search. See the section NOTE ABOUT @@ -6006,7 +6347,7 @@ USERNAME/PASSWORD VALIDATION for more information on how this parameter determines access to the services. Default: \fBThe guest account if a guest service, -else the name of the service.\fR +else .\fR Examples:\fBusername = fred, mary, jack, jane, @users, @pcgroup\fR @@ -6020,7 +6361,7 @@ username is not found on the UNIX machine. If this parameter is set to non-zero the behavior changes. This parameter is a number that specifies the number of uppercase -combinations to try whilst trying to determine the UNIX user name. The +combinations to try while trying to determine the UNIX user name. The higher the number the more combinations will be tried, but the slower the discovery of usernames will be. Use this parameter when you have strange usernames on your UNIX machine, such as AstrangeUser @@ -6139,43 +6480,6 @@ native system is set to use (usually Default: \fBno utmp directory\fR .TP -\fBwinbind cache time\fR -\fBNOTE:\fR this parameter is only -available in Samba 3.0. - -This parameter specifies the number of seconds the -winbindd(8) daemon will cache -user and group information before querying a Windows NT server -again. - -Default: \fBwinbind cache type = 15\fR -.TP -\fBwinbind gid\fR -\fBNOTE:\fR this parameter is only -available in Samba 3.0. - -The winbind gid parameter specifies the range of group -ids that are allocated by the winbindd(8) daemon. This range of group ids should have no -existing local or nis groups within it as strange conflicts can -occur otherwise. - -Default: \fBwinbind gid = -\fR -Example: \fBwinbind gid = 10000-20000\fR -.TP -\fBwinbind uid\fR -\fBNOTE:\fR this parameter is only -available in Samba 3.0. - -The winbind gid parameter specifies the range of group -ids that are allocated by the winbindd(8) daemon. This range of ids should have no -existing local or nis users within it as strange conflicts can -occur otherwise. - -Default: \fBwinbind uid = -\fR -Example: \fBwinbind uid = 10000-20000\fR -.TP \fBvalid chars (G)\fR The option allows you to specify additional characters that should be considered valid by the server in @@ -6319,6 +6623,23 @@ the particular NetBench share : Example: \fBveto oplock files = /*;.SEM/ \fR.TP +\fBvfs object (S)\fR +This parameter specifies a shared object file that +is used for Samba VFS I/O operations. By default, normal +disk I/O operations are used but these can be overloaded +with a VFS object. The Samba VFS layer is new to Samba 2.2 and +must be enabled at compile time with --with-vfs. + +Default : \fBno value\fR +.TP +\fBvfs options (S)\fR +This parameter allows parameters to be passed +to the vfs layer at initialisation time. The Samba VFS layer +is new to Samba 2.2 and must be enabled at compile time +with --with-vfs. See also \fI vfs object\fR. + +Default : \fBno value\fR +.TP \fBvolume (S)\fR This allows you to override the volume label returned for a share. Useful for CDROMs with installation programs @@ -6339,31 +6660,56 @@ that Samba has to do in order to perform the link checks. Default: \fBwide links = yes\fR .TP -\fBwins proxy (G)\fR -This is a boolean that controls if nmbd(8) will respond to broadcast name -queries on behalf of other hosts. You may need to set this -to yes for some older clients. +\fBwinbind cache time\fR +\fBNOTE:\fR this parameter is only +available in Samba 3.0. -Default: \fBwins proxy = no\fR +This parameter specifies the number of seconds the +winbindd(8)daemon will cache +user and group information before querying a Windows NT server +again. + +Default: \fBwinbind cache type = 15\fR .TP -\fBwins server (G)\fR -This specifies the IP address (or DNS name: IP -address for preference) of the WINS server that nmbd(8) should register with. If you have a WINS server on -your network then you should set this to the WINS server's IP. +\fBwinbind gid\fR +\fBNOTE:\fR this parameter is only +available in Samba 3.0. -You should point this at your WINS server if you have a -multi-subnetted network. +The winbind gid parameter specifies the range of group +ids that are allocated by the winbindd(8)daemon. This range of group ids should have no +existing local or nis groups within it as strange conflicts can +occur otherwise. -\fBNOTE\fR. You need to set up Samba to point -to a WINS server if you have multiple subnets and wish cross-subnet -browsing to work correctly. +Default: \fBwinbind gid = +\fR +Example: \fBwinbind gid = 10000-20000\fR +.TP +\fBwinbind separator\fR +\fBNOTE:\fR this parameter is only +available in Samba 3.0. -See the documentation file \fIBROWSING.txt\fR -in the docs/ directory of your Samba source distribution. +This parameter allows an admin to define the character +used when listing a username of the form of \fIDOMAIN +\fR\\\fIuser\fR. This parameter +is only applicable when using the \fIpam_winbind.so\fR +and \fInss_winbind.so\fR modules for UNIX services. -Default: \fBnot enabled\fR +Example: \fBwinbind separator = \\\fR -Example: \fBwins server = 192.9.200.1\fR +Example: \fBwinbind separator = +\fR +.TP +\fBwinbind uid\fR +\fBNOTE:\fR this parameter is only +available in Samba 3.0. + +The winbind gid parameter specifies the range of group +ids that are allocated by the winbindd(8)daemon. This range of ids should have no +existing local or nis users within it as strange conflicts can +occur otherwise. + +Default: \fBwinbind uid = +\fR +Example: \fBwinbind uid = 10000-20000\fR .TP \fBwins hook (G)\fR When Samba is running as a WINS server this @@ -6411,9 +6757,35 @@ program \fBnsupdate\fR is provided in the examples directory of the Samba source code. .PP .TP +\fBwins proxy (G)\fR +This is a boolean that controls if nmbd(8)will respond to broadcast name +queries on behalf of other hosts. You may need to set this +to yes for some older clients. + +Default: \fBwins proxy = no\fR +.TP +\fBwins server (G)\fR +This specifies the IP address (or DNS name: IP +address for preference) of the WINS server that nmbd(8)should register with. If you have a WINS server on +your network then you should set this to the WINS server's IP. + +You should point this at your WINS server if you have a +multi-subnetted network. + +\fBNOTE\fR. You need to set up Samba to point +to a WINS server if you have multiple subnets and wish cross-subnet +browsing to work correctly. + +See the documentation file \fIBROWSING.txt\fR +in the docs/ directory of your Samba source distribution. + +Default: \fBnot enabled\fR + +Example: \fBwins server = 192.9.200.1\fR +.TP \fBwins support (G)\fR This boolean controls if the -nmbd(8) process in Samba will act as a WINS server. You should +nmbd(8)process in Samba will act as a WINS server. You should not set this to true unless you have a multi-subnetted network and you wish a particular \fBnmbd\fR to be your WINS server. Note that you should \fBNEVER\fR set this to true @@ -6434,27 +6806,10 @@ Example: \fBworkgroup = MYGROUP\fR \fBwritable (S)\fR Synonym for \fI writeable\fR for people who can't spell :-). .TP -\fBwrite list (S)\fR -This is a list of users that are given read-write -access to a service. If the connecting user is in this list then -they will be given write access, no matter what the \fIwriteable\fR -option is set to. The list can include group names using the -@group syntax. - -Note that if a user is in both the read list and the -write list then they will be given write access. - -See also the \fIread list -\fRoption. - -Default: \fBwrite list = -\fR -Example: \fBwrite list = admin, root, @staff -\fR.TP \fBwrite cache size (S)\fR -This integer parameter (new with Samba 2.0.7) -if set to non-zero causes Samba to create an in-memory cache for -each oplocked file (it does \fBnot\fR do this for +If this integer parameter is set to non-zero value, +Samba will create an in-memory cache for each oplocked file +(it does \fBnot\fR do this for non-oplocked files). All writes that the client does not request to be flushed directly to disk will be stored in this cache if possible. The cache is flushed onto disk when a write comes in whose offset @@ -6477,6 +6832,23 @@ Example: \fBwrite cache size = 262144\fR for a 256k cache size per file. .TP +\fBwrite list (S)\fR +This is a list of users that are given read-write +access to a service. If the connecting user is in this list then +they will be given write access, no matter what the \fIwriteable\fR +option is set to. The list can include group names using the +@group syntax. + +Note that if a user is in both the read list and the +write list then they will be given write access. + +See also the \fIread list +\fRoption. + +Default: \fBwrite list = +\fR +Example: \fBwrite list = admin, root, @staff +\fR.TP \fBwrite ok (S)\fR Synonym for \fI writeable\fR. .TP @@ -6508,7 +6880,7 @@ problem - but be aware of the possibility. .PP On a similar note, many clients - especially DOS clients - limit service names to eight characters. smbd(8) - has no such limitation, but attempts to connect from such +has no such limitation, but attempts to connect from such clients will fail if they truncate the service names. For this reason you should probably keep your service names down to eight characters in length. @@ -6524,16 +6896,15 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -samba(7) , -\fBsmbpasswd(8)\fR , -\fBswat(8)\fR , -\fBsmbd(8)\fR , -\fBnmbd(8)\fR , -\fBsmbclient(1)\fR , -\fBnmblookup(1)\fR , -\fBtestparm(1)\fR , -\fBtestprns(1)\fR -.SH "AUTHOR" +samba(7), +\fBsmbpasswd(8)\fR, +\fBswat(8)\fR, +\fBsmbd(8)\fR, +\fBnmbd(8)\fR, +\fBsmbclient(1)\fR, +\fBnmblookup(1)\fR, +\fBtestparm(1)\fR, +\fBtestprns(1)\fR.SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/smbcacls.1 b/docs/manpages/smbcacls.1 index 5b96090e8c4..cd17883af85 100644 --- a/docs/manpages/smbcacls.1 +++ b/docs/manpages/smbcacls.1 @@ -3,15 +3,15 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBCACLS" "1" "23 February 2001" "" "" +.TH "SMBCACLS" "1" "19 April 2001" "" "" .SH NAME smbcacls \- Set or get ACLs on an NT file or directory names .SH SYNOPSIS .sp -\fBnmblookup\fR \fB//server/share\fR \fBfilename\fR [ \fB-U username\fR ] [ \fB-A acls\fR ] [ \fB-M acls\fR ] [ \fB-D acls\fR ] [ \fB-S acls\fR ] [ \fB-C name\fR ] [ \fB-G name\fR ] [ \fB-n\fR ] [ \fB-h\fR ] +\fBsmbcacls\fR \fB//server/share\fR \fBfilename\fR [ \fB-U username\fR ] [ \fB-A acls\fR ] [ \fB-M acls\fR ] [ \fB-D acls\fR ] [ \fB-S acls\fR ] [ \fB-C name\fR ] [ \fB-G name\fR ] [ \fB-n\fR ] [ \fB-h\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP The smbcacls program manipulates NT Access Control Lists (ACLs) on SMB file shares. diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1 index eb81374e6d7..9977db79925 100644 --- a/docs/manpages/smbclient.1 +++ b/docs/manpages/smbclient.1 @@ -3,15 +3,15 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBCLIENT" "1" "23 February 2001" "" "" +.TH SMBCLIENT 1 "24 Mar 2001" "smbclient 2.2.0-alpha3" .SH NAME smbclient \- ftp-like client to access SMB/CIFS resources on servers .SH SYNOPSIS .sp -\fBsmbclient\fR \fBservicename\fR [ \fB-b \fR ] [ \fB-d debuglevel\fR ] [ \fB-D Directory\fR ] [ \fB-S server\fR ] [ \fB-U username\fR ] [ \fB-W workgroup\fR ] [ \fB-M \fR ] [ \fB-m maxprotocol\fR ] [ \fB-A authfile\fR ] [ \fB-N\fR ] [ \fB-l logfile\fR ] [ \fB-L \fR ] [ \fB-I destinationIP\fR ] [ \fB-E \fR ] [ \fB-c \fR ] [ \fB-i scope\fR ] [ \fB-O \fR ] [ \fB-p port\fR ] [ \fB-R \fR ] [ \fB-s \fR ] [ \fB-TIXFqgbNan\fR ] [ \fBpassword\fR ] +\fBsmbclient\fR \fBservicename\fR [ \fBpassword\fR ] [ \fB-b \fR ] [ \fB-d debuglevel\fR ] [ \fB-D Directory\fR ] [ \fB-S server\fR ] [ \fB-U username\fR ] [ \fB-W workgroup\fR ] [ \fB-M \fR ] [ \fB-m maxprotocol\fR ] [ \fB-A authfile\fR ] [ \fB-N\fR ] [ \fB-l logfile\fR ] [ \fB-L \fR ] [ \fB-I destinationIP\fR ] [ \fB-E \fR ] [ \fB-c \fR ] [ \fB-i scope\fR ] [ \fB-O \fR ] [ \fB-p port\fR ] [ \fB-R \fR ] [ \fB-s \fR ] [ \fB-TIXFqgbNan\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBsmbclient\fR is a client that can \&'talk' to an SMB/CIFS server. It offers an interface @@ -72,7 +72,7 @@ TCP socket options to set on the client socket. See the socket options parameter in the \fI smb.conf (5)\fR manpage for the list of valid options. .TP -\fBname resolve order (G)\fR +\fB-R \fR This option is used by the programs in the Samba suite to determine what naming services and in what order to resolve host names to IP addresses. The option takes a space separated @@ -85,7 +85,7 @@ cause names to be resolved as follows : \(bu lmhosts : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has -no name type attached to the NetBIOS name (see the lmhosts(5) for details) then +no name type attached to the NetBIOS name (see the lmhosts(5)for details) then any name type matches for lookup. .TP 0.2i \(bu diff --git a/docs/manpages/smbcontrol.1 b/docs/manpages/smbcontrol.1 index 71b96ae25dc..7522c04e8cd 100644 --- a/docs/manpages/smbcontrol.1 +++ b/docs/manpages/smbcontrol.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBCONTROL" "1" "23 February 2001" "" "" +.TH SMBCONTROL 1 "24 Mar 2001" "smbcontrol 2.2.0-alpha3" .SH NAME smbcontrol \- send messages to smbd or nmbd processes .SH SYNOPSIS @@ -13,11 +13,11 @@ smbcontrol \- send messages to smbd or nmbd processes \fBsmbcontrol\fR [ \fBdestination\fR ] [ \fBmessage-type\fR ] [ \fBparameter\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBsmbcontrol\fR is a very small program, which -sends messages to an smbd(8) or -an nmbd(8) daemon running on the +sends messages to an smbd(8)or +an nmbd(8)daemon running on the system. .SH "OPTIONS" .TP @@ -93,8 +93,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBnmbd(8)\fR , -and \fBsmbd(8)\fR . +\fBnmbd(8)\fR, +and \fBsmbd(8)\fR. .SH "AUTHOR" .PP The original Samba software and related utilities diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8 index 3b180b4d1fa..e0a3c7a2b34 100644 --- a/docs/manpages/smbd.8 +++ b/docs/manpages/smbd.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBD" "8" "23 February 2001" "" "" +.TH SMBD 8 "24 Mar 2001" "smbd 2.2.0-alpha3" .SH NAME smbd \- server to provide SMB/CIFS services to clients .SH SYNOPSIS @@ -26,13 +26,12 @@ 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 \fIsmb.conf(5) -\fR . This man page will not describe the +\fR. This man page will not describe the services, but will concentrate on the administrative aspects of running the server. .PP Please note that there are significant security -implications to running this server, and the \fIsmb.conf(5)\fR -manpage should be regarded as mandatory reading before +implications to running this server, and the \fIsmb.conf(5)\fRmanpage should be regarded as mandatory reading before proceeding with installation. .PP A session is created whenever a client requests one. @@ -103,21 +102,19 @@ data, most of which is extremely cryptic. Note that specifying this parameter here will override the log -level parameter in the \fIsmb.conf(5)\fR file. +levelfile. .TP \fB-l \fR If specified, \fBlog file\fR specifies a log filename into which informational and debug messages from the running server will be logged. The log file generated is never removed by the server although -its size may be controlled by the max log size -option in the \fI smb.conf(5)\fR file. The default log +its size may be controlled by the max log sizeoption in the \fI smb.conf(5)\fRfile. The default log file name is specified at compile time. .TP \fB-O \fR -See the socket options -parameter in the \fIsmb.conf(5) -\fR file for details. +See the socket optionsparameter in the \fIsmb.conf(5) +\fRfile for details. .TP \fB-p \fR port number is a positive integer @@ -148,7 +145,7 @@ configuration details required by the server. The information in this file includes server-specific information such as what printcap file to use, as well as descriptions of all the services that the server is -to provide. See \fI smb.conf(5)\fR for more information. +to provide. See \fI smb.conf(5)\fRfor more information. The default configuration file name is determined at compile time. .SH "FILES" @@ -177,13 +174,12 @@ See the section INSTALLATION below. .TP \fB\fI/usr/local/samba/lib/smb.conf\fB\fR This is the default location of the -\fIsmb.conf\fR -server configuration file. Other common places that systems +\fIsmb.conf\fRserver configuration file. Other common places that systems install this file are \fI/usr/samba/lib/smb.conf\fR and \fI/etc/smb.conf\fR. This file describes all the services the server -is to make available to clients. See \fIsmb.conf(5)\fR for more information. +is to make available to clients. See \fIsmb.conf(5)\fRfor more information. .SH "LIMITATIONS" .PP On some systems \fBsmbd\fR cannot change uid back @@ -315,10 +311,10 @@ need the assistance of your system administrator to modify the system files. .PP You will probably want to set up the NetBIOS name server -\fBnmbd\fR at +\fBnmbd\fRat the same time as \fBsmbd\fR. To do this refer to the man page for \fBnmbd(8)\fR - . +. .PP First, ensure that a port is configured in the file \fI/etc/services\fR. The well-known port 139 @@ -387,7 +383,7 @@ to the service \fI\\\\fred\\mary\fR. .PP To properly test and experiment with the server, we recommend using the \fBsmbclient\fR program (see -\fBsmbclient(1)\fR ) +\fBsmbclient(1)\fR) and also going through the steps outlined in the file \fIDIAGNOSIS.txt\fR in the \fIdocs/\fR directory of your Samba installation. @@ -439,10 +435,10 @@ them after, however this would affect performance. .SH "SEE ALSO" .PP hosts_access(5), \fBinetd(8)\fR, -\fBnmbd(8)\fR , +\fBnmbd(8)\fR, \fIsmb.conf(5)\fR - , \fBsmbclient(1) -\fR , \fB testparm(1)\fR , \fBtestprns(1)\fR , and the Internet RFC's +, \fBsmbclient(1) +\fR, and the Internet RFC's \fIrfc1001.txt\fR, \fIrfc1002.txt\fR. In addition the CIFS (formerly SMB) specification is available as a link from the Web page diff --git a/docs/manpages/smbmnt.8 b/docs/manpages/smbmnt.8 index b3933397ab4..e0ffe3a099c 100644 --- a/docs/manpages/smbmnt.8 +++ b/docs/manpages/smbmnt.8 @@ -3,12 +3,12 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBMNT" "8" "23 February 2001" "" "" +.TH SMBMNT 8 "24 Mar 2001" "smbmnt 2.2.0-alpha3" .SH NAME smbmnt \- helper utility for mounting SMB filesystems .SH SYNOPSIS .sp -\fBsmbumount\fR \fBmount-point\fR [ \fB-s \fR ] [ \fB-r\fR ] [ \fB-u \fR ] [ \fB-g \fR ] [ \fB-f \fR ] [ \fB-d \fR ] +\fBsmbmnt\fR \fBmount-point\fR [ \fB-s \fR ] [ \fB-r\fR ] [ \fB-u \fR ] [ \fB-g \fR ] [ \fB-f \fR ] [ \fB-d \fR ] [ \fB-o \fR ] .SH "DESCRIPTION" .PP \fBsmbmnt\fR is a helper application used @@ -20,7 +20,7 @@ then mounts the directory. .PP The \fBsmbmnt\fR program is normally invoked by \fBsmbmount(8)\fR - . It should not be invoked directly by users. +. It should not be invoked directly by users. .SH "OPTIONS" .TP \fB-r\fR @@ -40,11 +40,20 @@ specify the octal file mask applied \fB-d mask\fR specify the octal directory mask applied +.TP +\fB-o options\fR +list of options that are passed as-is to smbfs, if this +command is run on a 2.4 or higher linux kernel. .SH "AUTHOR" .PP +Volker Lendecke, Andrew Tridgell, Michael H. Warfield +and others. +.PP The current maintainer of smbfs and the userspace tools \fBsmbmount\fR, \fBsmbumount\fR, and \fBsmbmnt\fR is Urban Widmark . +The SAMBA Mailing list +is the preferred place to ask questions regarding these programs. .PP The conversion of this manpage for Samba 2.2 was performed by Gerald Carter diff --git a/docs/manpages/smbmount.8 b/docs/manpages/smbmount.8 index 259dea7d6de..a254c7d023a 100644 --- a/docs/manpages/smbmount.8 +++ b/docs/manpages/smbmount.8 @@ -3,9 +3,9 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBMOUNT" "8" "23 February 2001" "" "" +.TH SMBMOUNT 8 "24 Mar 2001" "smbmount 2.2.0-alpha3" .SH NAME -smbmount \- mount and smbfs filesystem +smbmount \- mount an smbfs filesystem .SH SYNOPSIS .sp \fBsmbumount\fR \fBservice\fR \fBmount-point\fR [ \fB-o options\fR ] @@ -16,8 +16,17 @@ is usually invoked as \fBmount.smb\fR from the \fBmount(8)\fR command when using the "-t smb" option. The kernel must support the smbfs filesystem. .PP -Options to smbmount are specified as a comma separated list -of key=value pairs. +Options to smbmount are specified as a comma separated +list of key=value pairs. It is possible to send options other +than those listed here, assuming that smbfs supports them. If +you get mount failures, check your kernel log for errors on +unknown options. +.PP +smbmount is a daemon. After mounting it keeps running until +the mounted smbfs is umounted. It will log things that happen +when in daemon mode using the "machine name" smbmount, so +typically this output will end up in log.smbmount. The +smbmount process may also be called mount.smbfs. .PP \fBNOTE:\fR \fBsmbmount\fR calls \fBsmbmnt(8)\fR to do the actual mount. You @@ -27,26 +36,47 @@ that it can be found. .TP \fBusername=\fR specifies the username to connect as. If -this is not given then the environment variable \fI $USER\fR is used. This option can also take the -form "user%password" or "user/workgroup" or -"user/workgroup%password" to allow the password and workgroup +this is not given, then the environment variable \fB USER\fR is used. This option can also take the +form "user%password" or "user/workgroup" or +"user/workgroup%password" to allow the password and workgroup to be specified as part of the username. .TP \fBpassword=\fR -specifies the SMB password. If not given then -\fBsmbmount\fR will prompt for a passeword, unless -the guest option is given. +specifies the SMB password. If this +option is not given then the environment variable +\fBPASSWD\fR is used. If it can find +no password \fBsmbmount\fR will prompt +for a passeword, unless the guest option is +given. +.TP +\fBcredentials=\fR +specifies a file that contains a username +and/or password. The format of the file is: + +.sp +.nf + username = + password = + +.sp +.fi + +This is preferred over having passwords in plaintext in a +shared file, such as /etc/fstab. Be sure to protect any +credentials file properly. .TP \fBnetbiosname=\fR sets the source NetBIOS name. It defaults to the local hostname. .TP \fBuid=\fR -sets the uid that files will be mounted as. +sets the uid that will own all files on +the mounted filesystem. It may be specified as either a username or a numeric uid. .TP \fBgid=\fR -sets the gid that files will be mounted as. +sets the gid that will own all files on +the mounted filesystem. It may be specified as either a groupname or a numeric gid. .TP @@ -76,7 +106,7 @@ sets the workgroup on the destination .TP \fBsockopt=\fR sets the TCP socket options. See the \fIsmb.conf -\fR \fIsocket options\fR option. +\fR\fIsocket options\fR option. .TP \fBscope=\fR sets the NetBIOS scope @@ -89,11 +119,75 @@ mount read-only .TP \fBrw\fR mount read-write +.TP +\fBiocharset=\fR +sets the charset used by the linux side for codepage +to charset translations (NLS). Argument should be the +name of a charset, like iso8859-1. (Note: only kernel +2.4.0 or later) +.TP +\fBcodepage=\fR +sets the codepage the server uses. See the iocharset +option. Example value cp850. (Note: only kernel 2.4.0 +or later) +.TP +\fBttl=\fR +how long a directory listing is cached in milliseconds +(also affects visibility of file size and date +changes). A higher value means that changes on the +server take longer to be noticed but it can give +better performance on large directories, especially +over long distances. Default is 1000ms but something +like 10000ms (10 seconds) is probably more reasonable +in many cases. +(Note: only kernel 2.4.2 or later) +.SH "ENVIRONMENT VARIABLES" +.PP +The variable \fBUSER\fR may contain the username of the +person using the client. This information is used only if the +protocol level is high enough to support session-level +passwords. The variable can be used to set both username and +password by using the format username%password. +.PP +The variable \fBPASSWD\fR may contain the password of the +person using the client. This information is used only if the +protocol level is high enough to support session-level +passwords. +.PP +The variable \fBPASSWD_FILE\fR may contain the pathname of +a file to read the password from. A single line of input is +read and used as password. +.SH "BUGS" +.PP +Not many known smbmount bugs. But one smbfs bug is +important enough to mention here anyway: +.TP 0.2i +\(bu +Mounts sometimes stop working. This is usually +caused by smbmount terminating. Since smbfs needs smbmount to +reconnect when the server disconnects, the mount will go +dead. A re-mount normally fixes this. At least 2 ways to +trigger this bug are known. +.PP +Note that the typical response to a bugreport is suggestion +to try the latest version first. So please try doing that first, +and always include which versions you use of relevant software +when reporting bugs (minimum: samba, kernel, distribution) +.PP +.SH "SEE ALSO" +.PP +Documentation/filesystems/smbfs.txt in the kernel source tree +may contain additional options and information. .SH "AUTHOR" .PP +Volker Lendecke, Andrew Tridgell, Michael H. Warfield +and others. +.PP The current maintainer of smbfs and the userspace tools \fBsmbmount\fR, \fBsmbumount\fR, -and \fBsmbmnt\fR is Urban Widmark +and \fBsmbmnt\fR is Urban Widmark . +The SAMBA Mailing list +is the preferred place to ask questions regarding these programs. .PP The conversion of this manpage for Samba 2.2 was performed by Gerald Carter diff --git a/docs/manpages/smbpasswd.5 b/docs/manpages/smbpasswd.5 index e6957732f37..5c60eac4eb5 100644 --- a/docs/manpages/smbpasswd.5 +++ b/docs/manpages/smbpasswd.5 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBPASSWD" "5" "23 February 2001" "" "" +.TH SMBPASSWD 5 "24 Mar 2001" "smbpasswd 2.2.0-alpha3" .SH NAME smbpasswd \- The Samba encrypted password file .SH SYNOPSIS @@ -11,7 +11,7 @@ smbpasswd \- The Samba encrypted password file \fIsmbpasswd\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP smbpasswd is the Samba encrypted password file. It contains the username, Unix user id and the SMB hashed passwords of the @@ -109,7 +109,7 @@ in the smbpasswd file. account has no password (the passwords in the fields Lanman Password Hash and NT Password Hash are ignored). Note that this will only allow users to log on with no password if the \fI null passwords\fR parameter is set in the \fIsmb.conf(5) -\fR config file. +\fRconfig file. .TP 0.2i \(bu \fBD\fR - This means the account @@ -141,8 +141,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBsmbpasswd(8)\fR , -samba(7) , and +\fBsmbpasswd(8)\fR, +samba(7), and the Internet RFC1321 for details on the MD4 algorithm. .SH "AUTHOR" .PP diff --git a/docs/manpages/smbpasswd.8 b/docs/manpages/smbpasswd.8 index f47ff0d9d4e..18cf1e17f19 100644 --- a/docs/manpages/smbpasswd.8 +++ b/docs/manpages/smbpasswd.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBPASSWD" "8" "23 February 2001" "" "" +.TH "SMBPASSWD" "8" "03 April 2001" "" "" .SH NAME smbpasswd \- change a users SMB password .SH SYNOPSIS @@ -11,7 +11,7 @@ smbpasswd \- change a users SMB password \fBsmbpasswd\fR [ \fB-a\fR ] [ \fB-x\fR ] [ \fB-d\fR ] [ \fB-e\fR ] [ \fB-D debuglevel\fR ] [ \fB-n\fR ] [ \fB-r \fR ] [ \fB-R \fR ] [ \fB-m\fR ] [ \fB-j DOMAIN\fR ] [ \fB-U username\fR ] [ \fB-h\fR ] [ \fB-s\fR ] [ \fBusername\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP The smbpasswd program has several different functions, depending on whether it is run by the \fBroot\fR @@ -159,7 +159,7 @@ a real password database so it is not possible to change passwords specifying a Win95/98 machine as remote machine target. .TP \fB-R name resolve order\fR -This option allows the user of smbclient to determine +This option allows the user of smbpasswd to determine what name resolution services to use when looking up the NetBIOS name of the host being connected to. @@ -170,7 +170,7 @@ names to be resolved as follows : \(bu lmhosts : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has -no name type attached to the NetBIOS name (see the lmhosts(5) for details) then +no name type attached to the NetBIOS name (see the lmhosts(5)for details) then any name type matches for lookup. .TP 0.2i \(bu @@ -284,9 +284,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fIsmbpasswd(5)\fR , -samba(7) -.SH "AUTHOR" +\fIsmbpasswd(5)\fR, +samba(7).SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/smbrun.1 b/docs/manpages/smbrun.1 index 68a8d812044..c671a505aee 100644 --- a/docs/manpages/smbrun.1 +++ b/docs/manpages/smbrun.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBRUN" "1" "23 February 2001" "" "" +.TH SMBRUN 1 "24 Mar 2001" "smbrun 2.2.0-alpha3" .SH NAME smbrun \- interface program between smbd and external programs .SH SYNOPSIS @@ -11,10 +11,10 @@ smbrun \- interface program between smbd and external programs \fBsmbrun\fR \fB\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBsmbrun\fR is a very small 'glue' program, -which runs shell commands for the \fB smbd(8)\fR daemon. +which runs shell commands for the \fB smbd(8)\fRdaemon. .PP It first changes to the highest effective user and group ID that it can, then runs the command line provided using the @@ -35,7 +35,7 @@ is not given in the command. .PP If \fBsmbrun\fR cannot be located or cannot be executed by \fBsmbd(8)\fR - , then appropriate messages will be found in the \fB smbd\fR logs. Other diagnostics are dependent on the shell-command +, then appropriate messages will be found in the \fB smbd\fR logs. Other diagnostics are dependent on the shell-command being run. It is advisable for your shell commands to issue suitable diagnostics to aid trouble-shooting. .SH "VERSION" @@ -44,10 +44,9 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBnmbd(8)\fR , +\fBnmbd(8)\fR, \fBsmbclient(1) -\fR , and \fBnmblookup(1)\fR -.SH "AUTHOR" +\fR.SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/smbsh.1 b/docs/manpages/smbsh.1 index f3c5974474c..301e52668c6 100644 --- a/docs/manpages/smbsh.1 +++ b/docs/manpages/smbsh.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBSH" "1" "23 February 2001" "" "" +.TH SMBSH 1 "24 Mar 2001" "smbsh 2.2.0-alpha3" .SH NAME smbsh \- Allows access to Windows NT filesystem using UNIX commands .SH SYNOPSIS @@ -11,7 +11,7 @@ smbsh \- Allows access to Windows NT filesystem using UNIX commands \fBsmbsh\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBsmbsh\fR allows you to access an NT filesystem using UNIX commands such as \fBls\fR, \fB egrep\fR, and \fBrcp\fR. You must use a @@ -55,9 +55,8 @@ of UNIX have a \fBfile\fR command that will describe how a program was linked. .SH "SEE ALSO" .PP -\fBsmbd(8)\fR , -smb.conf(5) -.SH "AUTHOR" +\fBsmbd(8)\fR, +smb.conf(5).SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/smbspool.8 b/docs/manpages/smbspool.8 index 5144320c220..0fecf8ca02c 100644 --- a/docs/manpages/smbspool.8 +++ b/docs/manpages/smbspool.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBSPOOL" "8" "23 February 2001" "" "" +.TH SMBSPOOL 8 "24 Mar 2001" "smbspool 2.2.0-alpha3" .SH NAME nmblookup \- send print file to an SMB printer .SH SYNOPSIS @@ -11,7 +11,7 @@ nmblookup \- send print file to an SMB printer \fBsmbspool\fR [ \fBjob\fR ] [ \fBuser\fR ] [ \fBtitle\fR ] [ \fBcopies\fR ] [ \fBoptions\fR ] [ \fBfilename\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP smbspool is a very small print spooling program that sends a print file to an SMB printer. The command-line arguments @@ -82,8 +82,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBsmbd(8)\fR , -and samba(7) . +\fBsmbd(8)\fR, +and samba(7). .SH "AUTHOR" .PP \fBsmbspool\fR was written by Michael Sweet diff --git a/docs/manpages/smbstatus.1 b/docs/manpages/smbstatus.1 index b97417ccda6..1b99b065207 100644 --- a/docs/manpages/smbstatus.1 +++ b/docs/manpages/smbstatus.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBSTATUS" "1" "23 February 2001" "" "" +.TH SMBSTATUS 1 "24 Mar 2001" "smbstatus 2.2.0-alpha3" .SH NAME smbstatus \- report on current Samba connections .SH SYNOPSIS @@ -11,7 +11,7 @@ smbstatus \- report on current Samba connections \fBsmbstatus\fR [ \fB-P\fR ] [ \fB-b\fR ] [ \fB-d\fR ] [ \fB-L\fR ] [ \fB-p\fR ] [ \fB-S\fR ] [ \fB-s \fR ] [ \fB-u \fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBsmbstatus\fR is a very simple program to list the current Samba connections. @@ -32,7 +32,7 @@ gives verbose output. causes smbstatus to only list locks. .TP \fB-p\fR -print a list of \fBsmbd(8)\fR processes and exit. +print a list of \fBsmbd(8)\fRprocesses and exit. Useful for scripting. .TP \fB-S\fR @@ -42,7 +42,7 @@ causes smbstatus to only list shares. The default configuration file name is determined at compile time. The file specified contains the configuration details required by the server. See \fIsmb.conf(5)\fR - for more information. +for more information. .TP \fB-u \fR selects information relevant to @@ -53,8 +53,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBsmbd(8)\fR and -smb.conf(5) . +\fBsmbd(8)\fRand +smb.conf(5). .SH "AUTHOR" .PP The original Samba software and related utilities diff --git a/docs/manpages/smbtar.1 b/docs/manpages/smbtar.1 index 34b1ee4fb12..b8c5436cdf9 100644 --- a/docs/manpages/smbtar.1 +++ b/docs/manpages/smbtar.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBTAR" "1" "23 February 2001" "" "" +.TH SMBTAR 1 "24 Mar 2001" "smbtar 2.2.0-alpha3" .SH NAME smbtar \- shell script for backing up SMB/CIFS shares directly to UNIX tape drives .SH SYNOPSIS @@ -11,11 +11,10 @@ smbtar \- shell script for backing up SMB/CIFS shares directly to UNIX tape dri \fBsmbtar\fR \fB-s server\fR [ \fB-p password\fR ] [ \fB-x services\fR ] [ \fB-X\fR ] [ \fB-d directory\fR ] [ \fB-u user\fR ] [ \fB-t tape\fR ] [ \fB-t tape\fR ] [ \fB-b blocksize\fR ] [ \fB-N filename\fR ] [ \fB-i\fR ] [ \fB-r\fR ] [ \fB-l loglevel\fR ] [ \fB-v\fR ] \fBfilenames\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBsmbtar\fR is a very small shell script on top -of \fBsmbclient(1)\fR -which dumps SMB shares directly to tape. +of \fBsmbclient(1)\fRwhich dumps SMB shares directly to tape. .SH "OPTIONS" .TP \fB-s server\fR @@ -92,16 +91,16 @@ with GNU tar and may not work well with other versions. .PP See the \fBDIAGNOSTICS\fR section for the \fBsmbclient(1)\fR - command. +command. .SH "VERSION" .PP This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fBsmbd(8)\fR , -\fBsmbclient(1)\fR , -smb.conf(5) , +\fBsmbd(8)\fR, +\fBsmbclient(1)\fR, +smb.conf(5), .SH "AUTHOR" .PP The original Samba software and related utilities diff --git a/docs/manpages/smbumount.8 b/docs/manpages/smbumount.8 index 07f17bababe..3f38f7f5214 100644 --- a/docs/manpages/smbumount.8 +++ b/docs/manpages/smbumount.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBUMOUNT" "8" "23 February 2001" "" "" +.TH SMBUMOUNT 8 "24 Mar 2001" "smbumount 2.2.0-alpha3" .SH NAME smbumount \- smbfs umount for normal users .SH SYNOPSIS @@ -26,12 +26,16 @@ The directory to unmount. .SH "SEE ALSO" .PP \fBsmbmount(8)\fR - .SH "AUTHOR" .PP +Volker Lendecke, Andrew Tridgell, Michael H. Warfield +and others. +.PP The current maintainer of smbfs and the userspace tools \fBsmbmount\fR, \fBsmbumount\fR, and \fBsmbmnt\fR is Urban Widmark . +The SAMBA Mailing list +is the preferred place to ask questions regarding these programs. .PP The conversion of this manpage for Samba 2.2 was performed by Gerald Carter diff --git a/docs/manpages/swat.8 b/docs/manpages/swat.8 index 7a2441549b3..5e9f0d11c59 100644 --- a/docs/manpages/swat.8 +++ b/docs/manpages/swat.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SWAT" "8" "23 February 2001" "" "" +.TH SWAT 8 "24 Mar 2001" "swat 2.2.0-alpha3" .SH NAME swat \- Samba Web Administration Tool .SH SYNOPSIS @@ -11,10 +11,10 @@ swat \- Samba Web Administration Tool \fBnmblookup\fR [ \fB-s \fR ] [ \fB-a\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBswat\fR allows a Samba administrator to -configure the complex \fI smb.conf(5)\fR file via a Web browser. In addition, +configure the complex \fI smb.conf(5)\fRfile via a Web browser. In addition, a \fBswat\fR configuration page has help links to all the configurable options in the smb.conf file allowing an administrator to easily look up the effects of any change. @@ -123,9 +123,8 @@ the Samba suite. .SH "SEE ALSO" .PP \fBinetd(5)\fR, -\fBsmbd(8)\fR , -smb.conf(5) -.SH "AUTHOR" +\fBsmbd(8)\fR, +smb.conf(5).SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/testparm.1 b/docs/manpages/testparm.1 index 3dc3c92d645..6a2f066964f 100644 --- a/docs/manpages/testparm.1 +++ b/docs/manpages/testparm.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "TESTPARM" "1" "23 February 2001" "" "" +.TH TESTPARM 1 "24 Mar 2001" "testparm 2.2.0-alpha3" .SH NAME testparm \- check an smb.conf configuration file for internal correctness .SH SYNOPSIS @@ -11,7 +11,7 @@ testparm \- check an smb.conf configuration file for internal correctness \fBtestparm\fR [ \fB-s\fR ] [ \fB-h\fR ] [ \fB-L \fR ] \fBconfig filename\fR [ \fBhostname hostIP\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBtestparm\fR is a very simple test program to check an \fBsmbd\fR configuration file for @@ -83,9 +83,8 @@ This man page is correct for version 2.2 of the Samba suite. .SH "SEE ALSO" .PP -\fIsmb.conf(5)\fR , -\fBsmbd(8)\fR -.SH "AUTHOR" +\fIsmb.conf(5)\fR, +\fBsmbd(8)\fR.SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/testprns.1 b/docs/manpages/testprns.1 index 606516b0fd4..5f01f0dc825 100644 --- a/docs/manpages/testprns.1 +++ b/docs/manpages/testprns.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "TESTPRNS" "1" "23 February 2001" "" "" +.TH TESTPRNS 1 "24 Mar 2001" "testprns 2.2.0-alpha3" .SH NAME testprns \- check printer name for validity with smbd .SH SYNOPSIS @@ -11,11 +11,11 @@ testprns \- check printer name for validity with smbd \fBtestprns\fR \fBprintername\fR [ \fBprintcapname\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP \fBtestprns\fR is a very simple test program to determine whether a given printer name is valid for use in -a service to be provided by \fB smbd(8)\fR . +a service to be provided by \fB smbd(8)\fR. .PP "Valid" in this context means "can be found in the printcap specified". This program is very stupid - so stupid in @@ -73,9 +73,8 @@ the Samba suite. .SH "SEE ALSO" .PP \fIprintcap(5)\fR, -\fBsmbd(8)\fR , -\fBsmbclient(1)\fR -.SH "AUTHOR" +\fBsmbd(8)\fR, +\fBsmbclient(1)\fR.SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed diff --git a/docs/manpages/wbinfo.1 b/docs/manpages/wbinfo.1 index 70a6882c097..ce558bc2e93 100644 --- a/docs/manpages/wbinfo.1 +++ b/docs/manpages/wbinfo.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "WBINFO" "1" "23 February 2001" "" "" +.TH WBINFO 1 "24 Mar 2001" "wbinfo 2.2.0-alpha3" .SH NAME wbinfo \- Query information from winbind daemon .SH SYNOPSIS @@ -11,10 +11,10 @@ wbinfo \- Query information from winbind daemon \fBnmblookup\fR [ \fB-u\fR ] [ \fB-g\fR ] [ \fB-n name\fR ] [ \fB-s sid\fR ] [ \fB-U uid\fR ] [ \fB-G gid\fR ] [ \fB-S sid\fR ] [ \fB-Y sid\fR ] [ \fB-t\fR ] [ \fB-m\fR ] .SH "DESCRIPTION" .PP -This tool is part of the Samba suite. +This tool is part of the Sambasuite. .PP The \fBwbinfo\fR program queries and returns information -created and used by the \fB winbindd(8)\fR daemon. +created and used by the \fB winbindd(8)\fRdaemon. .PP The \fBwinbindd(8)\fR daemon must be configured and running for the \fBwbinfo\fR program to be able @@ -96,7 +96,6 @@ stable release of Samba as of yet. .SH "SEE ALSO" .PP \fBwinbindd(8)\fR - .SH "AUTHOR" .PP The original Samba software and related utilities diff --git a/docs/manpages/winbindd.8 b/docs/manpages/winbindd.8 index bbbcd8ffb6c..38e10d8b3ef 100644 --- a/docs/manpages/winbindd.8 +++ b/docs/manpages/winbindd.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "WINBINDD" "8" "23 February 2001" "" "" +.TH WINBINDD 8 "24 Mar 2001" "winbindd 2.2.0-alpha3" .SH NAME winbindd \- Name Service Switch daemon for resolving names from NT servers .SH SYNOPSIS @@ -11,7 +11,7 @@ winbindd \- Name Service Switch daemon for resolving names from NT servers \fBnmblookup\fR [ \fB-d debuglevel\fR ] [ \fB-i\fR ] [ \fB-S\fR ] [ \fB-r\fR ] [ \fB-A\fR ] [ \fB-h\fR ] [ \fB-B \fR ] [ \fB-U \fR ] [ \fB-d \fR ] [ \fB-s \fR ] [ \fB-i \fR ] [ \fB-T\fR ] \fBname\fR .SH "DESCRIPTION" .PP -This tool is part of the Samba suite version 3.0 and describes functionality not +This tool is part of the Sambasuite version 3.0 and describes functionality not yet implemented in the main version of Samba. .PP \fBwinbindd\fR is a daemon that provides @@ -358,10 +358,9 @@ stable release of Samba as of yet. .SH "SEE ALSO" .PP \fInsswitch.conf(5)\fR, -samba(7) , -wbinfo(1) , -smb.conf(5) -.SH "AUTHOR" +samba(7), +wbinfo(1), +smb.conf(5).SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed -- cgit