From c8af938a0a7ec15c38076fc11d164f55737318f1 Mon Sep 17 00:00:00 2001
From: Gerald Carter In Samba 2.0.4 and above the default value of the
parameter 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
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 LevelThe 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 UsernamesIf 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 passwords2.4. The smbpasswd filecat /etc/passwd | mksmbpasswd.sh - > /usr/local/samba/private/smbpasswdypcat 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 EncryptionThis 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. IntroductionBeginning 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)
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. |
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 |
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 +>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 @@ -2420,7 +2487,9 @@ CLASS="COMMAND" > 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, @@ -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" |
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.
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.
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. |
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.
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 tool set provides a UNIX equivalent of the @@ -2643,8 +2878,8 @@ CLASS="SECT2" >
Imprints is a collection of tools for supporting the goals @@ -2675,8 +2910,8 @@ CLASS="SECT2" >
The process of creating printer driver packages is beyond @@ -2691,8 +2926,8 @@ CLASS="SECT2" >
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.
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" >
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.
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
Many people have asked regarding the state of Samba's ability to participate in @@ -3196,8 +3446,8 @@ CLASS="SECT1" >
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 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. 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: There are a couple of points to emphasize in the above
@@ -3619,8 +3876,8 @@ CLASS="SECT1"
> /etc/passwd entry like this : 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. 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 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"
> 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"
> 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"
> 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. How do I get help from the mailing lists ?How do I get help from the mailing lists ? 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"
> 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. 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"
> It is well known that UNIX and Microsoft Windows NT have
@@ -4599,8 +4852,8 @@ CLASS="SECT1"
> Winbind unifies UNIX and Windows NT account management by
@@ -4641,8 +4894,8 @@ CLASS="SECT2"
> Winbind is targeted at organizations that have an
@@ -4665,8 +4918,8 @@ CLASS="SECT1"
> The winbind system is designed around a client/server
@@ -4685,8 +4938,8 @@ CLASS="SECT2"
> Over the last two years, efforts have been underway
@@ -4711,8 +4964,8 @@ CLASS="SECT2"
> The Name Service Switch, or NSS, is a feature that is
@@ -4790,8 +5043,8 @@ CLASS="SECT2"
> Pluggable Authentication Modules, also known as PAM,
@@ -4839,8 +5092,8 @@ CLASS="SECT2"
> When a user or group is created under Windows NT
@@ -4865,8 +5118,8 @@ CLASS="SECT2"
> An active system can generate a lot of user and group
@@ -4888,8 +5141,8 @@ CLASS="SECT1"
> The easiest way to install winbind is by using the packages
@@ -4919,8 +5172,8 @@ CLASS="SECT1"
> Winbind has a number of limitations in its current
@@ -4967,8 +5220,8 @@ CLASS="SECT1"
> The winbind system, through the use of the Name Service
@@ -4983,7 +5236,7 @@ NAME="AEN1138"
CLASS="CHAPTER"
> In Samba 2.0.4 and above the default value of the
parameter 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 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. The third button is the The standard UNIX user/group/world triple and
@@ -5294,8 +5539,8 @@ CLASS="SECT2"
> Directories on an NT NTFS file system have two
@@ -5326,8 +5571,8 @@ CLASS="SECT1"
> Modifying file and directory permissions is as simple
@@ -5424,8 +5669,8 @@ CLASS="SECT1"
> 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.
before you install the client. Also, don't use the
@@ -5864,8 +6117,8 @@ CLASS="SECT2"
> <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. An example follows : 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>] 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"
>. debuglevel is an integer
@@ -278,7 +275,7 @@ CLASS="FILENAME"
> file. The -l parameter specifies a path
@@ -306,7 +303,7 @@ CLASS="FILENAME"
>. This option allows you to override
@@ -331,7 +328,7 @@ CLASS="FILENAME"
>. UDP port number is a positive integer value.
@@ -344,7 +341,7 @@ CLASS="COMMAND"
won't need help! 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 Send the query to the given broadcast address. Without
@@ -179,7 +179,7 @@ CLASS="FILENAME"
Do a unicast query to the specified address or
@@ -198,7 +198,7 @@ CLASS="PARAMETER"
query a WINS server. debuglevel is an integer from 0 to 10. This parameter specifies the pathname to
@@ -246,7 +246,7 @@ TARGET="_top"
the Samba setup on the machine. 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. Beginning with the 2.2.0 release, Samba supports
- the native Windows NT printing mechanisms implemented via
- MS-RPC (i.e. the SPOOLSS named pipe). Previous versions of
- Samba only supported LanMan printing calls. The additional functionality provided by the new
- SPOOLSS support includes: Support for downloading printer driver
- files to Windows 95/98/NT/2000 clients upon demand.
- Uploading of printer drivers via the
- Windows NT Add Printer Wizard (APW) or the Imprints tool set
- Support for the native MS-RPC printing
- calls such as StartDocPrinter, EnumJobs(), etc... (See
- the MSDN documentation
- for more information on the Win32 printing API)
- Support for NT Access Control Lists (ACL)
- on printer objects Improved support for printer queue manipulation
- through the use of an internal databases for spooled job
- information 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). 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. 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): 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.Chapter 6. How to Configure Samba 2.2.x as a Primary Domain Controller
Background6.1. Background
Configuring the Samba Domain Controller6.2. Configuring the Samba Domain Controller
[global]
@@ -3566,6 +3820,9 @@ HREF="smb.conf.5.html#DIRECTORYMASK"
TARGET="_top"
>directory mask = 0700
Creating Machine Trust Accounts and Joining Clients
+NAME="AEN833"
+>6.3. Creating Machine Trust Accounts and Joining Clients
to the Domain
doppy$:x:505:501:NTMachine:/dev/null:/bin/false
add user script = /usr/sbin/useradd -d /dev/null -g 100 -s /bin/false -M %u
Common Problems and Errors6.4. Common Problems and Errors
System Policies and Profiles6.5. System Policies and Profiles
What other help can I get ?6.6. What other help can I get ?
URLs and similar6.6.1. URLs and similar
Mailing Lists6.6.2. Mailing Lists
DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba6.7. DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba
Chapter 7. Unifed Logons between Windows NT and UNIX using Winbind
Abstract7.1. Abstract
Introduction7.2. Introduction
What Winbind Provides7.3. What Winbind Provides
Target Uses7.3.1. Target Uses
How Winbind Works7.4. How Winbind Works
Microsoft Remote Procedure Calls7.4.1. Microsoft Remote Procedure Calls
Name Service Switch7.4.2. Name Service Switch
Pluggable Authentication Modules7.4.3. Pluggable Authentication Modules
User and Group ID Allocation7.4.4. User and Group ID Allocation
Result Caching7.4.5. Result Caching
Installation and Configuration7.5. Installation and Configuration
Limitations7.6. Limitations
Conclusion7.7. Conclusion
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
How to view file security on a Samba share8.2. How to view file security on a Samba share
Viewing file ownership8.3. Viewing file ownership
Viewing file or directory permissions8.4. Viewing file or directory permissions
File Permissions8.4.1. File Permissions
Directory Permissions8.4.2. Directory Permissions
Modifying file or directory permissions8.5. Modifying file or directory permissions
Interaction with the standard Samba create mask
+NAME="AEN1290"
+>8.6. Interaction with the standard Samba create mask
parameters
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
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?
#
@@ -114,6 +119,9 @@ CLASS="PROGRAMLISTING"
192.9.200.20 NTSERVER#20
192.9.200.21 SAMBASERVER
Warning Creating [print$]
[print$]
- path = /usr/local/samba/printers
- guest ok = yes
- browseable = yes
- read only = yes
- write list = ntadmin
-
[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.
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.
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. -
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.
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.
- 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" >
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" >
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 theBUGBUG. 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>
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.
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>
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
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>
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.
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"
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/ |
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
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
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.
The client will request that the server attempt @@ -1014,7 +1014,7 @@ CLASS="VARIABLELIST" directory on the server.
A list of the files matching "mask" in the current @@ -1029,7 +1029,7 @@ CLASS="VARIABLELIST" from the program.
Copy the file called "remote file name" from @@ -1073,13 +1073,13 @@ CLASS="COMMAND" lowercase filenames are the norm on UNIX systems.
See the dir command above.
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.
See the mkdir command.
Copy all files matching mask from the server to @@ -1123,14 +1123,14 @@ CLASS="COMMAND" smbclient are binary. See also the lowercase command.
Create a new directory on the server (user access privileges permitting) with the specified name.
Copy all files matching mask in the current working @@ -1143,7 +1143,7 @@ CLASS="COMMAND" are binary.
Print the specified file from the local machine @@ -1152,7 +1152,7 @@ CLASS="COMMAND" >See also the printmode command.
Set the print mode to suit either binary data @@ -1172,7 +1172,7 @@ CLASS="COMMAND"
Copy the file called "local file name" from the @@ -1195,7 +1195,7 @@ CLASS="COMMAND" >See the exit command.
See the rmdir command.
Remove all files matching mask from the current working directory on the server.
Remove the specified directory (user access privileges permitting) from the server.
Performs a tar operation - see the
Blocksize. Must be followed by a valid (greater @@ -1258,7 +1258,7 @@ CLASS="PARAMETER" blocksize*TBLOCK (usually 512 byte) blocks.
Changes tar's behavior with regard to archive @@ -1269,7 +1269,7 @@ CLASS="PARAMETER" read/write share).
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>]debuglevel is an integer @@ -214,12 +214,11 @@ CLASS="FILENAME" > 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.
See the file for details.
port number is a positive integer @@ -285,7 +284,7 @@ CLASS="FILENAME" in the above situation.
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.
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
specifies the username to connect as. If @@ -115,7 +114,7 @@ CLASS="ENVAR" to be specified as part of the username.
specifies the SMB password. If this @@ -132,17 +131,26 @@ CLASS="COMMAND" given.
specifies a file that contains a username and/or password. The format of the file is:
username = <value> - password = <value> +> username = <value> + password = <value> |
sets the source NetBIOS name. It defaults to the local hostname.
sets the uid that will own all files on @@ -168,7 +176,7 @@ CLASS="PROGRAMLISTING"
sets the gid that will own all files on @@ -177,14 +185,14 @@ CLASS="PROGRAMLISTING" gid.
sets the remote SMB port number. The default is 139.
sets the file mask. This determines the @@ -192,7 +200,7 @@ CLASS="PROGRAMLISTING" The default is based on the current umask.
sets the directory mask. This deterines the @@ -200,27 +208,27 @@ CLASS="PROGRAMLISTING" The default is based on the current umask.
sets the debug level. This is useful for tracking down SMB connection problems.
sets the destination host or IP address.
sets the workgroup on the destination
sets the NetBIOS scope
mount read-writesets the charset used by the linux side for codepage @@ -274,7 +282,7 @@ CLASS="PARAMETER"
sets the codepage the server uses. See the iocharset @@ -283,7 +291,7 @@ CLASS="PARAMETER"
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]The smbpasswd program has several different - functions, depending on whether it is run by the rootroot user or not. When run as a normal user it allows the user to change the password used for their SMB sessions on any machines that store @@ -71,9 +70,8 @@ CLASS="COMMAND" CLASS="COMMAND" >smbpasswd differs from how the passwd program works - however in that it is not setuid rootsetuid root but works in a client-server mode and communicates with a locally running
smbpasswd can also be used by a normal user to change their SMB password on remote machines, such as Windows NT Primary Domain @@ -127,7 +125,7 @@ CLASS="VARIABLELIST" >
This option specifies that the username following should be added to the local smbpasswd file, with the - new password typed (type <Enter> for the old password). This + new password typed (type <Enter> for the old password). This option is ignored if the username following already exists in the smbpasswd file and it is treated like a regular change password command. Note that the user to be added must already exist @@ -303,9 +301,8 @@ CLASS="PARAMETER" copy of the user account database and will not allow the password change).
NoteNote that Windows 95/98 do not have a real password database so it is not possible to change passwords specifying a Win95/98 machine as remote machine target.
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>]The default configuration file name is @@ -133,7 +133,7 @@ CLASS="FILENAME" > for more information.
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" >
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]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.
DIAGNOSTICSIf 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}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