From c8af938a0a7ec15c38076fc11d164f55737318f1 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Tue, 24 Apr 2001 19:09:42 +0000 Subject: syncing up changes in 2.2 (This used to be commit ffbbe67dbfde7f7ce4bb70becfc696c395dbf6b2) --- docs/htmldocs/NT_Security.html | 2 +- docs/htmldocs/Samba-HOWTO-Collection.html | 1203 +++++++++++++++++----------- docs/htmldocs/findsmb.1.html | 9 + docs/htmldocs/lmhosts.5.html | 14 +- docs/htmldocs/make_smbcodepage.1.html | 4 +- docs/htmldocs/nmbd.8.html | 45 +- docs/htmldocs/nmblookup.1.html | 24 +- docs/htmldocs/printer_driver2.html | 527 +++++++----- docs/htmldocs/rpcclient.1.html | 71 +- docs/htmldocs/smb.conf.5.html | 1241 +++++++++++++---------------- docs/htmldocs/smbcacls.1.html | 62 +- docs/htmldocs/smbclient.1.html | 109 ++- docs/htmldocs/smbd.8.html | 50 +- docs/htmldocs/smbmnt.8.html | 2 +- docs/htmldocs/smbmount.8.html | 54 +- docs/htmldocs/smbpasswd.5.html | 50 +- docs/htmldocs/smbpasswd.8.html | 26 +- docs/htmldocs/smbsh.1.html | 11 +- docs/htmldocs/smbspool.8.html | 5 +- docs/htmldocs/smbstatus.1.html | 6 +- docs/htmldocs/smbtar.1.html | 5 +- docs/htmldocs/swat.8.html | 7 +- docs/htmldocs/testparm.1.html | 7 +- docs/htmldocs/testprns.1.html | 4 +- docs/htmldocs/winbindd.8.html | 52 +- 25 files changed, 1972 insertions(+), 1618 deletions(-) (limited to 'docs/htmldocs') diff --git a/docs/htmldocs/NT_Security.html b/docs/htmldocs/NT_Security.html index 081f7fb838..43ba056624 100644 --- a/docs/htmldocs/NT_Security.html +++ b/docs/htmldocs/NT_Security.html @@ -44,7 +44,7 @@ NAME="AEN3" >

In Samba 2.0.4 and above the default value of the parameter

1.1. Step 0: Read the man pages
1.2. Step 1: Building the Binaries
1.3. Step 2: The all important step
1.4. Step 3: Create the smb configuration file.
1.5. Step 4: Test your config file with
1.6. Step 5: Starting the smbd and nmbd
1.6.1. Step 5a: Starting from inetd.conf
1.6.2. Step 5b. Alternative: starting it as a daemon
1.7. Step 6: Try listing the shares available on your server
1.8. Step 7: Try connecting with the unix client
1.9. Step 8: Try connecting from a DOS, WfWg, Win9x, WinNT, Win2k, OS/2, etc... client
1.10. What If Things Don't Work?
1.10.1. Diagnosing Problems
1.10.2. Scope IDs
1.10.3. Choosing the Protocol Level
1.10.4. Printing from UNIX to a Client PC
1.10.5. Locking
1.10.6. Mapping Usernames
1.10.7. Other Character Sets
2.1. Introduction
2.2. How does it work?
2.3. Important Notes About Security
2.3.1. Advantages of SMB Encryption
2.3.2. Advantages of non-encrypted passwords
2.4. The smbpasswd file
2.5. The smbpasswd Command
2.6. Setting up Samba to support LanManager Encryption
3.1. Instructions
3.1.1. Notes
4.1. Introduction
4.2. Configuration
4.2.1. Creating [print$]
4.2.2. Setting Drivers for Existing Printers
4.2.3. Support a large number of printers
4.2.4. Adding New Printers via the Windows NT APW
4.2.5. Samba and Printer Ports
4.3. The Imprints Toolset
4.3.1. What is Imprints?
4.3.2. Creating Printer Driver Packages
4.3.3. The Imprints server
4.3.4. The Installation Client
4.4.
5. security = domain in Samba 2.x
5.1. Joining an NT Domain with Samba 2.2
5.2. Samba and Windows 2000 Domains
5.3. Why is this better than security = server?
6. How to Configure Samba 2.2.x as a Primary Domain Controller
6.1. Background
6.2. Configuring the Samba Domain Controller
6.3. Creating Machine Trust Accounts and Joining Clients to the Domain
6.4. Common Problems and Errors
6.5. System Policies and Profiles
6.6. What other help can I get ?
6.6.1. URLs and similar
6.6.2. Mailing Lists
6.7. DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba
7. Unifed Logons between Windows NT and UNIX using Winbind
7.1. Abstract
7.2. Introduction
7.3. What Winbind Provides
7.3.1. Target Uses
7.4. How Winbind Works
7.4.1. Microsoft Remote Procedure Calls
7.4.2. Name Service Switch
7.4.3. Pluggable Authentication Modules
7.4.4. User and Group ID Allocation
7.4.5. Result Caching
7.5. Installation and Configuration
7.6. Limitations
7.7. Conclusion
8. UNIX Permission Bits and WIndows NT Access Control Lists
8.1. Viewing and changing UNIX permissions using the NT security dialogs
8.2. How to view file security on a Samba share
8.3. Viewing file ownership
8.4. Viewing file or directory permissions
8.4.1. File Permissions
8.4.2. Directory Permissions
8.5. Modifying file or directory permissions
8.6. Interaction with the standard Samba create mask parameters
8.7. Interaction with the standard Samba file attribute mapping
9. OS2 Client HOWTO
9.1. FAQs
9.1.1. How can I configure OS/2 Warp Connect or OS/2 Warp 4 as a client for Samba?
9.1.2. How can I configure OS/2 Warp 3 (not Connect), OS/2 1.2, 1.3 or 2.x for Samba?
9.1.3. Are there any other issues when OS/2 (any version) is used as a client?
9.1.4. How do I get printer driver download working for OS/2 clients?
Step 0: Read the man pages1.1. Step 0: Read the man pages

The man pages distributed with SAMBA contain @@ -638,7 +658,7 @@ CLASS="SECT1" CLASS="SECT1" >Step 1: Building the Binaries1.2. Step 1: Building the Binaries

To do this, first run the program Step 2: The all important step1.3. Step 2: The all important step

At this stage you must fetch yourself a @@ -754,7 +774,7 @@ CLASS="SECT1" CLASS="SECT1" >Step 3: Create the smb configuration file.1.4. Step 3: Create the smb configuration file.

There are sample configuration files in the examples @@ -765,6 +785,12 @@ NAME="AEN57" >The simplest useful configuration file would be something like this:

	[global]
@@ -774,6 +800,9 @@ CLASS="PROGRAMLISTING"
 	      guest ok = no
 	      read only = no
 	

which would allow connections by anyone with an @@ -810,7 +839,7 @@ CLASS="SECT1" CLASS="SECT1" >Step 4: Test your config file with +>1.5. Step 4: Test your config file with testparmStep 5: Starting the smbd and nmbd1.6. Step 5: Starting the smbd and nmbd

You must choose to start smbd and nmbd either @@ -874,7 +903,7 @@ CLASS="SECT2" CLASS="SECT2" >Step 5a: Starting from inetd.conf1.6.1. Step 5a: Starting from inetd.conf

NOTE; The following will be different if @@ -909,11 +938,20 @@ CLASS="FILENAME" > 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 Step 5b. Alternative: starting it as a daemon1.6.2. Step 5b. Alternative: starting it as a daemon

To start the server as a daemon you should create @@ -988,12 +1026,21 @@ CLASS="FILENAME" >startsmb.

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

then make it executable with Step 6: Try listing the shares available on your +>1.7. Step 6: Try listing the shares available on your server

Step 7: Try connecting with the unix client1.8. Step 7: Try connecting with the unix client

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

What If Things Don't Work?1.10. What If Things Don't Work?

If nothing works and you start to think "who wrote @@ -1211,7 +1258,7 @@ CLASS="SECT2" CLASS="SECT2" >Diagnosing Problems1.10.1. Diagnosing Problems

If you have instalation problems then go to @@ -1227,13 +1274,13 @@ CLASS="SECT2" CLASS="SECT2" >Scope IDs1.10.2. 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 + 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 Level1.10.3. Choosing the Protocol Level

The SMB protocol has many dialects. Currently @@ -1284,7 +1331,7 @@ CLASS="SECT2" CLASS="SECT2" >Printing from UNIX to a Client PC1.10.4. Printing from UNIX to a Client PC

To use a printer that is available via a smb-based @@ -1302,7 +1349,7 @@ CLASS="SECT2" CLASS="SECT2" >Locking1.10.5. Locking

One area which sometimes causes trouble is locking.

Mapping Usernames1.10.6. Mapping Usernames

If you have different usernames on the PCs and @@ -1376,7 +1423,7 @@ CLASS="SECT2" CLASS="SECT2" >Other Character Sets1.10.7. Other Character Sets

If you have problems using filenames with accented @@ -1400,7 +1447,7 @@ CLASS="SECT1" CLASS="SECT1" >Introduction2.1. Introduction

With the development of LanManager and Windows NT @@ -1419,7 +1466,7 @@ CLASS="SECT1" CLASS="SECT1" >How does it work?2.2. How does it work?

LanManager encryption is somewhat similar to UNIX @@ -1484,7 +1531,7 @@ CLASS="SECT1" CLASS="SECT1" >Important Notes About Security2.3. Important Notes About Security

The unix and SMB password encryption techniques seem similar @@ -1526,9 +1573,8 @@ ALIGN="LEFT" >

Note that Windows NT 4.0 Service pack 3 changed the default for permissible authentication so that plaintext - passwords are nevernever 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 @@ -1560,9 +1606,8 @@ CLASS="EMPHASIS" >

Note :Note :All current release of Microsoft SMB/CIFS clients support authentication via the SMB Challenge/Response mechanism described here. Enabling @@ -1578,7 +1623,7 @@ CLASS="SECT2" CLASS="SECT2" >Advantages of SMB Encryption2.3.1. Advantages of SMB Encryption

Advantages of non-encrypted passwords2.3.2. Advantages of non-encrypted passwords

2.4. The smbpasswd filecat /etc/passwd | mksmbpasswd.sh - > /usr/local/samba/private/smbpasswd

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

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

Although only the sections are significant and are looked at in the Samba code.

It is VITALLYIt 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 @@ -1794,10 +1847,19 @@ CLASS="CONSTANT" >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 @@ -1824,9 +1886,8 @@ CLASS="COMMAND" users a default password to begin with, so you do not have to enable this on your server.

Note : 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 @@ -1841,7 +1902,7 @@ CLASS="SECT1" CLASS="SECT1" >The smbpasswd Command2.5. The smbpasswd Command

The smbpasswd command maintains the two 32 byte password fields @@ -1859,10 +1920,9 @@ CLASS="FILENAME" > (or your main Samba binary directory).

Note that as of Samba 1.9.18p4 this program Note that as of Samba 1.9.18p4 this program MUST NOT - BE INSTALLED setuid root (the new smbpasswd<type old value here - - or hit return if there was no old password><type old value here - + or hit return if there was no old password>

<type new value> +><type new value>

<re-type new value +><re-type new value

Setting up Samba to support LanManager Encryption2.6. Setting up Samba to support LanManager Encryption

This is a very brief description on how to setup samba to @@ -2011,7 +2071,7 @@ CLASS="FILENAME" >smbpasswd password file in the place you specified in the Makefile - (--prefix=<dir>). See the notes under the The smbpasswd File @@ -2035,7 +2095,7 @@ CLASS="SECT1" CLASS="SECT1" >Instructions3.1. Instructions

The Distributed File System (or Dfs) provides a means of @@ -2087,7 +2147,7 @@ CLASS="PARAMETER" to other servers. For example, a symbolic link junction->msdfs:storage1\share1junction->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 @@ -2099,6 +2159,12 @@ CLASS="FILENAME" >Here's an example of setting up a Dfs tree on a Samba server.

# The smb.conf file:
@@ -2110,6 +2176,9 @@ CLASS="PROGRAMLISTING"
 	path = /export/dfsroot
 	msdfs root = yes
 	

In the /export/dfsroot directory we set up our dfs links to @@ -2183,7 +2252,7 @@ CLASS="SECT2" CLASS="SECT2" >Notes3.1.1. Notes

Introduction4.1. Introduction

Beginning with the 2.2.0 release, Samba supports @@ -2258,12 +2327,12 @@ TARGET="_top" >

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) +>http://msdn.microsoft.com/ + for more information on the Win32 printing API)

  • Configuration4.2. 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.

    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 - Migration section of this document.


    4.2.1. Creating [print$]

    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).

    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$]
    @@ -2369,6 +2431,9 @@ CLASS="PROGRAMLISTING"
         browseable = yes
         read only = yes
         write list = ntadmin

    The 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.

    In order for a Windows NT print server to support the downloading of driver files by multiple client architectures, @@ -2431,6 +2500,12 @@ Samba follows this model as well.

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

    [print$]-----
    @@ -2439,6 +2514,9 @@ CLASS="PROGRAMLISTING"
             |-W32ALPHA         ; "Windows NT Alpha_AXP"
             |-W32MIPS          ; "Windows NT R4000"
             |-W32PPC           ; "Windows NT PowerPC"

    WarningATTENTION! REQUIRED PERMISSIONS

    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 be a member of the printer adminprinter + admin list.


    4.2.2. Setting Drivers for Existing Printers

    The initial listing of printers in the Samba host's Printers folder will have no printer driver assigned to them. @@ -2553,13 +2636,14 @@ 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 printers4.2.3. Support a large number of printers

    One issue that has arisen during the development @@ -2578,6 +2662,12 @@ setdriver command

     
    @@ -2613,20 +2703,165 @@ CLASS="PROMPT"
     >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.


    4.2.4. Adding New Printers via the Windows NT APW

    By default, Samba offers all printer shares defined in smb.conf +in the "Printers..." folder. Also existing in this folder is the Windows NT +Add Printer Wizard icon. The APW will be show only if

    • The connected user is able to successfully + execute an OpenPrinterEx(\\server) with administrative + priviledges (i.e. root or printer admin. +

    • show + add printer wizard = yes (the default). +

    In order to be able to use the APW to successfully add a printer to a Samba +server, the addprinter +command must have a defined value. The program +hook must successfully add the printer to the system (i.e. +/etc/printcap or appropriate files) and +smb.conf if necessary.

    When using the APW from a client, if the named printer share does +not exist, smbd will execute the add printer +program and reparse to the smb.conf +to attempt to locate the new printer share. If the share is still not defined, +an error of "Access Denied" is returned to the client. Note that the +add printer program is executed undet the context +of the connected user, not necessarily a root account.

    There is a complementing deleteprinter +command for removing entries from the "Printers..." +folder.


    4.2.5. Samba and Printer Ports

    Windows NT/2000 print servers associate a port with each printer. These normally +take the form of LPT1:, COM1:, FILE:, etc... Samba must also support the +concept of ports associated with a printer. By default, only one printer port, +named "Samba Printer Port", exists on a system. Samba does not really a port in +order to print, rather it is a requirement of Windows clients.

    Note that Samba does not support the concept of "Printer Pooling" internally +either. This is when a logical printer is assigned to multiple ports as +a form of load balancing or fail over.

    If you require that multiple ports be defined for some reason, +smb.conf possesses a enumports +command which can be used to define an external program +that generates a listing of ports on a system.


    The Imprints Toolset4.3. The Imprints Toolset

    The Imprints tool set provides a UNIX equivalent of the @@ -2643,8 +2878,8 @@ CLASS="SECT2" >


    What is Imprints?4.3.1. What is Imprints?

    Imprints is a collection of tools for supporting the goals @@ -2675,8 +2910,8 @@ CLASS="SECT2" >


    Creating Printer Driver Packages4.3.2. Creating Printer Driver Packages

    The process of creating printer driver packages is beyond @@ -2691,8 +2926,8 @@ CLASS="SECT2" >


    The Imprints server4.3.3. The Imprints server

    The Imprints server is really a database server that @@ -2701,9 +2936,8 @@ NAME="AEN544" 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 - notnot recommended that this security check be disabled.


    The Installation Client4.3.4. The Installation Client

    More information regarding the Imprints installation client @@ -2754,20 +2988,28 @@ CLASS="COMMAND" >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
    -		}
    +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 @@ -2807,8 +3049,8 @@ CLASS="SECT1" >


    4.4. Migration to from Samba 2.0.x to @@ -2831,7 +3073,7 @@ WIDTH="100%" >WarningAchtung!

    If you want to migrate an existing printers.def file into the new setup, the current only +>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 smbclient + and rpcclient. See the + Imprints installation client at Imprints installation client for an example. +>http://imprints.sourceforge.net/ + for an example.


  • Chapter 5. security = domain in Samba 2.x

    Joining an NT Domain with Samba 2.25.1. Joining an NT Domain with Samba 2.2

    In order for a Samba-2 server to join an NT domain, @@ -2952,9 +3203,8 @@ NAME="AEN617" 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", - NOTNOT as a Primary or backup domain controller.

    Assume you have a Samba-2 server with a NetBIOS name of @@ -3031,13 +3281,13 @@ CLASS="FILENAME" ><NT DOMAIN NAME><NT DOMAIN NAME>.<Samba - Server Name><Samba + Server Name>.mac


    Samba and Windows 2000 Domains5.2. Samba and Windows 2000 Domains

    Many people have asked regarding the state of Samba's ability to participate in @@ -3196,8 +3446,8 @@ CLASS="SECT1" >


    Why is this better than security = server?5.3. Why is this better than security = server?

    Currently, domain security in Samba doesn't free you from @@ -3262,9 +3512,8 @@ CLASS="COMMAND" user is authenticated, making a Samba server truly plug and play in an NT domain environment. Watch for this code soon.

    NOTE:NOTE: Much of the text of this document was first published in the Web magazine


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

    Background6.1. Background

    Author's Note :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.


    Configuring the Samba Domain Controller6.2. Configuring the Samba Domain Controller

    The first step in creating a working Samba PDC is to @@ -3425,6 +3673,12 @@ linked with the actual smb.conf description.

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

    [global]
    @@ -3566,6 +3820,9 @@ HREF="smb.conf.5.html#DIRECTORYMASK"
     TARGET="_top"
     >directory mask = 0700

    There are a couple of points to emphasize in the above @@ -3619,8 +3876,8 @@ CLASS="SECT1" >


    Creating Machine Trust Accounts and Joining Clients +NAME="AEN833" +>6.3. Creating Machine Trust Accounts and Joining Clients to the Domain

    /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 @@ -3719,10 +3985,9 @@ CLASS="REPLACEABLE" > 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.

    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 accountIn 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 rootroot. -The password SHOULDSHOULD be set to s different password that the associated


    Common Problems and Errors6.4. Common Problems and Errors

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

    A 'machine name' in (typically)

    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 @@ -3810,18 +4079,16 @@ 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)....""The system can not log you on (C000019B)...."

    I joined the domain successfully but after upgrading @@ -3843,10 +4110,9 @@ 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 @@ -3877,8 +4143,8 @@ CLASS="SECT1" >


    System Policies and Profiles6.5. System Policies and Profiles

    Much of the information necessary to implement System Policies and @@ -3893,9 +4159,8 @@ Profiles and Policies in Windows NT 4.0

    Here are some additional details:

    What about Windows NT Policy Editor ?What about Windows NT Policy Editor ?

    To create or edit poledit.exe which -is included with NT Server but not NT Workstationnot NT Workstation. There is a Policy Editor on a NTws -but it is not suitable for creating Domain PoliciesDomain Policies. Further, although the Windows 95 Policy Editor can be installed on an NT Workstation/Server, it will not @@ -3951,9 +4214,8 @@ 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 ?Can Win95 do Policies ?

    Install the group policy handler for Win9x to pick up group @@ -3973,9 +4235,8 @@ to be done on every Win9x machine that uses group policies....

    How do I get 'User Manager' and 'Server Manager'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 @@ -4020,8 +4281,8 @@ CLASS="SECT1" >


    What other help can I get ?6.6. What other help can I get ?

    There are many sources of information available in the form @@ -4029,10 +4290,9 @@ 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.

    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. @@ -4099,10 +4359,9 @@ TARGET="_top" formatted files.

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

    Installing netmon on an NT workstation requires a couple @@ -4203,8 +4462,8 @@ CLASS="SECT2" >


    URLs and similar6.6.1. URLs and similar

  • The Development The Development document on the Samba mirrors might mention your problem. If so, it might mean that the developers are working on it.


    Mailing Lists6.6.2. Mailing Lists

    How do I get help from the mailing lists ?How do I get help from the mailing lists ?

    There are a number of Samba related mailing lists. Go to

  • You might include partialYou 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 @@ -4377,9 +4633,8 @@ CLASS="EMPHASIS" >

  • How do I get off the mailing lists ?How do I get off the mailing lists ?

    To have your name removed from a samba mailing list, go to the @@ -4412,16 +4667,15 @@ CLASS="SECT1" >


    DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba6.7. 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 :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 @@ -4514,7 +4768,7 @@ within its registry.


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

    Abstract7.1. 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 @@ -4545,8 +4798,8 @@ CLASS="SECT1" >


    Introduction7.2. Introduction

    It is well known that UNIX and Microsoft Windows NT have @@ -4599,8 +4852,8 @@ CLASS="SECT1" >


    What Winbind Provides7.3. What Winbind Provides

    Winbind unifies UNIX and Windows NT account management by @@ -4641,8 +4894,8 @@ CLASS="SECT2" >


    Target Uses7.3.1. Target Uses

    Winbind is targeted at organizations that have an @@ -4665,8 +4918,8 @@ CLASS="SECT1" >


    How Winbind Works7.4. How Winbind Works

    The winbind system is designed around a client/server @@ -4685,8 +4938,8 @@ CLASS="SECT2" >


    Microsoft Remote Procedure Calls7.4.1. Microsoft Remote Procedure Calls

    Over the last two years, efforts have been underway @@ -4711,8 +4964,8 @@ CLASS="SECT2" >


    Name Service Switch7.4.2. Name Service Switch

    The Name Service Switch, or NSS, is a feature that is @@ -4790,8 +5043,8 @@ CLASS="SECT2" >


    Pluggable Authentication Modules7.4.3. Pluggable Authentication Modules

    Pluggable Authentication Modules, also known as PAM, @@ -4839,8 +5092,8 @@ CLASS="SECT2" >


    User and Group ID Allocation7.4.4. User and Group ID Allocation

    When a user or group is created under Windows NT @@ -4865,8 +5118,8 @@ CLASS="SECT2" >


    Result Caching7.4.5. Result Caching

    An active system can generate a lot of user and group @@ -4888,8 +5141,8 @@ CLASS="SECT1" >


    Installation and Configuration7.5. Installation and Configuration

    The easiest way to install winbind is by using the packages @@ -4919,8 +5172,8 @@ CLASS="SECT1" >


    Limitations7.6. Limitations

    Winbind has a number of limitations in its current @@ -4967,8 +5220,8 @@ CLASS="SECT1" >


    Conclusion7.7. Conclusion

    The winbind system, through the use of the Name Service @@ -4983,7 +5236,7 @@ NAME="AEN1138" CLASS="CHAPTER" >


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

    Viewing and changing UNIX permissions using the NT +NAME="AEN1192" +>8.1. Viewing and changing UNIX permissions using the NT security dialogs

    In Samba 2.0.4 and above the default value of the parameter


    How to view file security on a Samba share8.2. 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 PropertiesProperties 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 SecuritySecurity. Click on this tab and you - will see three buttons, PermissionsPermissions, - Auditing, and OwnershipAuditing, and Ownership. - The AuditingAuditing button will cause either an error message


    Viewing file ownership8.3. Viewing file ownership

    Clicking on the rootroot 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 @@ -5158,10 +5404,9 @@ CLASS="EMPHASIS" 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 permissions8.4. Viewing file or directory permissions

    The third button is the


    File Permissions8.4.1. File Permissions

    The standard UNIX user/group/world triple and @@ -5294,8 +5539,8 @@ CLASS="SECT2" >


    Directory Permissions8.4.2. Directory Permissions

    Directories on an NT NTFS file system have two @@ -5326,8 +5571,8 @@ CLASS="SECT1" >


    Modifying file or directory permissions8.5. Modifying file or directory permissions

    Modifying file and directory permissions is as simple @@ -5424,8 +5669,8 @@ CLASS="SECT1" >


    Interaction with the standard Samba create mask +NAME="AEN1290" +>8.6. Interaction with the standard Samba create mask parameters

    security mask - mask may be treated as a set of bits the user is notnot allowed to change, and one bits are those the user is allowed to change.


    Interaction with the standard Samba file attribute +NAME="AEN1354" +>8.7. Interaction with the standard Samba file attribute mapping


    Chapter 9. OS2 Client HOWTO

    FAQs9.1. FAQs

    How can I configure OS/2 Warp Connect or +NAME="AEN1377" +>9.1.1. 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), +NAME="AEN1392" +>9.1.2. 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 @@ -5864,8 +6117,8 @@ CLASS="SECT2" >


    Are there any other issues when OS/2 (any version) +NAME="AEN1401" +>9.1.3. Are there any other issues when OS/2 (any version) is used as a client?


    How do I get printer driver download working +NAME="AEN1405" +>9.1.4. How do I get printer driver download working for OS/2 clients?

    <nt driver name> = <os2 driver - name>.<device name>, e.g.: +><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.

    nmbd running would yield output similar to the following

    lmhosts is the is the Samba - NetBIOS name to IP address mapping file. It is very similar to the

    An example follows :

    #
    @@ -114,6 +119,9 @@ CLASS="PROGRAMLISTING"
     192.9.200.20	NTSERVER#20
     192.9.200.21	SAMBASERVER
     	

    Contains three IP to NetBIOS name mappings. The first diff --git a/docs/htmldocs/make_smbcodepage.1.html b/docs/htmldocs/make_smbcodepage.1.html index 456ea98b20..52eb12e527 100644 --- a/docs/htmldocs/make_smbcodepage.1.html +++ b/docs/htmldocs/make_smbcodepage.1.html @@ -202,7 +202,7 @@ NAME="AEN58" >

    codepage_def.<codepage>codepage_def.<codepage>

    These are the input (text) codepage files provided in the @@ -259,7 +259,7 @@ CLASS="COMMAND" >

    codepage.<codepage>codepage.<codepage> - These are the output (binary) codepage files produced and placed in the Samba destination smbd [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log file>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]

    [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log file>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]

    nmbd is a server that understands and can reply to NetBIOS over IP name service requests, like - those produced by SMBD/CIFS clients such as Windows 95/98/ME, + those produced by SMB/CIFS clients such as Windows 95/98/ME, Windows NT, Windows 2000, and LanManager clients. It also participates in the browsing protocols which make up the Windows "Network Neighborhood" view.

    -n-n
    option (see OPTIONS below). Thus .

    -H <filename>
    -H <filename>

    NetBIOS lmhosts file. The lmhosts @@ -194,18 +193,16 @@ CLASS="FILENAME" > to resolve any NetBIOS name queries needed by the server. Note - that the contents of this file are NOTNOT used by nmbd to answer any name queries. Adding a line to this file affects name NetBIOS resolution - from this host ONLYONLY.

    The default path to this file is compiled into @@ -242,7 +239,7 @@ CLASS="COMMAND" >.

    -d <debug level>
    -d <debug level>

    debuglevel is an integer @@ -278,7 +275,7 @@ CLASS="FILENAME" > file.

    -l <log file>
    -l <log file>

    The -l parameter specifies a path @@ -306,7 +303,7 @@ CLASS="FILENAME" >.

    -n <primary NetBIOS name>
    -n <primary NetBIOS name>

    This option allows you to override @@ -331,7 +328,7 @@ CLASS="FILENAME" >.

    -p <UDP port number>
    -p <UDP port number>

    UDP port number is a positive integer value. @@ -344,7 +341,7 @@ CLASS="COMMAND" won't need help!

    -s <configuration file>
    -s <configuration file>

    The default configuration file name @@ -484,9 +481,8 @@ CLASS="FILENAME" >If nmbd is acting as a browse master is acting as a browse master (see the nmbd process it is recommended - that SIGKILL (-9) NOTNOT be used, except as a last resort, as this may leave the name database in an inconsistent state. The correct way to terminate kill -USR1 - <nmbd-pid>) and lowered by sending it a SIGUSR2 (kill -USR2 <nmbd-pid>kill -USR2 <nmbd-pid>). This is to allow transient problems to be diagnosed, whilst still running at a normally low log level.

    nmblookup [-M] [-R] [-S] [-r] [-A] [-h] [-B <broadcast address>] [-U <unicast address>] [-d <debug level>] [-s <smb config file>] [-i <NetBIOS scope>] [-T] {name}

    [-M] [-R] [-S] [-r] [-A] [-h] [-B <broadcast address>] [-U <unicast address>] [-d <debug level>] [-s <smb config file>] [-i <NetBIOS scope>] [-T] {name}

    Print a help (usage) message.

    -B <broadcast address>
    -B <broadcast address>

    Send the query to the given broadcast address. Without @@ -179,7 +179,7 @@ CLASS="FILENAME"

    -U <unicast address>
    -U <unicast address>

    Do a unicast query to the specified address or @@ -198,7 +198,7 @@ CLASS="PARAMETER" query a WINS server.

    -d <debuglevel>
    -d <debuglevel>

    debuglevel is an integer from 0 to 10.

    file.

    -s <smb.conf>
    -s <smb.conf>

    This parameter specifies the pathname to @@ -246,7 +246,7 @@ TARGET="_top" the Samba setup on the machine.

    -i <scope>
    -i <scope>

    This specifies a NetBIOS scope that @@ -256,9 +256,8 @@ CLASS="COMMAND" > will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are - veryvery rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.

    IP address .... NetBIOS nameIP address .... NetBIOS name

    pair that is the normal output.

    This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified - by appending '#<type>' to the name. This name may also be + by appending '#<type>' to the name. This name may also be '*', which will return all registered names within a broadcast area.

    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:

    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.

    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 - Migration section of this document.


    Creating [print$]

    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).

    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 listwrite 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 pagesmb.conf(5) man page for more information on - configuring file shares.

    The requirement for guest ok = yesguest 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 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 - 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"
    -	
    [print$]----- + |-W32X86 ; "Windows NT x86" + |-WIN40 ; "Windows 95/98" + |-W32ALPHA ; "Windows NT Alpha_AXP" + |-W32MIPS ; "Windows NT R4000" + |-W32PPC ; "Windows NT PowerPC"

    WarningATTENTION! REQUIRED PERMISSIONS

    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 adminprinter + 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.


    Setting Drivers for Existing Printers

    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"
    @@ -396,44 +392,185 @@ Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
      
     [Windows NT x86]
     Printer Driver Info 1:
    -	Driver Name: [HP LaserJet 4000 Series PS]
    +     Driver Name: [HP LaserJet 4000 Series PS]
      
     Printer Driver Info 1:
    -	Driver Name: [HP LaserJet 2100 Series PS]
    +     Driver Name: [HP LaserJet 2100 Series PS]
      
     Printer Driver Info 1:
    -	Driver Name: [HP LaserJet 4Si/4SiMX PS]
    +     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:[]
    +     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.
    -		


    Adding New Printers via the Windows NT APW

    By default, Samba offers all printer shares defined in smb.conf +in the "Printers..." folder. Also existing in this folder is the Windows NT +Add Printer Wizard icon. The APW will be show only if

    • The connected user is able to successfully + execute an OpenPrinterEx(\\server) with administrative + priviledges (i.e. root or printer admin. +

    • show + add printer wizard = yes (the default). +

    In order to be able to use the APW to successfully add a printer to a Samba +server, the addprinter +command must have a defined value. The program +hook must successfully add the printer to the system (i.e. +/etc/printcap or appropriate files) and +smb.conf if necessary.

    When using the APW from a client, if the named printer share does +not exist, smbd will execute the add printer +program and reparse to the smb.conf +to attempt to locate the new printer share. If the share is still not defined, +an error of "Access Denied" is returned to the client. Note that the +add printer program is executed undet the context +of the connected user, not necessarily a root account.

    There is a complementing deleteprinter +command for removing entries from the "Printers..." +folder.


    Samba and Printer Ports

    Windows NT/2000 print servers associate a port with each printer. These normally +take the form of LPT1:, COM1:, FILE:, etc... Samba must also support the +concept of ports associated with a printer. By default, only one printer port, +named "Samba Printer Port", exists on a system. Samba does not really a port in +order to print, rather it is a requirement of Windows clients.

    Note that Samba does not support the concept of "Printer Pooling" internally +either. This is when a logical printer is assigned to multiple ports as +a form of load balancing or fail over.

    If you require that multiple ports be defined for some reason, +smb.conf possesses a enumports +command which can be used to define an external program +that generates a listing of ports on a system.


    The Imprints Toolset


    What is Imprints?


    Creating Printer Driver Packages


    The Imprints server


    The Installation Client

    	
    -		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
    -		}
    +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 @@ -615,7 +751,7 @@ CLASS="SECT1" >


    WarningAchtung!

    If you want to migrate an existing printers.def file into the new setup, the current only +>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 smbclient + and rpcclient. See the + Imprints installation client at Imprints insrallation client for an example. +>http://imprints.sourceforge.net/ + for an example.

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

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

    		username = <value> 
    -		password = <value>
    -		domain   = <value>
    +>		username = <value> 
    +		password = <value>
    +		domain   = <value>
     		

    Make certain that the permissions on the file restrict @@ -248,9 +257,8 @@ NAME="AEN91" >

    COMMANDS

    LSARPCLSARPC

    SAMRSAMR

    SPOOLSSSPOOLSS

    adddriver <arch> <config>adddriver <arch> <config> - Execute an AddPrinterDriver() RPC to install the printer driver information on the server. Note that the driver files should @@ -364,6 +370,12 @@ CLASS="PARAMETER" > parameter is defined as follows:

    		Long Printer Name:\
    @@ -375,6 +387,9 @@ CLASS="PROGRAMLISTING"
     		Default Data Type:\
     		Comma Separated list of Files
     		

    Any empty fields should be enter as the string "NULL".

    addprinter <printername> - <sharename> <drivername> <port>addprinter <printername> + <sharename> <drivername> <port> - Add a printer on the remote server. This printer will be automatically shared. Be aware that the printer driver @@ -426,7 +441,7 @@ CLASS="COMMAND" >

    enumjobs <printer>enumjobs <printer> - List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() @@ -468,7 +483,7 @@ CLASS="COMMAND" >

    getdata <printername>getdata <printername> - Retrieve the data for a given printer setting. See the

    getdriver <printername>getdriver <printername> - Retrieve the printer driver information (such as driver file, config file, dependent files, etc...) for @@ -494,7 +509,7 @@ CLASS="COMMAND" >

    getdriverdir <arch>getdriverdir <arch> - Execute a GetPrinterDriverDirectory() RPC to retreive the SMB share name and subdirectory for @@ -512,7 +527,7 @@ CLASS="PARAMETER" >

    getprinter <printername>getprinter <printername> - Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function. @@ -522,7 +537,7 @@ CLASS="COMMAND" >

    openprinter <printername>openprinter <printername> - Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer.

    setdriver <printername> <drivername>setdriver <printername> <drivername> - Execute a SetPrinter() command to update the printer driver associated with an installed printer. The printer driver must already be correctly @@ -549,9 +564,8 @@ CLASS="COMMAND" >

    GENERAL OPTIONSGENERAL OPTIONS

    From Luke Leighton's original rpcclient man page:

    "WARNING!"WARNING! The MSRPC over SMB code has been developed from examining Network traces. No documentation is available from the original creators (Microsoft) on how MSRPC over diff --git a/docs/htmldocs/smb.conf.5.html b/docs/htmldocs/smb.conf.5.html index 2197fe195f..0f8a83a939 100644 --- a/docs/htmldocs/smb.conf.5.html +++ b/docs/htmldocs/smb.conf.5.html @@ -123,9 +123,8 @@ NAME="AEN28" >

    There are three special sections, [global], [homes] and [printers], which are - described under special sectionsspecial sections. The following notes apply to ordinary section descriptions.

    Sections may be designated guestSections may be designated guest services, in which case no password is required to access them. A specified - UNIX guest accountguest account is used to define access privileges in this case.

    /home/bar. The share is accessed via the share name "foo":

    	
     	

    The following sample section defines a printable share. The share is readonly, but printable. That is, the only write access permitted is via calls to open, write to and close a - spool file. The guest okguest ok parameter means access will be permitted as the default guest user (specified elsewhere):

    	
     	

    If you decide to use a path=If you decide to use a path= line in your [homes] section then you may find it useful to use the %S macro. For example :

    		
     		

    An important point is that if guest access is specified in the [homes] section, all home directories will be - visible to all clients without a passwordwithout a password. In the very unlikely event that this is actually desirable, it - would be wise to also specify read only - access.

    Note that the browseableNote that the browseable flag for auto home directories will be inherited from the global browseable flag, not the [homes] browseable flag. This is useful as @@ -376,6 +395,12 @@ NAME="AEN78" world-writeable spool directory with the sticky bit set on it. A typical [printers] entry would look like this:

    All aliases given for a printer in the printcap file are legitimate printer names as far as the server is concerned. If your printing subsystem doesn't work like that, you will have to set up a pseudo-printcap. This is a file consisting of one or more lines like this:

    		
     		

    Each alias should be an acceptable printer name for your printing subsystem. In the [global] section, specify @@ -431,29 +468,24 @@ NAME="AEN101" >parameters define the specific attributes of sections.

    Some parameters are specific to the [global] section - (e.g., securitysecurity). Some parameters are usable - in all sections (e.g., create modecreate mode). All others are permissible only in normal sections. For the purposes of the following descriptions the [homes] and [printers] - sections will be considered normal. The letter GG in parentheses indicates that a parameter is specific to the - [global] section. The letter SS indicates that a parameter can be specified in a service specific - section. Note that all SS parameters can also be specified in the [global] section - in which case they will define the default behavior for all services.

    the name of your NIS home directory server. This is obtained from your NIS auto.map entry. If you have - not compiled Samba with the --with-automount--with-automount option then this value will be the same as %.

    controls if names that have characters that aren't of the "default" case are mangled. For example, if this is yes then a name like "Mail" would be mangled. - Default nono.

    controls whether filenames are case sensitive. If they aren't then Samba must do a filename search and match on passed - names. Default nono.

    controls what the default case is for new - filenames. Default lowerlower.

    controls if new files are created with the case that the client passes, or if they are forced to be the - "default" case. Default yesyes.

    yesyes.

    This is the full pathname to a script that will - be run AS ROOTAS ROOT by smbd to create the required UNIX users - ON DEMANDON DEMAND when a user accesses the Samba server.

    In order to use this option, smbd will - call the specified script AS ROOTAS ROOT, expanding any

    Default: add user script = <empty string> +>add user script = <empty string>

    Default: noneDefault: none

    Example:

    Default: no admin usersDefault: no admin users

    Example: available = no, then ALL, then ALL attempts to connect to the service will fail. Such failures are logged.

    bind interfaces only is set then - unless the network address 127.0.0.1127.0.0.1 is added to the smbpasswd - by default connects to the localhost - 127.0.0.1localhost - 127.0.0.1 address as an SMB client to issue the password change request. If bind interfaces only is set then unless the - network address 127.0.0.1127.0.0.1 is added to the nmbd at the address - 127.0.0.1127.0.0.1 to determine if they are running. - Not adding 127.0.0.1127.0.0.1 will cause smbdclient code page - MUSTMUST be set to code page 850 if the client code page MUST MUST be set to code page 852 if the client code page MUST MUST be set to code page 866 if the client code page MUST MUST be set to code page 737 if the client code page MUST MUST be set to code page 866 if the

    BUGBUG. These MSDOS code page to UNIX character set mappings should be dynamic, like the loading of MS DOS code pages, not static.

    Default: character set = <empty string>character set = <empty string>

    Example: client code page parameter - MUSTMUST be set before the

    Default: coding system = <empty value>coding system = <empty value>

    parameter.

    Default: No comment stringDefault: No comment string

    Example:

    Default: no valueDefault: no value

    Example: notnot set here will be removed from the modes set on a file when it is created.

    This parameter specifies the name of a service which will be connected to if the service actually requested cannot - be found. Note that the square brackets are NOTNOT given in the parameter value (see example below).

    Example:

    [global]
    @@ -6023,6 +6033,9 @@ CLASS="PROGRAMLISTING"
     [pub]
     	path = /%S
     		

    This is the full pathname to a script that will - be run AS ROOTAS ROOT by smbd to delete the required UNIX users to delete the required UNIX users ON - DEMAND when a user accesses the Samba server and the Windows NT user no longer exists.

    , which expands into the UNIX user name to delete. - NOTENOTE that this is different to the

    When the Windows user attempts to access the Samba server, - at loginlogin (session setup in the SMB protocol) time, smbd will all the specified script - AS ROOTAS ROOT, expanding any

    Default: delete user script = <empty string> +>delete user script = <empty string>

    Default: noneDefault: none

    Example:

    Note: Your script should NOTNote: Your script should NOT be setuid or setgid and should be owned by (and writeable only by) root!

    Default: Default: By default internal routines for determining the disk capacity and remaining space will be used. -

    Example:

    Where the script dfree (which must be made executable) could be:

     
     		#!/bin/sh
     		df $1 | tail -1 | awk '{print $2" "$4}'
     		

    or perhaps (on Sys V based systems):

     
     		#!/bin/sh
     		/usr/bin/df -k $1 | tail -1 | awk '{print $3" "$5}'
     		

    Note that you may have to replace the command names @@ -6505,9 +6528,8 @@ NAME="DIRECTORYMASK" calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may be thought of as a bit-wise MASK for - the UNIX modes of a directory. Any bit notnot set here will be removed from the modes set on a directory when it is created.

    NoteNote that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone "appliance" systems. @@ -6670,8 +6691,8 @@ CLASS="PARAMETER" >

    Default: directory security mask = <same as - directory mask>directory security mask = <same as + directory mask>

    Example: domain admin group (G)

    This is an EXPERIMENTALThis is an EXPERIMENTAL parameter that is part of the unfinished Samba NT Domain Controller Code. It may be removed in a later release. To work with the latest code builds @@ -6754,9 +6774,8 @@ NAME="DOMAINADMINUSERS" >domain admin users (G)

    This is an EXPERIMENTALThis is an EXPERIMENTAL parameter that is part of the unfinished Samba NT Domain Controller Code. It may be removed in a later release. To work with the latest code builds @@ -6779,9 +6798,8 @@ NAME="DOMAINGROUPS" >domain groups (G)

    This is an EXPERIMENTALThis is an EXPERIMENTAL parameter that is part of the unfinished Samba NT Domain Controller Code. It may be removed in a later release. To work with the latest code builds @@ -6804,9 +6822,8 @@ NAME="DOMAINGUESTGROUP" >domain guest group (G)

    This is an EXPERIMENTALThis is an EXPERIMENTAL parameter that is part of the unfinished Samba NT Domain Controller Code. It may be removed in a later release. To work with the latest code builds @@ -6829,9 +6846,8 @@ NAME="DOMAINGUESTUSERS" >domain guest users (G)

    This is an EXPERIMENTALThis is an EXPERIMENTAL parameter that is part of the unfinished Samba NT Domain Controller Code. It may be removed in a later release. To work with the latest code builds @@ -7015,10 +7031,9 @@ CLASS="FILENAME" >. Experimentation is the best policy :-)

    Default: Default: none (i.e., all directories are OK - to descend)

    Example: 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 @@ -7240,9 +7254,8 @@ CLASS="PARAMETER" to standard output. This listing will then be used in response to the level 1 and 2 EnumPorts() RPC.

    Default: no enumports commandDefault: no enumports command

    Example:

    This parameter specifies a set of UNIX mode bit - permissions that will alwaysalways be set on a 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 @@ -7468,9 +7480,8 @@ NAME="FORCEDIRECTORYMODE" >

    This parameter specifies a set of UNIX mode bit - permissions that will alwaysalways be set on a directory created by Samba. This is done by bitwise 'OR'ing these bits onto the mode bits of a directory that is being created. The default for this @@ -7551,9 +7562,8 @@ CLASS="PARAMETER" a user to modify all the user/group/world permissions on a directory without restrictions, set this parameter to 000.

    NoteNote that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone "appliance" systems. @@ -7590,8 +7600,8 @@ CLASS="PARAMETER" >

    Default: force directory security mode = <same as - force directory mode>force directory security mode = <same as + force directory mode>

    Example: .

    Default: no forced groupDefault: no forced group

    Example:

    NoteNote that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone "appliance" systems. @@ -7745,8 +7753,8 @@ CLASS="PARAMETER" >

    Default: force security mode = <same as force - create mode>force security mode = <same as force + create mode>

    Example:

    Default: no forced userDefault: no forced user

    Example: lp(1).

    Default: Default: specified at compile time, usually - "nobody"

    Example: .

    Default: no file are hiddenDefault: no file are hidden

    Example:

    NOTE :NOTE :A working NIS client is required on the system for this option to work.

    Default: homedir map = <empty string>homedir map = <empty string>

    Example:

    You can also specify hosts by network/netmask pairs and by netgroup names if your system supports netgroups. The - EXCEPTEXCEPT keyword can also be used to limit a wildcard list. The following examples may provide some help:

    for a way of testing your host access to see if it does what you expect.

    Default: Default: none (i.e., all hosts permitted access) -

    Example: hosts allow - - hosts listed here are NOTNOT permitted access to services unless the specific services have their own lists to override this one. Where the lists conflict, the list takes precedence.

    Default: Default: none (i.e., no hosts specifically excluded) -

    Example: may be useful for NT clients which will not supply passwords to samba.

    NOTE :NOTE : The use of option be only used if you really know what you are doing, or perhaps on a home network where you trust - your spouse and kids. And only if you reallyreally trust them :-).

    Default: no host equivalencesDefault: no host equivalences

    Example: .

    Default: no file includedDefault: no file included

    Example: as usual.

    Note that the setuid bit is neverNote that the setuid bit is never set via inheritance (the code explicitly prohibits this).

    .

    Default: Default: all active interfaces except 127.0.0.1 - that are broadcast capable

    This is a list of users that should not be allowed - to login to this service. This is really a paranoidparanoid check to absolutely ensure an improper setting does not breach your security.

    +&group+&group means check the UNIX group database, followed by the NIS netgroup database, and @@ -8761,9 +8754,8 @@ CLASS="PARAMETER" >.

    Default: no invalid usersDefault: no invalid users

    Example: has oplocked. This allows complete data consistency between - SMB/CIFS, NFS and local file access (and is a veryvery cool feature :-).

    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 - mean that Samba will becomebecome the local master browser on a subnet, just that nmbd will participate will participate in elections for local master browser.

    Setting this value to False will cause nmbd - nevernever to become a local master browser.

    Default: , real locking will be performed by the server.

    This option mayThis option may be useful for read-only - filesystems which maymay not need locking (such as cdrom drives), although setting this parameter of Thereafter, the directories and any of the contents can, if required, be made read-only. It is not advisable that the NTuser.dat file be made read-only - rename it to NTuser.man to - achieve the desired effect (a MANMANdatory profile).

    This option is only useful if Samba is set up as a logon server.

    Default: no logon script definedDefault: no logon script defined

    Example: parameter.

    Default: Default: depends on the setting of printing

    Example: parameter.

    Default: Default: depends on the setting of printing

    Example 1:

    Default: magic output = <magic script name>.out +>magic output = <magic script name>.out

    Note that some shells are unable to interpret scripts containing CR/LF instead of CR as the end-of-line marker. Magic scripts must be executable - as isas is on the host, which for some hosts and some shells will require filtering at the DOS end.

    Magic scripts are EXPERIMENTALMagic scripts are EXPERIMENTAL and - should NOTNOT be relied upon.

    Default: None. Magic scripts disabled.Default: None. Magic scripts disabled.

    Example: off the ends of filenames on some CDROMS (only visible under some UNIXes). To do this use a map of (*;1 *;).

    Default: no mangled mapDefault: no mangled map

    Example:

    This controls what character is used as - the magicmagic character in name manglinghatehate you if you set the modes other than share. This is because in these modes the name of the resource being - requested is notnot sent to the server until after the server has successfully authenticated the client so the server cannot make authentication decisions at the correct time (connection @@ -10805,9 +10779,8 @@ CLASS="CONSTANT" >LANMAN1: First modern: First modern version of the protocol. Long filename support.

    xedit, then - removes it afterwards. NOTE THAT IT IS VERY IMPORTANT - THAT THIS COMMAND RETURN IMMEDIATELY. That's why I have the '&' on the end. If it doesn't return immediately then your PCs may freeze when sending messages (they should recover @@ -11075,7 +11047,7 @@ CLASS="PARAMETER" >message command = /bin/mail -s 'message from %f on - %m' root < %s; rm %s

    If you don't have a message command then the message @@ -11091,9 +11063,8 @@ CLASS="COMMAND" >message command = rm %s

    Default: no message commandDefault: no message command

    Example: .

    Default: empty string (no additional names)Default: empty string (no additional names)

    Example: .

    Default: machine DNS nameDefault: machine DNS name

    Example:

    DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ - AND UNDERSTOOD THE SAMBA OPLOCK CODE.

    Default: oplock contention limit (S)

    This is a veryThis is a very advanced to behave in a similar way to Windows NT.

    DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ - AND UNDERSTOOD THE SAMBA OPLOCK CODE.

    Default: in the local broadcast area.

    Note :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 @@ -11955,8 +11920,8 @@ NAME="OS2DRIVERMAP" 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>

    <nt driver name> = <os2 driver + name>.<device name>

    For example, a valid entry using the HP LaserJet 5 printer driver woudl appear as

    Default: os2 driver map = <empty string> +>os2 driver map = <empty string>

    Default: panic action = <empty string>panic action = <empty string>

    Example: passwd chat (G)

    This string controls the "chat"This string controls the "chat" conversation that takes places between parameter is set to true, then this - sequence is called AS ROOTAS ROOT when the SMB password in the smbpasswd file is being changed, without access to the old password cleartext. In this case the old password cleartext is set @@ -12157,9 +12120,8 @@ NAME="PASSWDCHATDEBUG" >

    This boolean specifies if the passwd chat script - parameter is run in debugdebug mode. In this mode the strings passed to and received from the passwd chat are printed in the

    Also note that many passwd programs insist in Also note that many passwd programs insist in reasonable - passwords, such as a minimum length, or the inclusion of mixed case chars and digits. This can pose a problem as some clients (such as Windows for Workgroups) uppercase the password before sending it.

    NoteNote that if the True then this program is called AS ROOT then this program is called AS ROOT before the SMB password in the unix password sync parameter - is set this parameter MUST USE ABSOLUTE PATHSMUST USE ABSOLUTE PATHS - for ALLALL programs called, and must be examined for security implications. Note that by default

    NOTE:NOTE: Using a password server means your UNIX box (running Samba) is only as secure as your - password server. DO NOT CHOOSE A PASSWORD SERVER THAT - YOU DON'T COMPLETELY TRUST.

    Never point a Samba server at itself for password @@ -12492,7 +12447,7 @@ CLASS="PARAMETER" Primary or Backup Domain controllers to authenticate against by doing a query for the name WORKGROUP<1C>WORKGROUP<1C> and then contacting each server returned in the list of IP addresses from the name resolution source.

    Default: password server = <empty string>password server = <empty string>

    if one was specified.

    Default: noneDefault: none

    Example: .

    Default: none (no command executed)Default: none (no command executed)

    Example: postexec = echo \"%u disconnected from %S - from %m (%I)\" >> /tmp/log

    .

    Default: none (no command executed)Default: none (no command executed)

    Example: preexec = echo \"%u connected to %S from %m - (%I)\" >> /tmp/log

    option is easier.

    Default: no preloaded servicesDefault: no preloaded services

    Example:

    The print command MUSTThe print command MUST contain at least one occurrence of

    print command = echo Printing %s >> +>print command = echo Printing %s >> /tmp/print.log; lpr -P %p %s; rm %s

    A minimal printcap file would look something like this:

    		print1|My Printer 1
    @@ -13218,15 +13174,17 @@ CLASS="PROGRAMLISTING"
     		print4|My Printer 4
     		print5|My Printer 5
     		

    where the '|' separates aliases of a printer. The fact that the second alias has a space in it gives a hint to Samba that it's a comment.

    NOTENOTE: Under AIX the default printcap name is

    Default: printer admin = <empty string>printer admin = <empty string>

    printer driver (S)

    Note :Note :This is a depreciated parameter and will be removed in the next major release following version 2.2. Please see the instructions in @@ -13342,9 +13299,8 @@ NAME="PRINTERDRIVERFILE" >printer driver file (G)

    Note :Note :This is a depreciated parameter and will be removed in the next major release following version 2.2. Please see the instructions in @@ -13399,9 +13355,8 @@ CLASS="PARAMETER" >.

    Default: None (set in compile).Default: None (set in compile).

    Example: printer driver location (S)

    Note :Note :This is a depreciated parameter and will be removed in the next major release following version 2.2. Please see the instructions in @@ -13490,13 +13444,12 @@ NAME="PRINTERNAME" name given will be used for any printable service that does not have its own printer name specified.

    Default: Default: none (but may be lp - on many systems)

    Example:

    Default: Default: depends on the setting of printing

    Example:

    Default: Default: depends on the setting of printing

    Default: read list = <empty string>read list = <empty string>

    Example:

    Default: remote announce = <empty string> +>remote announce = <empty string>

    Default: remote browse sync = <empty string> +>remote browse sync = <empty string>

    root directory - option, includingincluding some files needed for complete operation of the server. To maintain full operability of the server you will need to mirror some system files @@ -14206,7 +14156,7 @@ CLASS="PARAMETER" >

    Default: root postexec = <empty string> +>root postexec = <empty string>

    Default: root preexec = <empty string> +>root preexec = <empty string>

    It is possible to use smbd in a hybrid mode in a hybrid mode where it is offers both user and share level security under different SECURITY = SHARE -

    When clients connect to a share level security server then @@ -14422,9 +14370,8 @@ CLASS="COMMAND" >Note that smbd ALWAYS ALWAYS uses a valid UNIX user to act on behalf of the client, even in

  • If the client did a previous If the client did a previous logon - request (the SessionSetup SMB call) then the username sent in this SMB will be added as a potential username.

    , then this guest user will be used, otherwise access is denied.

    Note that it can be veryNote that it can be very confusing in share-level security as to which UNIX username will eventually be used in granting access.

    SECURIYT = USER -

    This is the default security setting in Samba 2.2. @@ -14603,13 +14547,11 @@ CLASS="PARAMETER" may change the UNIX user to use on this connection, but only after the user has been successfully authenticated.

    NoteNote that the name of the resource being - requested is notnot sent to the server until after the server has successfully authenticated the client. This is why guest shares don't work in user level security without allowing @@ -14641,10 +14583,9 @@ HREF="#AEN234" >SECURITY = SERVER -

    In this mode Samba will try to validate the username/password @@ -14669,9 +14610,8 @@ CLASS="FILENAME" > for details on how to set this up.

    NoteNote that from the clients point of view

    NoteNote that the name of the resource being - requested is notnot sent to the server until after the server has successfully authenticated the client. This is why guest shares don't work in user level security without allowing @@ -14741,10 +14679,9 @@ CLASS="PARAMETER" >SECURITY = DOMAIN -

    This mode will only work correctly if

    NoteNote that a valid UNIX user must still exist as well as the account on the Domain Controller to allow Samba to have a valid UNIX account to map file access to.

    NoteNote that from the clients point of view . It only affects how the server deals with the authentication, it does not in any way affect what the client sees.

    NoteNote that the name of the resource being - requested is notnot sent to the server until after the server has successfully authenticated the client. This is why guest shares don't work in user level security without allowing @@ -14820,9 +14753,8 @@ CLASS="PARAMETER" parameter for details on doing this.

    BUG:BUG: There is currently a bug in the implementation of

    NoteNote that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone @@ -14940,7 +14871,7 @@ CLASS="PARAMETER" >

    Default: security mask = <same as create mask> +>security mask = <same as create mask>

    This option gives full share compatibility and enabled by default.

    You should NEVERYou should NEVER turn this parameter off as many Windows applications will break if you do so.

    parameter will always cause the OpenPrinterEx() on the server - to fail. Thus the APW icon will never be displayed. Note : Note :This does not prevent the same user from having administrative privilege on an individual printer.

  • Those marked with a '*'Those marked with a '*' take an integer argument. The others can optionally take a 1 or 0 argument to enable or disable the option, by default they will be enabled if you @@ -15394,9 +15322,8 @@ CLASS="COMMAND" >SAMBA_NETBIOS_NAME=myhostname

    Default: No default valueDefault: No default value

    Examples: was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    Default: ssl hosts = <empty string>ssl hosts = <empty string>

    ssl hosts resign = <empty string>ssl hosts resign = <empty string>

    Example: was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    no, clients don't need certificates. - Contrary to web applications you really shouldshould require client certificates. In the web environment the client's data is sensitive (credit card numbers) and the server must prove @@ -15877,13 +15785,11 @@ CLASS="COMMAND" > was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    This is the file containing the server's certificate. - The server mustmust have a certificate. The file may also contain the server's private key. See later for how certificates and private keys are created.

    Default: ssl server cert = <empty string> +>ssl server cert = <empty string>

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    This file contains the private key of the server. If this variable is not defined, the key is looked up in the certificate file (it may be appended to the certificate). - The server mustmust have a private key - and the certificate mustmust match this private key.

    Default: ssl server key = <empty string> +>ssl server key = <empty string>

    was given at configure time.

    NoteNote that for export control reasons - this code is NOTNOT enabled by default in any current binary version of Samba.

    template homedir (G)

    NOTE:NOTE: this parameter is only available in Samba 3.0.

    template shell (G)

    NOTE:NOTE: this parameter is only available in Samba 3.0.

    passwd programparameter is called AS ROOTparameter is called AS ROOT - to allow the new UNIX password to be set without access to the old UNIX password (as the SMB password has change code has no @@ -16581,9 +16475,8 @@ CLASS="FILENAME" will be read to find the names of hosts and users who will be allowed access without specifying a password.

    NOTE:NOTE: The use of Default: The guest account if a guest service, - else <empty string>.

    Examples:

    		!sys = mary fred
     		guest = *
     		

    Note that the remapping is applied to all occurrences @@ -16906,9 +16808,8 @@ CLASS="PARAMETER" trouble deleting print jobs as PrintManager under WfWg will think they don't own the print job.

    Default: no username mapDefault: no username map

    Example: /var/run/utmp on Linux).

    Default: no utmp directoryDefault: no utmp directory

    		valid chars = Z
     		valid chars = z:Z
     		valid chars = 0132:0172
     		

    The last two examples above actually add two characters, and alter the uppercase and lowercase mappings appropriately.

    Note that you MUSTNote that you MUST specify this parameter after the parameter.

    Default: Default: Samba defaults to using a reasonable set - of valid characters for English systems

    Example: The above example allows filenames to have the Swedish characters in them.

    NOTE:NOTE: It is actually quite difficult to correctly produce a

    Default: Default: No valid users list (anyone can login) -

    Example:

    Each entry must be a unix path, not a DOS path and - must notnot include the unix directory separator '/'.

    are automatically deletedare automatically deleted along with it, if the user has UNIX permissions to do so.

    .

    Default: Default: No files or directories are vetoed. -

    Examples:

    Examples:
    	   ; Veto any files containing the word Security, 
         	; any ending in .tmp, and any directory containing the
    @@ -17240,6 +17148,9 @@ CLASS="PROGRAMLISTING"
         	; creates.
     		veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/
     		

    parameter.

    Default: Default: No files are vetoed for oplock - grants

    You might want to do this on files that you know will @@ -17308,9 +17218,8 @@ NAME="VFSOBJECT" 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 valueDefault : no value

    .

    Default : no valueDefault : no value

    Default: the name of the shareDefault: the name of the share

    winbind cache time

    NOTE:NOTE: this parameter is only available in Samba 3.0.

    winbind gid

    NOTE:NOTE: this parameter is only available in Samba 3.0.

    Default: winbind gid = <empty string> +>winbind gid = <empty string>

    winbind separator

    NOTE:NOTE: this parameter is only available in Samba 3.0.

    winbind uid

    NOTE:NOTE: this parameter is only available in Samba 3.0.

    Default: winbind uid = <empty string> +>winbind uid = <empty string>

    You should point this at your WINS server if you have a multi-subnetted network.

    NOTENOTE. 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.

    in the docs/ directory of your Samba source distribution.

    Default: not enabledDefault: not enabled

    Example: nmbd to be your WINS server. - Note that you should NEVERNEVER set this to true on more than one machine in your network.

    setting.

    Default: set at compile time to WORKGROUPDefault: set at compile time to WORKGROUP

    Example:

    If this integer parameter is set to non-zero value, Samba will create an in-memory cache for each oplocked file - (it does notnot 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. @@ -17796,7 +17694,7 @@ CLASS="PARAMETER" >

    Default: write list = <empty string> +>write list = <empty string>

    printable = yes) - will ALWAYSALWAYS allow writing to the directory (user privileges permitting), but only via spooling operations.

    The format of an ACL is one or more ACL entries separated by either commas or newlines. An ACL entry is one of the following:

     
    -REVISION:<revision number>
    -OWNER:<sid or name>
    -GROUP:<sid or name>
    -ACL:<sid or name>:<type>/<flags>/<mask>
    +REVISION:<revision number>
    +OWNER:<sid or name>
    +GROUP:<sid or name>
    +ACL:<sid or name>:<type>/<flags>/<mask>
     	

    The revision of the ACL specifies the internal Windows @@ -247,44 +256,38 @@ ACL:<sid or name>:<type>/<flags>/<mask> >

    • RR - Allow read access

    • WW - Allow write access

    • XX - Execute permission on the object

    • DD - Delete the object

    • PP - Change permissions

    • OO - Take ownership

    • READREAD - Equivalent to 'RX' permissions

    • CHANGECHANGE - Equivalent to 'RXWD' permissions

    • FULLFULL - Equivalent to 'RWXDPO' permissions

    • smbclient {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]

      {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]

    -R <name resolve order>
    -R <name resolve order>

    This option is used by the programs in the Samba @@ -339,9 +339,8 @@ CLASS="FILENAME" > for a description of how to handle incoming WinPopup messages in Samba.

    NoteNote: Copy WinPopup into the startup group on your WfWg PCs if you want them to always be able to receive messages.

    This specifies a NetBIOS scope that smbclient will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. - NetBIOS scopes are veryvery rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.

    all - debug messages will be printed. This setting - is for developers only (and people who reallyreally want to know how the code works internally).

    username = <value> 
    -password = <value>
    +>username = <value> 
    +password = <value>
     		

    Make certain that the permissions on the file restrict @@ -597,12 +602,10 @@ CLASS="PARAMETER" >This option tells smbclient how to interpret filenames coming from the remote server. Usually Asian language multibyte UNIX implementations use different character sets than - SMB/CIFS servers (EUC instead of SJISEUC instead of SJIS for example). Setting this parameter will let

    Tar Long File NamesTar Long File Names

    Tar FilenamesTar Filenames

    All file names can be given as DOS path names (with '\' as the component separator) or as UNIX path names (with '/' as the component separator).

    ExamplesExamples

    Restore from tar file backup.tar into myshare on mypc @@ -941,7 +941,7 @@ NAME="AEN297" >

    smb:\> smb:\>

    The backslash ("\") indicates the current working directory @@ -961,7 +961,7 @@ CLASS="PROMPT" >

    Parameters shown in square brackets (e.g., "[parameter]") are optional. If not given, the command will use suitable defaults. Parameters - shown in angle brackets (e.g., "<parameter>") are required. + shown in angle brackets (e.g., "<parameter>") are required.

    Note that all commands operating on the server are actually @@ -1006,7 +1006,7 @@ CLASS="VARIABLELIST" directory on the server will be reported.

    del <mask>
    del <mask>

    The client will request that the server attempt @@ -1014,7 +1014,7 @@ CLASS="VARIABLELIST" directory on the server.

    dir <mask>
    dir <mask>

    A list of the files matching "mask" in the current @@ -1029,7 +1029,7 @@ CLASS="VARIABLELIST" from the program.

    get <remote file name> [local file name]
    get <remote file name> [local file name]

    Copy the file called "remote file name" from @@ -1073,13 +1073,13 @@ CLASS="COMMAND" lowercase filenames are the norm on UNIX systems.

    ls <mask>
    ls <mask>

    See the dir command above.

    mask <mask>
    mask <mask>

    This command allows the user to set up a mask @@ -1105,13 +1105,13 @@ CLASS="COMMAND" mask back to "*" after using the mget or mput commands.

    md <directory name>
    md <directory name>

    See the mkdir command.

    mget <mask>
    mget <mask>

    Copy all files matching mask from the server to @@ -1123,14 +1123,14 @@ CLASS="COMMAND" smbclient are binary. See also the lowercase command.

    mkdir <directory name>
    mkdir <directory name>

    Create a new directory on the server (user access privileges permitting) with the specified name.

    mput <mask>
    mput <mask>

    Copy all files matching mask in the current working @@ -1143,7 +1143,7 @@ CLASS="COMMAND" are binary.

    print <file name>
    print <file name>

    Print the specified file from the local machine @@ -1152,7 +1152,7 @@ CLASS="COMMAND" >See also the printmode command.

    printmode <graphics or text>
    printmode <graphics or text>

    Set the print mode to suit either binary data @@ -1172,7 +1172,7 @@ CLASS="COMMAND"

    put <local file name> [remote file name]
    put <local file name> [remote file name]

    Copy the file called "local file name" from the @@ -1195,7 +1195,7 @@ CLASS="COMMAND" >See the exit command.

    rd <directory name>
    rd <directory name>

    See the rmdir command.

    rm <mask>
    rm <mask>

    Remove all files matching mask from the current working directory on the server.

    rmdir <directory name>
    rmdir <directory name>

    Remove the specified directory (user access privileges permitting) from the server.

    tar <c|x>[IXbgNa]
    tar <c|x>[IXbgNa]

    Performs a tar operation - see the

    blocksize <blocksize>
    blocksize <blocksize>

    Blocksize. Must be followed by a valid (greater @@ -1258,7 +1258,7 @@ CLASS="PARAMETER" blocksize*TBLOCK (usually 512 byte) blocks.

    tarmode <full|inc|reset|noreset>
    tarmode <full|inc|reset|noreset>

    Changes tar's behavior with regard to archive @@ -1269,7 +1269,7 @@ CLASS="PARAMETER" read/write share).

    setmode <filename> <perm=[+|\-]rsha>
    setmode <filename> <perm=[+|\-]rsha>

    A version of the DOS attrib command to set @@ -1355,9 +1355,8 @@ CLASS="FILENAME" > /usr/samba/bin/ directory, this directory readable by all, writeable only by root. The client program itself should - be executable by all. The client should NOTNOT be setuid or setgid!

    smbd [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-l <log file>] [-p <port number>] [-O <socket option>] [-s <configuration file>]

    [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-l <log file>] [-p <port number>] [-O <socket option>] [-s <configuration file>]

    .

    -d <debug level>
    -d <debug level>

    debuglevel is an integer @@ -214,12 +214,11 @@ CLASS="FILENAME" > file.

    -l <log file>
    -l <log file>

    If specified, log fileIf specified, log file specifies a log filename into which informational and debug messages from the running server will be logged. The log @@ -240,7 +239,7 @@ CLASS="FILENAME" file name is specified at compile time.

    -O <socket options>
    -O <socket options>

    See the file for details.

    -p <port number>
    -p <port number>

    port number is a positive integer @@ -285,7 +284,7 @@ CLASS="FILENAME" in the above situation.

    -s <configuration file>
    -s <configuration file>

    The file specified contains the @@ -574,14 +573,12 @@ NAME="AEN179" >RUNNING THE SERVER AS A DAEMON

    To run the server as a daemon from the command - line, simply put the -D-D option on the command line. There is no need to place an ampersand at - the end of the command line - the -D-D option causes the server to detach itself from the tty anyway.

    If the options used at compile time are appropriate for - your system, all parameters except -D-D may be omitted. See the section OPTIONS above.

    Lastly, edit the configuration file to provide suitable services. To start with, the following two services should be all you need:

    	
     	

    This will allow you to connect to your home directory and print to any printer supported by the host (user privileges @@ -848,9 +853,8 @@ CLASS="FILENAME" that SIGKILL (-9) NOT NOT be used, except as a last resort, as this may leave the shared memory area in an inconsistent state. The safe way to terminate @@ -860,11 +864,11 @@ CLASS="EMPHASIS" >The debug log level of smbd may be raised by sending it a SIGUSR1 (kill -USR1 <smbd-pid>kill -USR1 <smbd-pid>) and lowered by sending it a SIGUSR2 (kill -USR2 <smbd-pid> +>kill -USR2 <smbd-pid> ). This is to allow transient problems to be diagnosed, whilst still running at a normally low log level.

    smbmnt {mount-point} [-s <share>] [-r] [-u <uid>] [-g <gid>] [-f <mask>] [-d <mask>] [-o <options>]

    {mount-point} [-s <share>] [-r] [-u <uid>] [-g <gid>] [-f <mask>] [-d <mask>] [-o <options>]

    NOTE:NOTE: smbmount

    username=<arg>
    username=<arg>

    specifies the username to connect as. If @@ -115,7 +114,7 @@ CLASS="ENVAR" to be specified as part of the username.

    password=<arg>
    password=<arg>

    specifies the SMB password. If this @@ -132,17 +131,26 @@ CLASS="COMMAND" given.

    credentials=<filename>
    credentials=<filename>

    specifies a file that contains a username and/or password. The format of the file is:

    		
    		username = <value>
    -		password = <value>
    +>		username = <value>
    +		password = <value>
     		

    netbiosname=<arg>
    netbiosname=<arg>

    sets the source NetBIOS name. It defaults to the local hostname.

    uid=<arg>
    uid=<arg>

    sets the uid that will own all files on @@ -168,7 +176,7 @@ CLASS="PROGRAMLISTING"

    gid=<arg>
    gid=<arg>

    sets the gid that will own all files on @@ -177,14 +185,14 @@ CLASS="PROGRAMLISTING" gid.

    port=<arg>
    port=<arg>

    sets the remote SMB port number. The default is 139.

    fmask=<arg>
    fmask=<arg>

    sets the file mask. This determines the @@ -192,7 +200,7 @@ CLASS="PROGRAMLISTING" The default is based on the current umask.

    dmask=<arg>
    dmask=<arg>

    sets the directory mask. This deterines the @@ -200,27 +208,27 @@ CLASS="PROGRAMLISTING" The default is based on the current umask.

    debug=<arg>
    debug=<arg>

    sets the debug level. This is useful for tracking down SMB connection problems.

    ip=<arg>
    ip=<arg>

    sets the destination host or IP address.

    workgroup=<arg>
    workgroup=<arg>

    sets the workgroup on the destination

    sockopt=<arg>
    sockopt=<arg>

    sets the TCP socket options. See the

    scope=<arg>
    scope=<arg>

    sets the NetBIOS scope

    mount read-write

    iocharset=<arg>
    iocharset=<arg>

    sets the charset used by the linux side for codepage @@ -274,7 +282,7 @@ CLASS="PARAMETER"

    codepage=<arg>
    codepage=<arg>

    sets the codepage the server uses. See the iocharset @@ -283,7 +291,7 @@ CLASS="PARAMETER"

    ttl=<arg>
    ttl=<arg>

    how long a directory listing is cached in milliseconds diff --git a/docs/htmldocs/smbpasswd.5.html b/docs/htmldocs/smbpasswd.5.html index 4ec7b7c86a..7de54f6309 100644 --- a/docs/htmldocs/smbpasswd.5.html +++ b/docs/htmldocs/smbpasswd.5.html @@ -118,20 +118,17 @@ CLASS="CONSTANT" > and the user will not be able to log onto the Samba server.

    WARNING !!WARNING !! Note that, due to the challenge-response nature of the SMB/CIFS authentication protocol, anyone with a knowledge of this password hash will be able to impersonate the user on the network. For this - reason these hashes are known as plain text - equivalents and must NOT and must NOT be made available to anyone but the root user. To protect these passwords the smbpasswd file is placed in a directory with read and @@ -156,20 +153,17 @@ CLASS="EMPHASIS" password this entry will be identical (i.e. the password is not "salted" as the UNIX password is).

    WARNING !!WARNING !!. Note that, due to the challenge-response nature of the SMB/CIFS authentication protocol, anyone with a knowledge of this password hash will be able to impersonate the user on the network. For this - reason these hashes are known as plain text - equivalents and must NOT and must NOT be made available to anyone but the root user. To protect these passwords the smbpasswd file is placed in a directory with read and @@ -192,9 +186,8 @@ CLASS="EMPHASIS" >

    • UU - This means this is a "User" account, i.e. an ordinary user. Only User and Workstation Trust accounts are currently supported @@ -202,9 +195,8 @@ CLASS="EMPHASIS" >

    • NN - This means the account has no password (the passwords in the fields Lanman Password Hash and NT Password Hash are ignored). Note that this @@ -225,18 +217,16 @@ CLASS="FILENAME" >

    • DD - This means the account is disabled and no SMB/CIFS logins will be allowed for this user.

    • WW - This means this account is a "Workstation Trust" account. This kind of account is used in the Samba PDC code stream to allow Windows NT Workstations diff --git a/docs/htmldocs/smbpasswd.8.html b/docs/htmldocs/smbpasswd.8.html index bb3eb7ca47..1c4df51941 100644 --- a/docs/htmldocs/smbpasswd.8.html +++ b/docs/htmldocs/smbpasswd.8.html @@ -36,7 +36,7 @@ NAME="AEN8" >smbpasswd [-a] [-x] [-d] [-e] [-D debuglevel] [-n] [-r <remote machine>] [-R <name resolve order>] [-m] [-j DOMAIN] [-U username] [-h] [-s] [username]

      [-a] [-x] [-d] [-e] [-D debuglevel] [-n] [-r <remote machine>] [-R <name resolve order>] [-m] [-j DOMAIN] [-U username] [-h] [-s] [username]

    This specifies the username for all of the - root onlyroot only options to operate on. Only root can specify this parameter as only root has the permission needed to modify attributes directly in the local smbpasswd file. diff --git a/docs/htmldocs/smbsh.1.html b/docs/htmldocs/smbsh.1.html index 1264e241ba..3033a50ccd 100644 --- a/docs/htmldocs/smbsh.1.html +++ b/docs/htmldocs/smbsh.1.html @@ -83,6 +83,12 @@ CLASS="COMMAND" that authenticate you to the machine running the Windows NT operating system.

    	
     	

    Any dynamically linked command you execute from @@ -127,7 +136,7 @@ CLASS="COMMAND" > will show all the machines in your workgroup. The command ls /smb/<machine-name>ls /smb/<machine-name> will show the share names for that machine. You could then, for example, use the

    DEVICE URIDEVICE URI

    smbspool specifies the destination using a Uniform Resource diff --git a/docs/htmldocs/smbstatus.1.html b/docs/htmldocs/smbstatus.1.html index b31437afea..cc366638df 100644 --- a/docs/htmldocs/smbstatus.1.html +++ b/docs/htmldocs/smbstatus.1.html @@ -36,7 +36,7 @@ NAME="AEN8" >smbstatus [-P] [-b] [-d] [-L] [-p] [-S] [-s <configuration file>] [-u <username>]

    [-P] [-b] [-d] [-L] [-p] [-S] [-s <configuration file>] [-u <username>]

    causes smbstatus to only list shares.

    -s <configuration file>
    -s <configuration file>

    The default configuration file name is @@ -133,7 +133,7 @@ CLASS="FILENAME" > for more information.

    -u <username>
    -u <username>

    selects information relevant to diff --git a/docs/htmldocs/smbtar.1.html b/docs/htmldocs/smbtar.1.html index 5e13ef3577..47c41a015a 100644 --- a/docs/htmldocs/smbtar.1.html +++ b/docs/htmldocs/smbtar.1.html @@ -253,9 +253,8 @@ NAME="AEN106" >

    DIAGNOSTICS

    See the DIAGNOSTICSSee the DIAGNOSTICS section for the nmblookup [-s <smb config file>] [-a]

    [-s <smb config file>] [-a]

    Do NOT enable this option on a production - server.

    testparm [-s] [-h] [-L <servername>] {config filename} [hostname hostIP]

    [-s] [-h] [-L <servername>] {config filename} [hostname hostIP]

    will successfully load the configuration file.

    Note that this is NOTNote that this is NOT a guarantee that the services specified in the configuration file will be available or will operate as expected.

    DIAGNOSTICS

    If a printer is found to be valid, the message - "Printer name <printername> is valid" will be + "Printer name <printername> is valid" will be displayed.

    If a printer is found to be invalid, the message - "Printer name <printername> is not valid" will be + "Printer name <printername> is not valid" will be displayed.

    All messages that would normally be logged during diff --git a/docs/htmldocs/winbindd.8.html b/docs/htmldocs/winbindd.8.html index a98b7a2864..0080386ee4 100644 --- a/docs/htmldocs/winbindd.8.html +++ b/docs/htmldocs/winbindd.8.html @@ -37,7 +37,7 @@ NAME="AEN8" >nmblookup [-d debuglevel] [-i] [-S] [-r] [-A] [-h] [-B <broadcast address>] [-U <unicast address>] [-d <debug level>] [-s <smb config file>] [-i <NetBIOS scope>] [-T] {name}

    [-d debuglevel] [-i] [-S] [-r] [-A] [-h] [-B <broadcast address>] [-U <unicast address>] [-d <debug level>] [-s <smb config file>] [-i <NetBIOS scope>] [-T] {name}

    and then from the Windows NT server.

    passwd:         files winbind
     group:          files winbind
     	

    Default: winbind uid = <empty string> +>winbind uid = <empty string>

    Default: winbind gid = <empty string> +>winbind gid = <empty string>

    system call will not return any data.

    Warning:Warning: Turning off user enumeration may cause some programs to behave oddly. For example, the finger program relies on having access to the full user list when @@ -404,9 +412,8 @@ CLASS="COMMAND" > system call will not return any data.

    Warning:Warning: Turning off group enumeration may cause some programs to behave oddly.

    put the following:

    passwd:     files winbind
     group:      files winbind
     	

    In lines with something like this:

    auth       required	/lib/security/pam_securetty.so
    @@ -512,6 +534,9 @@ auth       required	/lib/security/pam_nologin.so
     auth       sufficient	/lib/security/pam_winbind.so
     auth       required     /lib/security/pam_pwdb.so use_first_pass shadow nullok
     	

    Note in particular the use of the Finally, setup a smb.conf containing directives like the following:

    [global]
    @@ -598,6 +629,9 @@ CLASS="PROGRAMLISTING"
             security = domain
             password server = *
     	

    Now start winbindd and you should find that your user and -- cgit