Index: Makefile =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/articles/cups/Makefile,v retrieving revision 1.1 diff -u -r1.1 Makefile --- Makefile 31 May 2008 13:30:22 -0000 1.1 +++ Makefile 24 Oct 2008 06:41:14 -0000 @@ -6,7 +6,6 @@ DOC?= article FORMATS?= html -WITH_ARTICLE_TOC?= YES INSTALL_COMPRESSED?=gz INSTALL_ONLY_COMPRESSED?= Index: article.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/articles/cups/article.sgml,v retrieving revision 1.1 diff -u -r1.1 article.sgml --- article.sgml 31 May 2008 13:30:22 -0000 1.1 +++ article.sgml 24 Oct 2008 06:41:14 -0000 @@ -11,7 +11,7 @@ Chess - Grifin + Griffin
chess@chessgriffin.com
 @@ -55,8 +55,9 @@ The main site for CUPS is . + - + Installing the CUPS Print Server CUPS can be installed from ports @@ -73,15 +74,15 @@ &prompt.root; pkg_add -r cups Other optional, but recommended, ports or packages are - print/gutenprint-cups and - print/hplip, both of which add + 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 After installation, a few files must edited in order to @@ -89,7 +90,7 @@ 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 + printer devices and to associate printers with the cups user group: [system=10] @@ -108,10 +109,12 @@ the local devfs rule created above, respectively. In order to enable CUPS printing - under certain µsoft.windows; clients, the line - application/octet-stream should be + 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. + and /usr/local/etc/cups/mime.convs: + + application/octet-stream Once these changes have been made, the &man.devfs.8; and CUPS systems must both be restarted, @@ -121,9 +124,9 @@ &prompt.root; /etc/rc.d/devfs restart &prompt.root; /usr/local/etc/rc.d/cupsd restart - + - + Configuring Printers on the CUPS Print Server After the CUPS system has been @@ -137,11 +140,11 @@ 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 http://localhost:631 in the + 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 + 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 @@ -153,21 +156,21 @@ privileges to the printers and print jobs. Adding a printer is generally as easy as clicking - Add Printer at the Administration screen of + Add Printer at the Administration screen of the CUPS web interface, or clicking - one of the New Printers Found buttons also + one of the New Printers Found buttons also at the Administration screen. When presented with the - Device drop-down box, simply select 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 + 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 Once the CUPS server has been @@ -178,7 +181,7 @@ desktop machine that is acting as both server and client, then much of this information may not be needed. - + &unix; Clients CUPS will also need to be @@ -190,9 +193,9 @@ GNOME or KDE. Alternatively, one can access the local CUPS interface on the - client machine at http://localhost:631 and - click on Add Printer in the Administration - section. When presented with the Device + 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 @@ -201,9 +204,9 @@ CUPS printer, usually in one of the two following syntaxes: - ipp://server-name-or-ip/printers/printername + ipp://server-name-or-ip/printers/printername - http://server-name-or-ip:631/printers/printername + http://server-name-or-ip:631/printers/printername If the CUPS clients have difficulty finding other CUPS @@ -212,14 +215,14 @@ /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 + In this case, server-ip would be replaced by the local IP address of the CUPS server on the network. - + - + &windows; Clients Versions of &windows; prior to XP did not have the @@ -233,7 +236,7 @@ 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 @@ -242,19 +245,19 @@ net/samba3 and CUPS together, which is a topic outside the scope of this chapter. - - + + - + 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 filesystem. It is + 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 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 @@ -348,33 +351,32 @@ Order deny,allow </Limit> </Policy> - + - + 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 + options. Some of these knobs that one may want to add are: WITH_CUPS=YES CUPS_OVERWRITE_BASE=YES WITHOUT_LPR=YES - The first knob, WITH_CUPS, adds + The first knob, WITH_CUPS, adds CUPS support to ports where - applicable. The second knob, CUPS_OVERWRITE_BASE, will fix + 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 + buildworld system upgrade. The third knob, WITHOUT_LPR, will prevent LPR support from being added to ports where applicable. - - +