smb.conf/manpage/2006/parameters/L
< smb.conf | manpage | 2006 | parameters
Jump to navigation
Jump to search
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