smb.conf/manpage/2006/parameters/L

lanman auth
lanman auth (G) This parameter determines whether or not s�sm�mb�bd�d(8) will attempt to             authenticate users using the LANMAN password hash. If disabled, only clients  which  support  NT  password hashes (e.g. Windows              NT/2000 clients, smbclient, etc... but not Windows 95/98 or  the              MS  DOS  network  client)  will  be able to connect to the Samba host.

The LANMAN encrypted response is easily  broken,  due  to  it's              case-insensitive  nature,  and  the choice of algorithm. Servers without Windows 95/98 or MS DOS clients are advised to  disable this option.

Unlike the e�en�nc�cy�yp�pt�t p�pa�as�ss�sw�wo�or�rd�ds�s option, this parameter cannot alter client behaviour, and the LANMAN response will  still  be  sent over the network. See the c�cl�li�ie�en�nt�t l�la�an�nm�ma�an�n a�au�ut�th�h to disable this for Samba's clients (such as smbclient)

If this option, and n�nt�tl�lm�m a�au�ut�th�h  are  both  disabled,  then  only NTLMv2 logins will be permited. Not all clients support NTLMv2, and most will require special configuration to us it.

Default: _�l_�a_�n_�m_�a_�n _�a_�u_�t_�h = yes

large readwrite
large readwrite (G) This parameter determines whether or not s�sm�mb�bd�d(8)  supports  the new 64k streaming read and write varient SMB requests introduced with Windows 2000. Note that due to Windows 2000 client redirec- tor bugs  this requires Samba to be running on a 64-bit capable operating system such as IRIX, Solaris or a Linux  2.4  kernel. Can improve  performance  by  10%  with  Windows  2000 clients. Defaults to on. Not as tested as some other Samba code paths.

Default: _�l_�a_�r_�g_�e _�r_�e_�a_�d_�w_�r_�i_�t_�e = yes

ldap admin dn
ldap admin dn (G) The _�l_�d_�a_�p _�a_�d_�m_�i_�n _�d_�n defines the Distinguished Name (DN) name used by Samba to contact the ldap server when retreiving user account information. The _�l_�d_�a_�p _�a_�d_�m_�i_�n _�d_�n is used in conjunction with  the admin dn  password  stored in the _�p_�r_�i_�v_�a_�t_�e_�/_�s_�e_�c_�r_�e_�t_�s_�._�t_�d_�b file. See the s�sm�mb�bp�pa�as�ss�sw�wd�d(8) man page for more information on how to  accm- plish this.

N�No�o d�de�ef�fa�au�ul�lt�t

ldap delete dn
ldap delete dn (G) This parameter specifies whether a delete operation in the ldap- sam deletes the complete entry or only the attributes  specific to Samba.

Default: _�l_�d_�a_�p _�d_�e_�l_�e_�t_�e _�d_�n = no

ldap filter
ldap filter (G) This parameter specifies the RFC 2254 compliant LDAP search fil- ter. The default is to  match  the  login  name  with  the  u�ui�id�d attribute. Note that this filter should only return one entry.

Default: _�l_�d_�a_�p _�f_�i_�l_�t_�e_�r = (uid=%u)

Example: _�l_�d_�a_�p _�f_�i_�l_�t_�e_�r = (&(uid=%u)(objectclass=sambaSamAccount))

ldap group suffix
ldap group suffix (G) This parameters  specifies  the  suffix that is used for groups when these are added to the LDAP directory. If this parameter is             unset, the value of _�l_�d_�a_�p _�s_�u_�f_�f_�i_�x will be used instead.

Default: _�l_�d_�a_�p _�g_�r_�o_�u_�p _�s_�u_�f_�f_�i_�x =

Example: _�l_�d_�a_�p _�g_�r_�o_�u_�p _�s_�u_�f_�f_�i_�x = dc=samba,ou=Groups

ldap idmap suffix
ldap idmap suffix (G) This parameters  specifies the suffix that is used when storing idmap mappings. If this parameter is unset, the value  of  _�l_�d_�a_�p _�s_�u_�f_�f_�i_�x will be used instead.

Default: _�l_�d_�a_�p _�i_�d_�m_�a_�p _�s_�u_�f_�f_�i_�x =

Example: _�l_�d_�a_�p _�i_�d_�m_�a_�p _�s_�u_�f_�f_�i_�x = ou=Idmap,dc=samba,dc=org

ldap machine suffix
ldap machine suffix (G) It specifies where machines should be added to the ldap tree.

Default: _�l_�d_�a_�p _�m_�a_�c_�h_�i_�n_�e _�s_�u_�f_�f_�i_�x =

ldap password sync
ldap passwd sync (G) This option  is used to define whether or not Samba should sync the LDAP password with the NT and LM hashes for normal accounts (NOT for  workstation,  server  or domain trusts) on a password change via SAMBA.

The _�l_�d_�a_�p _�p_�a_�s_�s_�w_�d _�s_�y_�n_�c can be set to one of three values:

· _�Y_�e_�s = Try to update the LDAP, NT and LM passwords and  update the pwdLastSet time.

· _�N_�o  =  Update  NT  and LM passwords and update the pwdLastSet time.

· _�O_�n_�l_�y = Only update the LDAP password and let the LDAP  server do the rest.

Default: _�l_�d_�a_�p _�p_�a_�s_�s_�w_�d _�s_�y_�n_�c = no

ldap port
ldap port (G) This parameter is only available if Samba has been configure to              include the -�--�-w�wi�it�th�h-�-l�ld�da�ap�ps�sa�am�m option at compile time.

This option is used to control the tcp port number used to con- tact the _�l_�d_�a_�p _�s_�e_�r_�v_�e_�r. The default is to use the stand LDAPS port 636.

Default: _�l_�d_�a_�p _�p_�o_�r_�t = 636 # if ldap ssl = on

Default: _�l_�d_�a_�p _�p_�o_�r_�t = 389 # if ldap ssl = off

ldap replication sleep
ldap replication sleep (G) When Samba is asked to write to a read-only LDAP replica, we are redirected to talk to the read-write master server. This server then replicates our changes back to the 'local' server, however the replication  might  take some seconds, especially over slow links. Certain client activities, particularly domain joins, can become confused  by  the  'success'  that  does not immediately change the LDAP back-end's data.

This option simply causes Samba to wait a short time, to  allow the LDAP  server  to  catch  up. If you  have  a particularly high-latency network, you may wish to time the LDAP replication with a network sniffer, and increase this value accordingly. Be             aware that no checking is performed that the data  has  actually replicated.

The value  is  specified  in milliseconds, the maximum value is              5000 (5 seconds).

Default: _�l_�d_�a_�p _�r_�e_�p_�l_�i_�c_�a_�t_�i_�o_�n _�s_�l_�e_�e_�p = 1000

ldap server
ldap server (G) This parameter is only available if Samba has been configure to              include the -�--�-w�wi�it�th�h-�-l�ld�da�ap�ps�sa�am�m option at compile time.

This parameter  should  contain  the FQDN of the ldap directory server which should be queried to locate user account  informa- tion.

Default: _�l_�d_�a_�p _�s_�e_�r_�v_�e_�r = localhost

ldap ssl
ldap ssl (G) This option  is  used to define whether or not Samba should use SSL when connecting to the ldap server This is N�NO�OT�T  related  to              Samba's  previous  SSL  support  which was enabled by specifying the-�--�-w�wi�it�th�h-�-s�ss�sl�l option to the _�c_�o_�n_�f_�i_�g_�u_�r_�e script.

The _�l_�d_�a_�p _�s_�s_�l can be set to one of three values:

· _�O_�f_�f = Never use SSL when querying the directory.

· _�S_�t_�a_�r_�t_�__�t_�l_�s  =  Use  the  LDAPv3  StartTLS  extended  operation (RFC2830) for communicating with the directory server.

· _�O_�n  =  Use  SSL  on  the  ldaps port when contacting the _�l_�d_�a_�p _�s_�e_�r_�v_�e_�r. Only available  when   the   backwards-compatiblity -�--�-w�wi�it�th�h-�-l�ld�da�ap�ps�sa�am�m option  is specified to configure. See _�p_�a_�s_�s_�d_�b _�b_�a_�c_�k_�e_�n_�d

Default: _�l_�d_�a_�p _�s_�s_�l = start_tls

ldap suffix
ldap suffix (G) Specifies where user and machine accounts are added to the tree. Can be overriden by l�ld�da�ap�p u�us�se�er�r s�su�uf�ff�fi�ix�x and l�ld�da�ap�p m�ma�ac�ch�hi�in�ne�e s�su�uf�ff�fi�ix�x. It             also used as the base dn for all ldap searches.

Default: _�l_�d_�a_�p _�s_�u_�f_�f_�i_�x =

ldap timeout
ldap timeout (G) When Samba connects to an ldap server that server may be down or             unreachable. To prevent  Samba from hanging whilst waiting for the connection this parameter specifies  in  seconds  how  long Samba should wait before failing the connect. The default is to             only wait fifteen seconds for the ldap server to respond to  the connect request.

Default: _�l_�d_�a_�p _�t_�i_�m_�e_�o_�u_�t = 15

ldap user suffix
ldap user suffix (G) This parameter  specifies where users are added to the tree. If             this parameter is not specified, the value from l�ld�da�ap�p s�su�uf�ff�fi�ix�x.

Default: _�l_�d_�a_�p _�u_�s_�e_�r _�s_�u_�f_�f_�i_�x =

level2 oplocks
level2 oplocks (S) This parameter   controls   whether   Samba   supports   level2 (read-only) oplocks on a share.

Level2, or read-only oplocks allow Windows NT clients that have an oplock on a file to downgrade from a read-write oplock to  a              read-only oplock once a second client opens the file (instead of              releasing all oplocks on  a  second  open,  as  in  traditional,              exclusive  oplocks). This allows  all openers of the file that support level2 oplocks to cache the file  for  read-ahead  only (ie. they  may not cache writes or lock requests) and increases performance for many accesses of files that  are  not  commonly written (such as application .EXE files).

Once one of the clients which have a read-only oplock writes to              the file all clients are notified (no reply is needed or  waited              for)  and  told  to break their oplocks to "none" and delete any read-ahead caches.

It is recommended that this parameter be  turned  on  to  speed access to shared executables.

For more discussions on level2 oplocks see the CIFS spec.

Currently, if  _�k_�e_�r_�n_�e_�l _�o_�p_�l_�o_�c_�k_�s are supported then level2 oplocks are not granted (even if this parameter is set  to  y�ye�es�s). Note also, the _�o_�p_�l_�o_�c_�k_�s parameter must be set to y�ye�es�s on this share in              order for this parameter to have any effect.

Default: _�l_�e_�v_�e_�l_�2 _�o_�p_�l_�o_�c_�k_�s = yes

lm announce
lm announce (G) This parameter  determines  if  n�nm�mb�bd�d(8)  will  produce   Lanman announce broadcasts that are needed by OS/2 clients in order for them to see the Samba server in their browse list. This parame- ter can have three values, y�ye�es�s, n�no�o, ora�au�ut�to�o. The default is a�au�ut�to�o. If set to n�no�o Samba will never produce these broadcasts. If set to y�ye�es�s  Samba will produce Lanman announce broadcasts at a fre- quency set by the parameter_�l_�m _�i_�n_�t_�e_�r_�v_�a_�l. If set  to  a�au�ut�to�o  Samba will not  send  Lanman  announce broadcasts by default but will listen for them. If it hears such a broadcast on  the  wire  it              will  then  start sending them at a frequency set by the parame- ter_�l_�m _�i_�n_�t_�e_�r_�v_�a_�l.

Default: _�l_�m _�a_�n_�n_�o_�u_�n_�c_�e = auto

Example: _�l_�m _�a_�n_�n_�o_�u_�n_�c_�e = yes

lm interval
lm interval (G) If Samba is set to produce Lanman announce broadcasts needed by              OS/2 clients (see the _�l_�m _�a_�n_�n_�o_�u_�n_�c_�e parameter) then this parameter defines the frequency in seconds with which they will be  made. If this is set to zero then no Lanman announcements will be made despite the setting of the _�l_�m _�a_�n_�n_�o_�u_�n_�c_�e parameter.

Default: _�l_�m _�i_�n_�t_�e_�r_�v_�a_�l = 60

Example: _�l_�m _�i_�n_�t_�e_�r_�v_�a_�l = 120

load printers
load printers (G) A boolean variable that controls whether all  printers  in  the printcap will be loaded for browsing by default. See the print- ers section for more details.

Default: _�l_�o_�a_�d _�p_�r_�i_�n_�t_�e_�r_�s = yes

local master
local master (G) This option allows n�nm�mb�bd�d(8) to try and  become  a  local  master browser on a subnet. If set to n�no�o then n�nm�mb�bd�d 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 y�ye�es�s. Setting this value toy�ye�es�s doesn't mean that Samba will b�be�ec�co�om�me�e the local master  browser on a subnet, just that n�nm�mb�bd�d will p�pa�ar�rt�ti�ic�ci�i-�- p�pa�at�te�e in elections for local master browser.

Setting this value to n�no�o will cause n�nm�mb�bd�d   n�ne�ev�ve�er�r  to  become  a              local master browser.

Default: _�l_�o_�c_�a_�l _�m_�a_�s_�t_�e_�r = yes

lock directory
lock dir This parameter is a synonym for lock directory.

lock directory (G) This option  specifies  the  directory where lock files will be              placed. The lock files are used to implement the_�m_�a_�x _�c_�o_�n_�n_�e_�c_�t_�i_�o_�n_�s option.

Default: _�l_�o_�c_�k _�d_�i_�r_�e_�c_�t_�o_�r_�y = ${prefix}/var/locks

Example: _�l_�o_�c_�k _�d_�i_�r_�e_�c_�t_�o_�r_�y = /var/run/samba/locks

locking
locking (S) This controls  whether  or not locking will be performed by the server in response to lock requests from the client.

If l�lo�oc�ck�ki�in�ng�g =�= n�no�o, all lock and unlock requests  will  appear  to              succeed  and all lock queries will report that the file in ques- tion is available for locking.

If l�lo�oc�ck�ki�in�ng�g =�= y�ye�es�s, real locking will be performed by the server.

This option  m�ma�ay�y  be useful for read-only filesystems which m�ma�ay�y not need locking (such as CDROM drives), although setting  this parameter of n�no�o is not really recommended even in this case.

Be careful about disabling locking either globally or in a spe- cific service, as lack of locking may result in data corruption. You should never need to set this parameter.

N�No�o d�de�ef�fa�au�ul�lt�t

lock spin count
lock spin count (G) This parameter  controls  the  number of times that smbd should attempt to gain a byte range lock on the  behalf  of  a  client request. Experiments have shown that Windows 2k servers do not reply with a failure if  the  lock  could  not  be  immediately granted, but  try a few more times in case the lock could later be acquired. This behavior  is  used  to  support  PC  database formats such as MS Access and FoxPro.

Default: _�l_�o_�c_�k _�s_�p_�i_�n _�c_�o_�u_�n_�t = 3

lock spin time
lock spin time (G) The time in microseconds that smbd should pause before attempt- ing to gain a failed lock. See_�l_�o_�c_�k _�s_�p_�i_�n _�c_�o_�u_�n_�t for more details.

Default: _�l_�o_�c_�k _�s_�p_�i_�n _�t_�i_�m_�e = 10

log file
log file (G) This option  allows  you  to override the name of the Samba log file (also known as the debug file).

This option takes the standard substitutions, allowing  you  to              have separate log files for each user or machine.

N�No�o d�de�ef�fa�au�ul�lt�t

Example: _�l_�o_�g _�f_�i_�l_�e = /usr/local/samba/var/log.%m

log level
debuglevel This parameter is a synonym for log level.

log level (G) The value  of  the parameter (a astring) allows the debug level (logging level) to be specified  in  the  _�s_�m_�b_�._�c_�o_�n_�f  file. This parameter has been extended since the 2.2.x series, now it allow to specify the debug level for multiple debug classes. This is              to  give greater flexibility in the configuration of the system.

The default will be the log level specified on the command line or level zero if none was specified.

N�No�o d�de�ef�fa�au�ul�lt�t

Example: _�l_�o_�g _�l_�e_�v_�e_�l = 3 passdb:5 auth:10 winbind:2

logon drive
logon drive (G) This parameter specifies the local path to which the home direc- tory will be connected (see _�l_�o_�g_�o_�n _�h_�o_�m_�e) and is only used by  NT              Workstations.

Note that  this  option  is only useful if Samba is set up as a              logon server.

Default: _�l_�o_�g_�o_�n _�d_�r_�i_�v_�e = z:

Example: _�l_�o_�g_�o_�n _�d_�r_�i_�v_�e = h:

logon home
logon home (G) This parameter specifies the home  directory  location  when  a              Win95/98  or NT Workstation logs into a Samba PDC. It allows you to do

C:\> N�NE�ET�T U�US�SE�E H�H:�: /�/H�HO�OM�ME�E

from a command prompt, for example.

This option takes the standard substitutions, allowing  you  to              have separate logon scripts for each user or machine.

This parameter  can  be  used with Win9X workstations to ensure that roaming profiles are stored in a subdirectory of the user's             home directory. This is done in the following way:

l�lo�og�go�on�n h�ho�om�me�e =�= \�\\�\%�%N�N\�\%�%U�U\�\p�pr�ro�of�fi�il�le�e

This tells Samba to return the above string, with substitutions made when a client requests the info, generally in a NetUserGet- Info request. Win9X clients truncate the info to \\server\share when a user does n�ne�et�t u�us�se�e /�/h�ho�om�me�e but use the  whole  string  when dealing with profiles.

Note that  in  prior  versions  of  Samba,  the  _�l_�o_�g_�o_�n _�p_�a_�t_�h was returned rather than_�l_�o_�g_�o_�n _�h_�o_�m_�e. This broke n�ne�et�t  u�us�se�e  /�/h�ho�om�me�e  but allowed profiles outside the home directory. The current imple- mentation is correct, and can be used for profiles if  you  use the above trick.

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

Default: _�l_�o_�g_�o_�n _�h_�o_�m_�e = \\%N\%U

Example: _�l_�o_�g_�o_�n _�h_�o_�m_�e = \\remote_smb_server\%U

logon path
logon path (G) This parameter specifies the home directory where roaming  pro- files (NTuser.dat etc files for Windows NT) are stored. Contrary to previous versions of these manual pages, it has nothing to do             with  Win 9X roaming profiles. To find out how to handle roaming profiles for Win 9X system, see the _�l_�o_�g_�o_�n _�h_�o_�m_�e parameter.

This option takes the standard substitutions, allowing  you  to              have  separate  logon  scripts for each user or machine. It also specifies the directory  from  which  the  "Application  Data", (_�d_�e_�s_�k_�t_�o_�p, _�s_�t_�a_�r_�t  _�m_�e_�n_�u,_�n_�e_�t_�w_�o_�r_�k  _�n_�e_�i_�g_�h_�b_�o_�r_�h_�o_�o_�d, _�p_�r_�o_�g_�r_�a_�m_�s and other              folders, and their contents, are loaded and  displayed  on  your              Windows NT client.

The share  and  the  path  must be readable by the user for the preferences and directories to be loaded onto  the  Windows  NT              client. The share  must be writeable when the user logs in for the first time, in order that the Windows NT client can  create the NTuser.dat and other directories.

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 M�MA�AN�Ndatory profile).

Windows clients can sometimes  maintain  a  connection  to  the [homes] share,  even  though there is no user logged in. There- fore, it is vital that the logon path does not include a refer- ence to  the  homes  share  (i.e.  setting  this  parameter  to              \%N\%U\profile_path will cause problems).

This option takes the standard substitutions, allowing  you  to              have separate logon scripts for each user or machine.

W�Wa�ar�rn�ni�in�ng�g

Do not quote the value. Setting this as ``\�\\�\%�%N�N\�\p�pr�ro�of�fi�il�le�e\�\%�%U�U'' will break profile handling.

Note that this option is only useful if Samba is set  up  as  a  logon server.

Default: _�l_�o_�g_�o_�n _�p_�a_�t_�h = \\%N\%U\profile

Example: _�l_�o_�g_�o_�n _�p_�a_�t_�h = >\\PROFILESERVER\PROFILE\%U

logon script
logon script (G) This parameter  specifies  the  batch file (.bat) or NT command file (.cmd) to be downloaded and run on a machine when  a  user successfully logs in. The file must contain the DOS style CR/LF line endings. Using a DOS-style editor to create  the  file  is              recommended.

The script must be a relative path to the [netlogon] service. If             the [netlogon] service specifies a _�p_�a_�t_�h of _�/_�u_�s_�r_�/_�l_�o_�c_�a_�l_�/_�s_�a_�m_�b_�a_�/_�n_�e_�t_�- _�l_�o_�g_�o_�n, and  l�lo�og�go�on�n s�sc�cr�ri�ip�pt�t =�= S�ST�TA�AR�RT�TU�UP�P.�.B�BA�AT�T, then the file that will be downloaded is:

_�/_�u_�s_�r_�/_�l_�o_�c_�a_�l_�/_�s_�a_�m_�b_�a_�/_�n_�e_�t_�l_�o_�g_�o_�n_�/_�S_�T_�A_�R_�T_�U_�P_�._�B_�A_�T

The contents of the batch file are entirely your choice. A sug- gested command  would be to add N�NE�ET�T T�TI�IM�ME�E \�\\�\S�SE�ER�RV�VE�ER�R /�/S�SE�ET�T /�/Y�YE�ES�S, to              force every machine to synchronize clocks  with  the  same  time server. Another use  would be to add N�NE�ET�T U�US�SE�E U�U:�: \�\\�\S�SE�ER�RV�VE�ER�R\�\U�UT�TI�IL�LS�S for commonly used utilities, or

N�NE�ET�T U�US�SE�E Q�Q:�: \�\\�\S�SE�ER�RV�VE�ER�R\�\I�IS�SO�O9�90�00�01�1_�_Q�QA�A.fi              for example.

Note that it is particularly important not to allow write access to the [netlogon] share, or to grant users write permission on the batch files in a secure environment, as this would allow the batch files to be arbitrarily modified and security to be breached.

This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine.

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

Default: _�l_�o_�g_�o_�n _�s_�c_�r_�i_�p_�t =

Example: _�l_�o_�g_�o_�n _�s_�c_�r_�i_�p_�t = scripts\%U.bat

lppause command
lppause command (S) This parameter specifies the command to be executed on the server host in order to stop printing or spooling a specific print job.

This command should be a program or script which takes a printer name and job number to pause the print job. One way of implementing this is by using job priorities, where jobs having a too low priority won't be sent to the printer.

If a _�%_�p is given then the printer name is put in its place. A _�%_�j is replaced with the job number (an integer). On HPUX (see _�p_�r_�i_�n_�t_�i_�n_�g_�=_�h_�p_�u_�x ), if the _�-_�p_�%_�p option is added to the lpq command, the job will show up with the correct status, i.e. if the job priority is lower than the set fence priority it will have the PAUSED status, whereas if the priority is equal or higher it will have the SPOOLED or PRINTING status.

Note that it is good practice to include the absolute path in the lppause command as the PATH may not be available to the server.

Default: _�l_�p_�p_�a_�u_�s_�e _�c_�o_�m_�m_�a_�n_�d = # Currently no default value is given to this string, unless the value of the _�p_�r_�i_�n_�t_�i_�n_�g parameter is S�SY�YS�SV�V, in which case the default is : l�lp�p -�-i�i %�%p�p-�-%�%j�j -�-H�H h�ho�ol�ld�d or if the value of the _�p_�r_�i_�n_�t_�i_�n_�g parameter is S�SO�OF�FT�TQ�Q, then the default is: q�qs�st�ta�at�t -�-s�s -�-j�j%�%j�j -�-h�h.

Example: _�l_�p_�p_�a_�u_�s_�e _�c_�o_�m_�m_�a_�n_�d = /usr/bin/lpalt %p-%j -p0

lpq cache time
lpq cache time (G) This controls how long lpq info will be cached for to prevent the l�lp�pq�q command being called too often. A separate cache is kept for each variation of the l�lp�pq�q command used by the system, so if you use differentl�lp�pq�q commands for different users then they won't share cache information.

The cache files are stored in _�/_�t_�m_�p_�/_�l_�p_�q_�._�x_�x_�x_�x where xxxx is a hash of the l�lp�pq�q command in use.

The default is 10 seconds, meaning that the cached results of a previous identical l�lp�pq�q command will be used if the cached data is less than 10 seconds old. A large value may be advisable if your l�lp�pq�q command is very slow.

A value of 0 will disable caching completely.

Default: _�l_�p_�q _�c_�a_�c_�h_�e _�t_�i_�m_�e = 10

Example: _�l_�p_�q _�c_�a_�c_�h_�e _�t_�i_�m_�e = 30

lpq command
lpq command (S) This parameter specifies the command to be executed on the server host in order to obtain l�lp�pq�q -style printer status information.

This command should be a program or script which takes a printer name as its only parameter and outputs printer status information.

Currently nine styles of printer status information are supported; BSD, AIX, LPRNG, PLP, SYSV, HPUX, QNX, CUPS, and SOFTQ. This covers most UNIX systems. You control which type is expected using the _�p_�r_�i_�n_�t_�i_�n_�g _�= option.

Some clients (notably Windows for Workgroups) may not correctly send the connection number for the printer they are requesting status information about. To get around this, the server reports on the first printer service connected to by the client. This only happens if the connection number sent is invalid.

If a _�%_�p is given then the printer name is put in its place. Otherwise it is placed at the end of the command.

Note that it is good practice to include the absolute path in the _�l_�p_�q _�c_�o_�m_�m_�a_�n_�d as the $�$P�PA�AT�TH�H may not be available to the server. When compiled with the CUPS libraries, no _�l_�p_�q _�c_�o_�m_�m_�a_�n_�d is needed because smbd will make a library call to obtain the print queue listing.

Default: _�l_�p_�q _�c_�o_�m_�m_�a_�n_�d =

Example: _�l_�p_�q _�c_�o_�m_�m_�a_�n_�d = /usr/bin/lpq -P%p

lpresume command
lpresume command (S) This parameter specifies the command to be executed on the server host in order to restart or continue printing or spooling a specific print job.

This command should be a program or script which takes a printer name and job number to resume the print job. See also the _�l_�p_�p_�a_�u_�s_�e _�c_�o_�m_�m_�a_�n_�d parameter.

If a _�%_�p is given then the printer name is put in its place. A _�%_�j is replaced with the job number (an integer).

Note that it is good practice to include the absolute path in the _�l_�p_�r_�e_�s_�u_�m_�e _�c_�o_�m_�m_�a_�n_�d as the PATH may not be available to the server.

See also the _�p_�r_�i_�n_�t_�i_�n_�g parameter.

Default: Currently no default value is given to this string, unless the value of the _�p_�r_�i_�n_�t_�i_�n_�g parameter is S�SY�YS�SV�V, in which case the default is :

l�lp�p -�-i�i %�%p�p-�-%�%j�j -�-H�H r�re�es�su�um�me�e

or if the value of the _�p_�r_�i_�n_�t_�i_�n_�g parameter is S�SO�OF�FT�TQ�Q, then the default is:

q�qs�st�ta�at�t -�-s�s -�-j�j%�%j�j -�-r�r

Default: _�l_�p_�r_�e_�s_�u_�m_�e _�c_�o_�m_�m_�a_�n_�d = lpresume command = /usr/bin/lpalt %p-%j -p2

lprm command
lprm command (S) This parameter specifies the command to be executed on the server host in order to delete a print job.

This command should be a program or script which takes a printer name and job number, and deletes the print job.

If a _�%_�p is given then the printer name is put in its place. A _�%_�j is replaced with the job number (an integer).

Note that it is good practice to include the absolute path in the _�l_�p_�r_�m _�c_�o_�m_�m_�a_�n_�d as the PATH may not be available to the server.

Default: _�l_�p_�r_�m _�c_�o_�m_�m_�a_�n_�d = # depends on the setting of _�p_�r_�i_�n_�t_�i_�n_�g

Example: _�l_�p_�r_�m _�c_�o_�m_�m_�a_�n_�d = /usr/bin/lprm -P%p %j

Example: _�l_�p_�r_�m _�c_�o_�m_�m_�a_�n_�d = /usr/bin/cancel %p-%j