os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Wrap long lines in the CUPS article.

Browse source 
Remove a couple of warnings that igor was giving, mostly
about wrapping long lines.  In one instance, there was a
redundant word removed.
This commit is contained in:
Benedict Reuschling 2019-03-23 02:02:12 +00:00
parent 049909df2c
commit 54e3ba2ec7
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=52890
1 changed files with 99 additions and 79 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

178
en_US.ISO8859-1/articles/cups/article.xml
View file

@ -1,12 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?> <?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd"> "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">
<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> <article xmlns="http://docbook.org/ns/docbook"
<info><title>CUPS on FreeBSD</title> xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:lang="en">
<info>
<title>CUPS on FreeBSD</title>
<authorgroup> <authorgroup>
<author><personname><firstname>Chess</firstname><surname>Griffin</surname></personname><affiliation> <author>
<address><email>chess@chessgriffin.com</email></address> <personname>
<firstname>Chess</firstname>
<surname>Griffin</surname>
</personname>
<affiliation>
<address>
<email>chess@chessgriffin.com</email>
</address>
</affiliation></author> </affiliation></author>
</authorgroup> </authorgroup>
@ -25,7 +35,8 @@
</info> </info>
<sect1 xml:id="printing-cups"> <sect1 xml:id="printing-cups">
<title>An Introduction to the Common Unix Printing System (CUPS)</title> <title>An Introduction to the Common Unix Printing System
(CUPS)</title>
<indexterm><primary>printing</primary></indexterm> <indexterm><primary>printing</primary></indexterm>
<indexterm><primary>CUPS</primary></indexterm> <indexterm><primary>CUPS</primary></indexterm>
@ -42,30 +53,33 @@
(<acronym>LPD</acronym>), Server Message Block (<acronym>LPD</acronym>), Server Message Block
(<acronym>SMB</acronym>), and AppSocket (aka JetDirect) (<acronym>SMB</acronym>), and AppSocket (aka JetDirect)
protocols are also supported with reduced functionality. protocols are also supported with reduced functionality.
<application>CUPS</application> adds network printer browsing and <application>CUPS</application> adds network printer browsing
PostScript Printer Description (<acronym>PPD</acronym>) based and PostScript Printer Description (<acronym>PPD</acronym>)
printing options to support real-world printing under &unix;. As based printing options to support real-world printing under
a result, <application>CUPS</application> is ideally-suited for &unix;. As a result, <application>CUPS</application> is
sharing and accessing printers in mixed environments of &os;, ideally-suited for sharing and accessing printers in mixed
&linux;, &macos;&nbsp;X, or &windows;.</para> environments of &os;, &linux;, &macos;&nbsp;X, or
&windows;.</para>
<para>The main site for <application>CUPS</application> is <uri xlink:href="http://www.cups.org/">http://www.cups.org/</uri>.</para> <para>The main site for <application>CUPS</application> is <uri
xlink:href="http://www.cups.org/">http://www.cups.org/</uri>.</para>
</sect1> </sect1>
<sect1 xml:id="printing-cups-install"> <sect1 xml:id="printing-cups-install">
<title>Installing the CUPS Print Server</title> <title>Installing the CUPS Print Server</title>
<para>To install <application>CUPS</application> using a precompiled <para>To install <application>CUPS</application> using a
binary, issue the following command from a root terminal:</para> precompiled binary, issue the following command from a root
terminal:</para>
<screen>&prompt.root; <userinput>pkg install cups</userinput></screen> <screen>&prompt.root; <userinput>pkg install cups</userinput></screen>
<para>Other optional, but recommended, packages are <para>Other optional, but recommended, packages are
<package>print/gutenprint-cups</package> and <package>print/gutenprint-cups</package> and
<package>print/hplip</package>, both of which add <package>print/hplip</package>, both of which add
drivers and utilities for a variety of printers. Once installed, drivers and utilities for a variety of printers. Once
the <application>CUPS</application> configuration files can be installed, the <application>CUPS</application> configuration
found in the directory files can be found in the directory
<filename>/usr/local/etc/cups</filename>.</para> <filename>/usr/local/etc/cups</filename>.</para>
</sect1> </sect1>
@ -76,9 +90,9 @@
configure the <application>CUPS</application> server. First, configure the <application>CUPS</application> server. First,
create or modify, as the case may be, the file create or modify, as the case may be, the file
<filename>/etc/devfs.rules</filename> and add the following <filename>/etc/devfs.rules</filename> and add the following
information to set the proper permissions on all potential printer information to set the proper permissions on all potential
devices and to associate printers with the printer devices and to associate printers with the <systemitem
<systemitem class="groupname">cups</systemitem> user group:</para> class="groupname">cups</systemitem> user group:</para>
<programlisting>[system=10] <programlisting>[system=10]
add path 'unlpt*' mode 0660 group cups add path 'unlpt*' mode 0660 group cups
@ -91,8 +105,8 @@ add path 'usb/<replaceable>X</replaceable>.<replaceable>Y</replaceable>.<replace
<replaceable>Y</replaceable>, and <replaceable>Z</replaceable> <replaceable>Y</replaceable>, and <replaceable>Z</replaceable>
should be replaced with the target USB device listed in the should be replaced with the target USB device listed in the
<filename>/dev/usb</filename> directory that <filename>/dev/usb</filename> directory that
corresponds to the printer. To find the correct device, examine corresponds to the printer. To find the correct device,
the output of &man.dmesg.8;, where examine the output of &man.dmesg.8;, where
<filename>ugen<replaceable>X</replaceable>.<replaceable>Y</replaceable></filename> <filename>ugen<replaceable>X</replaceable>.<replaceable>Y</replaceable></filename>
lists the printer device, which is a symbolic link to a USB lists the printer device, which is a symbolic link to a USB
device in <filename>/dev/usb</filename>.</para> device in <filename>/dev/usb</filename>.</para>
@ -129,41 +143,44 @@ devfs_system_ruleset="system"</programlisting>
<title>Configuring Printers on the CUPS Print Server</title> <title>Configuring Printers on the CUPS Print Server</title>
<para>After the <application>CUPS</application> system has been <para>After the <application>CUPS</application> system has been
installed and configured, the administrator can begin configuring installed and configured, the administrator can begin
the local printers attached to the <application>CUPS</application> configuring the local printers attached to the
print server. This part of the process is very similar, if not <application>CUPS</application> print server. This part of the
identical, to configuring <application>CUPS</application> printers process is very similar, if not identical, to configuring
on other &unix;-based operating systems, such as a &linux; <application>CUPS</application> printers on other &unix;-based
distribution.</para> operating systems, such as a &linux; distribution.</para>
<para>The primary means for managing and administering the <para>The primary means for managing and administering the
<application>CUPS</application> server is through the web-based <application>CUPS</application> server is through the web-based
interface, which can be found by launching a web browser and interface, which can be found by launching a web browser and
entering <uri xlink:href="http://localhost:631">http://localhost:631</uri> in the entering <uri
browser's URL bar. If the <application>CUPS</application> server xlink:href="http://localhost:631">http://localhost:631</uri>
is on another machine on the network, substitute the server's in the browser's URL bar. If the
local <acronym>IP</acronym> address for <application>CUPS</application> server is on another machine on
<systemitem>localhost</systemitem>. The <application>CUPS</application> the network, substitute the server's local <acronym>IP</acronym>
web interface is fairly self-explanatory, as there are sections address for <systemitem>localhost</systemitem>. The
for managing printers and print jobs, authorizing users, and more. <application>CUPS</application> web interface is fairly
Additionally, on the right-hand side of the Administration screen self-explanatory, as there are sections for managing printers
and print jobs, authorizing users, and more. Additionally, on
the right-hand side of the Administration screen
are several check-boxes allowing easy access to commonly-changed are several check-boxes allowing easy access to commonly-changed
settings, such as whether to share published printers connected to settings, such as whether to share published printers connected
the system, whether to allow remote administration of the to the system, whether to allow remote administration of the
<application>CUPS</application> server, and whether to allow users <application>CUPS</application> server, and whether to allow
additional access and privileges to the printers and print users additional access and privileges to the printers and print
jobs.</para> jobs.</para>
<para>Adding a printer is generally as easy as clicking <quote>Add <para>Adding a printer is generally as easy as clicking <quote>Add
Printer</quote> at the Administration screen of the Printer</quote> at the Administration screen of the
<application>CUPS</application> web interface, or clicking one of <application>CUPS</application> web interface, or clicking one
the <quote>New Printers Found</quote> buttons also at the of the <quote>New Printers Found</quote> buttons also at the
Administration screen. When presented with the Administration screen. When presented with the
<quote>Device</quote> drop-down box, simply select the desired <quote>Device</quote> drop-down box, simply select the desired
locally-attached printer, and then continue through the process. locally-attached printer, and then continue through the process.
If one has added the <package>print/gutenprint-cups</package> or <package>print/hplip</package> ports or packages as If one has added the <package>print/gutenprint-cups</package> or
referenced above, then additional print drivers will be available <package>print/hplip</package> ports or packages as referenced
in the subsequent screens that might provide more stability or above, then additional print drivers will be available in the
subsequent screens that might provide more stability or
features.</para> features.</para>
</sect1> </sect1>
@ -190,16 +207,17 @@ devfs_system_ruleset="system"</programlisting>
<application>GNOME</application> or <application>GNOME</application> or
<application>KDE</application>. Alternatively, one can access <application>KDE</application>. Alternatively, one can access
the local <application>CUPS</application> interface on the the local <application>CUPS</application> interface on the
client machine at <uri xlink:href="http://localhost:631">http://localhost:631</uri> and client machine at <uri
click on <quote>Add Printer</quote> in the Administration xlink:href="http://localhost:631">http://localhost:631</uri>
and click on <quote>Add Printer</quote> in the Administration
section. When presented with the <quote>Device</quote> section. When presented with the <quote>Device</quote>
drop-down box, simply select the networked drop-down box, simply select the networked
<application>CUPS</application> printer, if it was automatically <application>CUPS</application> printer, if it was
discovered, or select <literal>ipp</literal> or automatically discovered, or select <literal>ipp</literal> or
<literal>http</literal> and enter the <acronym>IPP</acronym> or <literal>http</literal> and enter the <acronym>IPP</acronym>
<acronym>HTTP</acronym> <acronym>URI</acronym> of the networked or <acronym>HTTP</acronym> <acronym>URI</acronym> of the
<application>CUPS</application> printer, usually in one of the networked <application>CUPS</application> printer, usually in
two following syntaxes:</para> one of the two following syntaxes:</para>
<programlisting>ipp://<replaceable>server-name-or-ip</replaceable>/printers/<replaceable>printername</replaceable></programlisting> <programlisting>ipp://<replaceable>server-name-or-ip</replaceable>/printers/<replaceable>printername</replaceable></programlisting>
@ -214,8 +232,8 @@ devfs_system_ruleset="system"</programlisting>
<programlisting>ServerName <replaceable>server-ip</replaceable></programlisting> <programlisting>ServerName <replaceable>server-ip</replaceable></programlisting>
<para>In this case, <replaceable>server-ip</replaceable> would be <para>In this case, <replaceable>server-ip</replaceable> would
replaced by the local <acronym>IP</acronym> address of the be replaced by the local <acronym>IP</acronym> address of the
<application>CUPS</application> server on the network.</para> <application>CUPS</application> server on the network.</para>
</sect2> </sect2>
@ -223,21 +241,22 @@ devfs_system_ruleset="system"</programlisting>
<title>&windows; Clients</title> <title>&windows; Clients</title>
<para>Versions of &windows; prior to XP did not have the <para>Versions of &windows; prior to XP did not have the
capability to natively network with <acronym>IPP</acronym>-based capability to natively network with
printers. However, &windowsxp; and later versions do have this <acronym>IPP</acronym>-based printers. However, &windowsxp;
capability. Therefore, to add a <application>CUPS</application> and later versions do have this capability. Therefore, to add
printer in these versions of &windows; is quite easy. a <application>CUPS</application> printer in these versions of
Generally, the &windows; administrator will run the &windows; &windows; is quite easy. Generally, the &windows;
<literal>Add Printer</literal> wizard, select <literal>Network administrator will run the &windows; <literal>Add
Printer</literal> and then enter the <acronym>URI</acronym> in Printer</literal> wizard, select <literal>Network
the following syntax:</para> Printer</literal> and then enter the <acronym>URI</acronym>
in the following syntax:</para>
<programlisting>http://<replaceable>server-name-or-ip</replaceable>:631/printers/<replaceable>printername</replaceable></programlisting> <programlisting>http://<replaceable>server-name-or-ip</replaceable>:631/printers/<replaceable>printername</replaceable></programlisting>
<para>If one has an older version of &windows; without native <para>If one has an older version of &windows; without native
<acronym>IPP</acronym> printing support, then the general means <acronym>IPP</acronym> printing support, then the general
of connecting to a <application>CUPS</application> printer is to means of connecting to a <application>CUPS</application>
use <package>net/samba3</package> and printer is to use <package>net/samba3</package> and
<application>CUPS</application> together, which is a topic <application>CUPS</application> together, which is a topic
outside the scope of this chapter.</para> outside the scope of this chapter.</para>
</sect2> </sect2>
@ -247,20 +266,21 @@ devfs_system_ruleset="system"</programlisting>
<title>CUPS Troubleshooting</title> <title>CUPS Troubleshooting</title>
<para>Difficulties with <application>CUPS</application> often lies <para>Difficulties with <application>CUPS</application> often lies
in permissions. First, double check the &man.devfs.8; permissions in permissions. First, double check the &man.devfs.8;
as outlined above. Next, check the actual permissions of the permissions as outlined above. Next, check the actual
devices created in the file system. It is also helpful to make permissions of the devices created in the file system. It is
sure your user is a member of the <systemitem class="groupname">cups</systemitem> also helpful to make sure your user is a member of the
group. If the permissions check boxes in the Administration <systemitem class="groupname">cups</systemitem> group. If the
section of the <application>CUPS</application> web interface do permissions check boxes in the Administration section of the
not seem to be working, another fix might be to manually backup <application>CUPS</application> web interface do not seem to be
the main <application>CUPS</application> configuration file working, another fix might be to manually backup the main
located at <filename>/usr/local/etc/cups/cupsd.conf</filename> and <application>CUPS</application> configuration file
edit the various configuration options and try different located at <filename>/usr/local/etc/cups/cupsd.conf</filename>
and edit the various configuration options and try different
combinations of configuration options. One sample combinations of configuration options. One sample
<filename>/usr/local/etc/cups/cupsd.conf</filename> to test is <filename>/usr/local/etc/cups/cupsd.conf</filename> to test is
listed below. Please note that this sample listed below. Please note that this sample
<filename>cupsd.conf</filename> file sacrifices security for <filename>cupsd.conf</filename> sacrifices security for
easier configuration; once the administrator successfully easier configuration; once the administrator successfully
connects to the <application>CUPS</application> server and connects to the <application>CUPS</application> server and
configures the clients, it is advisable to revisit this configures the clients, it is advisable to revisit this