[thirdparty/cups.git] / doc / help / man-cupsaddsmb.html

<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>cupsaddsmb(8)</title>
</head>
<body>
<h1 class="title">cupsaddsmb(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsaddsmb - export printers to samba for windows clients

<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsaddsmb</b>
[
<b>-H</b>
<i>samba-server</i>
] [
<b>-U</b>
<i>samba-user[%samba-password]</i>
] [
<b>-h</b>
<i>cups-server[:port]</i>
] [
<b>-v</b>
]
<b>-a</b>
<br>
<b>cupsaddsmb</b>
[
<b>-H</b>
<i>samba-server</i>
] [
<b>-U</b>
<i>samba-user[%samba-password]</i>
] [
<b>-h</b>
<i>cups-server[:port]</i>
] [
<b>-v</b>
]
<i>printer</i>
[ ...
<i>printer</i>
]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>cupsaddsmb</b> program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients.
Depending on the SAMBA configuration, you may need to provide a password to export the printers.
This program requires the Windows printer driver files described below.
<h3><a name="SAMBA_CONFIGURATION">Samba Configuration</a></h3>
<b>cupsaddsmb</b> uses the RPC-based printing support in SAMBA to provide printer drivers and PPD files to Windows client machines.
In order to use this functionality, you must first configure the SAMBA
<b>smb.conf</b>(5)
file to support printing through CUPS and provide a printer driver download
share, as follows:
<pre class="man">

    [global]
	load printers = yes
	printing = cups
	printcap name = cups

    [printers]
	comment = All Printers
	path = /var/spool/samba
	browseable = no
	public = yes
	guest ok = yes
	writable = no
	printable = yes

    [print$]
	comment = Printer Drivers
	path = /etc/samba/drivers
	browseable = yes
	guest ok = no
	read only = yes
	write list = root

</pre>
This configuration assumes a FHS-compliant installation of SAMBA; adjust the [printers] and [print$] share paths accordingly on your system as needed.
<h3><a name="MICROSOFT_POSTSCRIPT_DRIVERS_FOR_WINDOWS">Microsoft Postscript Drivers For Windows</a></h3>
The base driver for Windows 2000 and higher is the Microsoft PostScript driver, which is available on any system running Windows 2000 or higher in the %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder for 32-bit drivers and %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit drivers.
<p>Copy the 32-bit drivers to the <i>/usr/share/cups/drivers</i> directory and the 64-bit drivers to the <i>/usr/share/cups/drivers/x64</i> directory exactly as named below:
<pre class="man">

    ps5ui.dll
    pscript.hlp
    pscript.ntf
    pscript5.dll

</pre>
<b>Note:</b> Unlike Windows, case is significant - make sure that you use the lowercase filenames shown above, otherwise <b>cupsaddsmb</b> will fail to export the drivers.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<b>cupsaddsmb</b> supports the following options:
<dl class="man">
<dt><b>-H </b><i>samba-server</i>
<dd style="margin-left: 5.0em">Specifies the SAMBA server which defaults to the CUPS server.
<dt><b>-U </b><i>samba-user</i>[<b>%</b><i>samba-password</i>]
<dd style="margin-left: 5.0em">Specifies the SAMBA print admin username which defaults to your current username.
If the username contains a percent (%) character, then the text following the percent is treated as the SAMBA password to use.
<dt><b>-a</b>
<dd style="margin-left: 5.0em">Exports all known printers.
Otherwise only the named printers are exported.
<dt><b>-h </b><i>cups-server</i>[<b>:</b><i>port</i>]
<dd style="margin-left: 5.0em">Specifies a different CUPS server to use.
<dt><b>-v</b>
<dd style="margin-left: 5.0em">Specifies that verbose information should be shown.
This is useful for debugging SAMBA configuration problems.
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>rpcclient</b>(1),
<b>smbclient</b>(1),
<b>smbd</b>(8),
<b>smb.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright &copy; 2007-2014 by Apple Inc.

</body>
</html>
Commit	Line	Data
c277f98c	1	<!DOCTYPE HTML>
94436c5a MS	2	<html>
	3	<!-- SECTION: Man Pages -->
	4	<head>
	5	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	6	<title>cupsaddsmb(8)</title>
	7	</head>
	8	<body>
	9	<h1 class="title">cupsaddsmb(8)</h1>
	10	<h2 class="title"><a name="NAME">Name</a></h2>
	11	cupsaddsmb - export printers to samba for windows clients
	12
	13	<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
c277f98c	14	<b>cupsaddsmb</b>
bf1bc4c6 MS	15	[
bf1bc4c6 MS	16	<b>-H</b>
c277f98c	17	<i>samba-server</i>
bf1bc4c6 MS	18	] [
bf1bc4c6 MS	19	<b>-U</b>
c277f98c	20	<i>samba-user[%samba-password]</i>
bf1bc4c6 MS	21	] [
bf1bc4c6 MS	22	<b>-h</b>
c277f98c	23	<i>cups-server[:port]</i>
bf1bc4c6 MS	24	] [
	25	<b>-v</b>
	26	]
	27	<b>-a</b>
94436c5a	28	<br>
c277f98c	29	<b>cupsaddsmb</b>
bf1bc4c6 MS	30	[
bf1bc4c6 MS	31	<b>-H</b>
c277f98c	32	<i>samba-server</i>
bf1bc4c6 MS	33	] [
bf1bc4c6 MS	34	<b>-U</b>
c277f98c	35	<i>samba-user[%samba-password]</i>
bf1bc4c6 MS	36	] [
bf1bc4c6 MS	37	<b>-h</b>
c277f98c	38	<i>cups-server[:port]</i>
bf1bc4c6 MS	39	] [
	40	<b>-v</b>
	41	]
	42	<i>printer</i>
	43	[ ...
	44	<i>printer</i>
	45	]
94436c5a	46	<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
bf1bc4c6 MS	47	The <b>cupsaddsmb</b> program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients.
	48	Depending on the SAMBA configuration, you may need to provide a password to export the printers.
	49	This program requires the Windows printer driver files described below.
	50	<h3><a name="SAMBA_CONFIGURATION">Samba Configuration</a></h3>
	51	<b>cupsaddsmb</b> uses the RPC-based printing support in SAMBA to provide printer drivers and PPD files to Windows client machines.
	52	In order to use this functionality, you must first configure the SAMBA
	53	<b>smb.conf</b>(5)
	54	file to support printing through CUPS and provide a printer driver download
94436c5a	55	share, as follows:
2909c66c	56	<pre class="man">
94436c5a MS	57
	58	[global]
	59	load printers = yes
	60	printing = cups
	61	printcap name = cups
	62
	63	[printers]
	64	comment = All Printers
	65	path = /var/spool/samba
	66	browseable = no
	67	public = yes
	68	guest ok = yes
	69	writable = no
	70	printable = yes
	71
	72	[print$]
	73	comment = Printer Drivers
	74	path = /etc/samba/drivers
	75	browseable = yes
	76	guest ok = no
	77	read only = yes
	78	write list = root
94436c5a	79
bf1bc4c6 MS	80	</pre>
	81	This configuration assumes a FHS-compliant installation of SAMBA; adjust the [printers] and [print$] share paths accordingly on your system as needed.
	82	<h3><a name="MICROSOFT_POSTSCRIPT_DRIVERS_FOR_WINDOWS">Microsoft Postscript Drivers For Windows</a></h3>
	83	The base driver for Windows 2000 and higher is the Microsoft PostScript driver, which is available on any system running Windows 2000 or higher in the %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder for 32-bit drivers and %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit drivers.
	84	<p>Copy the 32-bit drivers to the <i>/usr/share/cups/drivers</i> directory and the 64-bit drivers to the <i>/usr/share/cups/drivers/x64</i> directory exactly as named below:
2909c66c	85	<pre class="man">
94436c5a	86
94436c5a MS	87	ps5ui.dll
	88	pscript.hlp
	89	pscript.ntf
	90	pscript5.dll
94436c5a	91
94436c5a	92	</pre>
bf1bc4c6 MS	93	<b>Note:</b> Unlike Windows, case is significant - make sure that you use the lowercase filenames shown above, otherwise <b>cupsaddsmb</b> will fail to export the drivers.
	94	<h2 class="title"><a name="OPTIONS">Options</a></h2>
	95	<b>cupsaddsmb</b> supports the following options:
	96	<dl class="man">
	97	<dt><b>-H </b><i>samba-server</i>
	98	<dd style="margin-left: 5.0em">Specifies the SAMBA server which defaults to the CUPS server.
	99	<dt><b>-U </b><i>samba-user</i>[<b>%</b><i>samba-password</i>]
	100	<dd style="margin-left: 5.0em">Specifies the SAMBA print admin username which defaults to your current username.
	101	If the username contains a percent (%) character, then the text following the percent is treated as the SAMBA password to use.
	102	<dt><b>-a</b>
	103	<dd style="margin-left: 5.0em">Exports all known printers.
	104	Otherwise only the named printers are exported.
	105	<dt><b>-h </b><i>cups-server</i>[<b>:</b><i>port</i>]
	106	<dd style="margin-left: 5.0em">Specifies a different CUPS server to use.
	107	<dt><b>-v</b>
	108	<dd style="margin-left: 5.0em">Specifies that verbose information should be shown.
	109	This is useful for debugging SAMBA configuration problems.
	110	</dl>
94436c5a	111	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
bf1bc4c6 MS	112	<b>rpcclient</b>(1),
	113	<b>smbclient</b>(1),
	114	<b>smbd</b>(8),
	115	<b>smb.conf</b>(5),
	116	CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
94436c5a	117	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
f024f448	118	Copyright © 2007-2014 by Apple Inc.
94436c5a MS	119
	120	</body>
	121	</html>