From e30beda16217f304b90ac1d6fe27e7f1bb37aa5b Mon Sep 17 00:00:00 2001 From: Gabor Pali Date: Fri, 24 Oct 2008 23:18:46 +0000 Subject: [PATCH] Adjust whitespace to the structural changes of my previous commit, translators may ignore this --- en_US.ISO8859-1/articles/cups/article.sgml | 384 ++++++++++----------- 1 file changed, 190 insertions(+), 194 deletions(-) diff --git a/en_US.ISO8859-1/articles/cups/article.sgml b/en_US.ISO8859-1/articles/cups/article.sgml index 8cc8ef41e5..1139237759 100644 --- a/en_US.ISO8859-1/articles/cups/article.sgml +++ b/en_US.ISO8859-1/articles/cups/article.sgml @@ -57,222 +57,217 @@ url="http://www.cups.org/">. - - Installing the CUPS Print Server + + Installing the CUPS Print Server - CUPS can be installed from ports - or by using a precompiled binary package. To install - CUPS from ports, issue the following - command from a root terminal: + CUPS can be installed from ports or + by using a precompiled binary package. To install + CUPS from ports, issue the following + command from a root terminal: - &prompt.root; cd /usr/ports/print/cups && make install clean + &prompt.root; cd /usr/ports/print/cups && make install clean - To install CUPS using a - precompiled binary, issue the following command from a root - terminal: + To install CUPS using a precompiled + binary, issue the following command from a root terminal: - &prompt.root; pkg_add -r cups + &prompt.root; pkg_add -r cups - Other optional, but recommended, ports or packages are - print/gutenprint-cups and - print/hplip, both of which add - drivers and utilities for a variety of printers. Once - installed, the CUPS configuration - files can be found in the directory - /usr/local/etc/cups. - + Other optional, but recommended, ports or packages are + print/gutenprint-cups and + print/hplip, both of which add + drivers and utilities for a variety of printers. Once installed, + the CUPS configuration files can be + found in the directory + /usr/local/etc/cups. + - - Configuring the CUPS Print Server + + Configuring the CUPS Print Server - After installation, a few files must edited in order to - configure the CUPS server. First, - create or modify, as the case may be, the file - /etc/devfs.rules and add the following - information to set the proper permissions on all potential - printer devices and to associate printers with the cups user - group: + After installation, a few files must edited in order to + configure the CUPS server. First, + create or modify, as the case may be, the file + /etc/devfs.rules and add the following + information to set the proper permissions on all potential printer + devices and to associate printers with the + cups user group: - [system=10] + [system=10] add path 'unlpt*' mode 0660 group cups add path 'ulpt*' mode 0660 group cups add path 'lpt*' mode 0660 group cups - Next, add two lines to /etc/rc.conf - as follows: + Next, add two lines to /etc/rc.conf as + follows: - cupsd_enable="YES" + cupsd_enable="YES" devfs_system_ruleset="system" - These two entries will start the - CUPS print server on boot and invoke - the local devfs rule created above, respectively. + These two entries will start the + CUPS print server on boot and invoke + the local devfs rule created above, respectively. - In order to enable CUPS printing - under certain µsoft.windows; clients, the line below - should be - uncommented in /usr/local/etc/cups/mime.types - and /usr/local/etc/cups/mime.convs: + In order to enable CUPS printing + under certain µsoft.windows; clients, the line below should + be uncommented in + /usr/local/etc/cups/mime.types and + /usr/local/etc/cups/mime.convs: - application/octet-stream + application/octet-stream - Once these changes have been made, the &man.devfs.8; and - CUPS systems must both be restarted, - either by rebooting the computer or issuing the following two - commands in a root terminal: + Once these changes have been made, the &man.devfs.8; and + CUPS systems must both be restarted, + either by rebooting the computer or issuing the following two + commands in a root terminal: - &prompt.root; /etc/rc.d/devfs restart + &prompt.root; /etc/rc.d/devfs restart &prompt.root; /usr/local/etc/rc.d/cupsd restart + - + + Configuring Printers on the CUPS Print Server - - Configuring Printers on the CUPS Print Server + After the CUPS system has been + installed and configured, the administrator can begin configuring + the local printers attached to the CUPS + print server. This part of the process is very similar, if not + identical, to configuring CUPS printers + on other &unix;-based operating systems, such as a &linux; + distribution. - After the CUPS system has been - installed and configured, the administrator can begin configuring - the local printers attached to the - CUPS print server. This part of the - process is very similar, if not identical, to configuring - CUPS printers on other &unix;-based - operating systems, such as a &linux; distribution. + The primary means for managing and administering the + CUPS server is through the web-based + interface, which can be found by launching a web browser and + entering in the + browser's URL bar. If the CUPS server + is on another machine on the network, substitute the server's + local IP addresss for + localhost. The CUPS + web interface is fairly 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 + settings, such as whether to share published printers connected to + the system, whether to allow remote administration of the + CUPS server, and whether to allow users + additional access and privileges to the printers and print + jobs. - The primary means for managing and administering the - CUPS server is through the web-based - interface, which can be found by launching a web browser and - entering in the - browser's URL bar. If the CUPS - server is on another machine on the network, substitute the - server's local IP addresss for - localhost. The CUPS - web interface is fairly 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 settings, such as whether to share - published printers connected to the system, whether to allow - remote administration of the CUPS - server, and whether to allow users additional access and - privileges to the printers and print jobs. + Adding a printer is generally as easy as clicking Add + Printer at the Administration screen of the + CUPS web interface, or clicking one of + the New Printers Found buttons also at the + Administration screen. When presented with the + Device drop-down box, simply select the desired + locally-attached printer, and then continue through the process. + If one has added the print/gutenprint-cups or print/hplip ports or packages as + referenced above, then additional print drivers will be available + in the subsequent screens that might provide more stability or + features. + - Adding a printer is generally as easy as clicking - Add Printer at the Administration screen of - the CUPS web interface, or clicking - one of the New Printers Found buttons also - at the Administration screen. When presented with the - Device drop-down box, simply select the - desired locally-attached printer, and then continue through the - process. If one has added the - print/gutenprint-cups or - print/hplip ports or packages as - referenced above, then additional print drivers will be available - in the subsequent screens that might provide more stability or - features. - + + Configuring CUPS Clients - - Configuring CUPS Clients + Once the CUPS server has been + configured and printers have been added and published to the + network, the next step is to configure the clients, or the + machines that are going to access the + CUPS server. If one has a single + desktop machine that is acting as both server and client, then + much of this information may not be needed. - Once the CUPS server has been - configured and printers have been added and published to the - network, the next step is to configure the clients, or the - machines that are going to access the - CUPS server. If one has a single - desktop machine that is acting as both server and client, then - much of this information may not be needed. + + &unix; Clients - - &unix; Clients - - CUPS will also need to be - installed on your &unix; clients. Once - CUPS is installed on the clients, - then CUPS printers that are - shared across the network are often automatically discovered by - the printer managers for various desktop environments such as - GNOME or - KDE. Alternatively, one can access - the local CUPS interface on the - client machine at and - click on Add Printer in the Administration - section. When presented with the Device - drop-down box, simply select the networked - CUPS printer, if it was - automatically discovered, or select ipp or - http and enter the IPP or - HTTP URI of the networked - CUPS printer, usually in one of the - two following syntaxes: + CUPS will also need to be + installed on your &unix; clients. Once + CUPS is installed on the clients, + then CUPS printers that are shared + across the network are often automatically discovered by the + printer managers for various desktop environments such as + GNOME or + KDE. Alternatively, one can access + the local CUPS interface on the + client machine at and + click on Add Printer in the Administration + section. When presented with the Device + drop-down box, simply select the networked + CUPS printer, if it was automatically + discovered, or select ipp or + http and enter the IPP or + HTTP URI of the networked + CUPS printer, usually in one of the + two following syntaxes: ipp://server-name-or-ip/printers/printername http://server-name-or-ip:631/printers/printername - If the CUPS clients have - difficulty finding other CUPS - printers shared across the network, sometimes it is helpful to - add or create a file - /usr/local/etc/cups/client.conf with a - single entry as follows: + If the CUPS clients have + difficulty finding other CUPS + printers shared across the network, sometimes it is helpful to + add or create a file + /usr/local/etc/cups/client.conf with a + single entry as follows: - ServerName server-ip + ServerName server-ip - In this case, server-ip would be replaced by the local - IP address of the - CUPS server on the network. - + In this case, server-ip would be + replaced by the local IP address of the + CUPS server on the network. + - - &windows; Clients + + &windows; Clients - Versions of &windows; prior to XP did not have the - capability to natively network with - IPP-based printers. However, &windowsxp; - and later versions do have this capability. Therefore, to - add a CUPS printer in these - versions of &windows; is quite easy. Generally, the &windows; - administrator will run the &windows; - Add Printer wizard, select Network - Printer and then enter the URI - in the following syntax: + Versions of &windows; prior to XP did not have the + capability to natively network with IPP-based + printers. However, &windowsxp; and later versions do have this + capability. Therefore, to add a CUPS + printer in these versions of &windows; is quite easy. + Generally, the &windows; administrator will run the &windows; + Add Printer wizard, select Network + Printer and then enter the URI in + the following syntax: - http://server-name-or-ip:631/printers/printername + http://server-name-or-ip:631/printers/printername - If one has an older version of &windows; without native - IPP printing support, then the general - means of connecting to a CUPS - printer is to use - net/samba3 and - CUPS together, which is a topic - outside the scope of this chapter. - - + If one has an older version of &windows; without native + IPP printing support, then the general means + of connecting to a CUPS printer is to + use net/samba3 and + CUPS together, which is a topic + outside the scope of this chapter. + + - - CUPS Troubleshooting + + CUPS Troubleshooting - Difficulties with CUPS often lies - in permissions. First, double check the &man.devfs.8; - permissions as outlined above. Next, check the actual - permissions of the devices created in the file system. It is - also helpful to make sure your user is a member of the - cups group. If the permissions check boxes - in the Administration section of the - CUPS web interface do not seem to be - working, another fix might be to manually backup the main - CUPS configuration file located at - /usr/local/etc/cups/cupsd.conf and edit the - various configuration options and try different combinations of - configuration options. One sample - /usr/local/etc/cups/cupsd.conf to test is - listed below. Please note that this sample - cupsd.conf file sacrifices security for - easier configuration; once the administrator successfully - connnects to the CUPS server and - configures the clients, it is advisable to revisit this - configuration file and begin locking down access. + Difficulties with CUPS often lies + in permissions. First, double check the &man.devfs.8; permissions + as outlined above. Next, check the actual permissions of the + devices created in the file system. It is also helpful to make + sure your user is a member of the cups + group. If the permissions check boxes in the Administration + section of the CUPS web interface do + not seem to be working, another fix might be to manually backup + the main CUPS configuration file + located at /usr/local/etc/cups/cupsd.conf and + edit the various configuration options and try different + combinations of configuration options. One sample + /usr/local/etc/cups/cupsd.conf to test is + listed below. Please note that this sample + cupsd.conf file sacrifices security for + easier configuration; once the administrator successfully + connnects to the CUPS server and + configures the clients, it is advisable to revisit this + configuration file and begin locking down access. - # Log general information in error_log - change "info" to "debug" for + # Log general information in error_log - change "info" to "debug" for # troubleshooting... LogLevel info @@ -351,32 +346,33 @@ CUPS-Delete-Class CUPS-Accept-Jobs CUPS-Reject-Jobs CUPS-Set-Default> Order deny,allow </Limit> </Policy> - + - - Fine Tuning CUPS-Related Ports + + Fine Tuning CUPS-Related Ports - If CUPS is going to serve as the - primary printing system, then one may choose to optionally add - certain knobs to /etc/make.conf that will - emphasize CUPS over other printing - options. Some of these knobs that one may want to add - are: + If CUPS is going to serve as the + primary printing system, then one may choose to optionally add + certain knobs to /etc/make.conf that will + emphasize CUPS over other printing + options. Some of these knobs that one may want to + add are: - WITH_CUPS=YES + WITH_CUPS=YES CUPS_OVERWRITE_BASE=YES WITHOUT_LPR=YES - The first knob, WITH_CUPS, adds - CUPS support to ports where - applicable. The second knob, CUPS_OVERWRITE_BASE, will fix - certain symlinks and paths that would otherwise apply to the - default &os; printing system, LPR, - and will prevent these fixes from being reverted upon the next - buildworld system upgrade. The third knob, WITHOUT_LPR, will - prevent LPR support from being added - to ports where applicable. - + The first knob, WITH_CUPS, adds + CUPS support to ports where applicable. + The second knob, CUPS_OVERWRITE_BASE, will fix + certain symlinks and paths that would otherwise apply to the + default &os; printing system, LPR, and + will prevent these fixes from being reverted upon the next + buildworld system upgrade. The third + knob, WITHOUT_LPR, will prevent + LPR support from being added to ports + where applicable. +