Next update of VFS modules development guide
[vlendec/samba-autobuild/.git] / docs-xml / smbdotconf / printing / enumportscommand.xml
1 <samba:parameter name="enumports command"
2                  context="G"
3                                  type="string"
4                  advanced="1" developer="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>The concept of a &quot;port&quot; is fairly foreign
8     to UNIX hosts.  Under Windows NT/2000 print servers, a port
9     is associated with a port monitor and generally takes the form of
10     a local port (i.e. LPT1:, COM1:, FILE:) or a remote port
11     (i.e. LPD Port Monitor, etc...).  By default, Samba has only one
12     port defined--<constant>&quot;Samba Printer Port&quot;</constant>.  Under 
13     Windows NT/2000, all printers must have a valid port name.  
14     If you wish to have a list of ports displayed (<command moreinfo="none">smbd
15     </command> does not use a port name for anything) other than 
16     the default <constant>&quot;Samba Printer Port&quot;</constant>, you 
17     can define <parameter moreinfo="none">enumports command</parameter> to point to
18     a program which should generate a list of ports, one per line,
19     to standard output.  This listing will then be used in response
20     to the level 1 and 2 EnumPorts() RPC.</para>
21 </description>
22
23 <value type="default"></value>
24 <value type="example">/usr/bin/listports</value>
25 </samba:parameter>