Author: ug Date: Fri Mar 12 11:10:08 2010 New Revision: 61295 URL: http://svn.opensuse.org/viewcvs/yast?rev=61295&view=rev Log: printer docu updated (bnc#587441) Modified: trunk/autoinstallation/doc/PrinterSection.xml trunk/autoinstallation/doc/examples/example.printer.xml trunk/autoinstallation/package/autoyast2.changes Modified: trunk/autoinstallation/doc/PrinterSection.xml URL: http://svn.opensuse.org/viewcvs/yast/trunk/autoinstallation/doc/PrinterSection.xml?rev=61295&r1=61294&r2=61295&view=diff ============================================================================== --- trunk/autoinstallation/doc/PrinterSection.xml (original) +++ trunk/autoinstallation/doc/PrinterSection.xml Fri Mar 12 11:10:08 2010 @@ -21,19 +21,44 @@ <title> Printer </title> +<para> +The YaST printer module was made anew from scratch for openSUSE 11.1 and SUSE Linux Enterprise Server/Desktop 11. Currently the AutoYaST support for printing is limited to basic settings how the CUPS printing system is used on a client workstation to print via network. +</para> +<para> +Currently there is no AutoYaST support to set up local print queues. In particular when a USB printer is connected to a client workstation it is no longer possible to have a predefined configuration because USB printers are no longer accessed via a generic USB device node like "/dev/usb/lp0" but via a model specific device URI like "usb://ACME/FunPrinter?serial=1a2b3c". There is a serial number included so that a USB printer device URI works only for one particular device. Usually it is not possible to know the correct USB device URI in advance because it is determined by the CUPS backend "usb" during runtime when the particular device is connected depending on the actual values which the printer reports via the USB. +</para> +<para> +Intrinsic design of CUPS for printing in the network: +</para> +<para> +The CUPS daemon process (cupsd) of a CUPS network print server sends information about its print queues to a list of IP addresses (host addresses and/or broadcast addresses). +</para> +<para> +On client workstations (hosts that only send print jobs to servers) also a cupsd runs which listens to information from servers. There is a list of servers from which information is accepted. By default, information is accepted from all servers. +</para> +<para> +In this way, the queues of the server are available on the clients. Users on the clients can browse the queues on various servers. Therefore it is called "Browsing" and all what is to do on a client workstation to use CUPS in its default Browsing mode is to run the cupsd. The matching settings in the cupsd configuration file (/etc/cups/cupsd.conf) are "Browsing On" and "BrowseAllow all". +</para> +<para> +To limit from which CUPS servers browsing information is accepted, a setting like "BrowseAllow @LOCAL" accepts browsing information only from CUPS servers in the local network. +</para> +<para> +Multiple "BrowseAllow" entries like "BrowseAllow 192.168.100.1" and "BrowseAllow 192.168.200.0/255.255.255.0" can be used to accept browsing information only from particular hosts and/or networks. +</para> +<para> +CUPS Browsing information is recieved via UDP port 631. You may have to check firewall settings accordingly. +</para> +<para> +Alternatively if there is only one single CUPS server in the network, there is no need to use CUPS Browsing and have a CUPS daemon running on each client workstation. +</para> +<para> +Instead it is simpler to specify the CUPS server and access it directly by an entry like "ServerName 192.168.100.99" in /etc/cups/client.conf (only one such entry can be set). In this case the specified server is directly accessed so that a local running cupsd on a client workstation is no longer used so that it does no longer make sense to have it running. +</para> +<para> +The following is an example of a configuration section. The <cups_remote_server> entry contains the value of a ServerName entry in /etc/cups/client.conf. The <server_settings> section contains all values of the cupsd configuration file (/etc/cups/cupsd.conf) so that a complete <server_settings> section is required to get a reasonable cupsd configuration installed. +</para> + - <para> - Although Printer configuration, like other configurations can be - done manually, it is recommended to use the Configuration System to - create such a configuration because of the complexity and the range - of options offered by such modules. - </para> - <para> - Using the configuration system will guarantee that the options - provided are consistent. The following is an example of a - configuration section which was - created using the configuration system. - </para> &example.printer; </section> Modified: trunk/autoinstallation/doc/examples/example.printer.xml URL: http://svn.opensuse.org/viewcvs/yast/trunk/autoinstallation/doc/examples/example.printer.xml?rev=61295&r1=61294&r2=61295&view=diff ============================================================================== --- trunk/autoinstallation/doc/examples/example.printer.xml (original) +++ trunk/autoinstallation/doc/examples/example.printer.xml Fri Mar 12 11:10:08 2010 @@ -4,27 +4,129 @@ </title> <screen> <![CDATA[ -.... - <printer> - <default>lp</default> - <printcap config:type="list"> - <printcap_entry> - <cups-state>void</cups-state> - <ff config:type="boolean">true</ff> - <info></info> - <location></location> - <lprng-state>changed</lprng-state> - <name>lp</name> - <options> - <job-sheets>none,none</job-sheets> - </options> - <raw config:type="boolean">true</raw> - <type>yast2</type> - <uri>parallel:/dev/lp0</uri> - </printcap_entry> - </printcap> - </printer> -.... + <printer> + <cups_remote_server>192.168.100.99</cups_remote_server> + <server_settings> + <Browsing config:type="list"> + <listentry>On</listentry> + </Browsing> + <BrowseAllow config:type="list"> + <listentry>@LOCAL</listentry> + <listentry>192.168.100.1</listentry> + <listentry>192.168.200.0/255.255.255.0</listentry> + </BrowseAllow> + <BrowseOrder config:type="list"> + <listentry>allow,deny</listentry> + </BrowseOrder> + <LogLevel config:type="list"> + <listentry>info</listentry> + </LogLevel> + <Listen config:type="list"> + <listentry>localhost:631</listentry> + <listentry>/var/run/cups/cups.sock</listentry> + </Listen> + <DefaultAuthType config:type="list"> + <listentry>Basic</listentry> + </DefaultAuthType> + <SystemGroup config:type="list"> + <listentry>sys root</listentry> + </SystemGroup> + <sections config:type="list"> + <section> + <Key>Location</Key> + <Value>/</Value> + <Allow config:type="list"> + <listentry>127.0.0.2</listentry> + </Allow> + <Order config:type="list"> + <listentry>allow,deny</listentry> + </Order> + </section> + <section> + <Key>Location</Key> + <Value>/admin</Value> + <Encryption config:type="list"> + <listentry>Required</listentry> + </Encryption> + <Order config:type="list"> + <listentry>allow,deny</listentry> + </Order> + </section> + <section> + <Key>Location</Key> + <Value>/admin/conf</Value> + <AuthType config:type="list"> + <listentry>Default</listentry> + </AuthType> + <Require config:type="list"> + <listentry>user @SYSTEM</listentry> + </Require> + <Order config:type="list"> + <listentry>allow,deny</listentry> + </Order> + </section> + <section> + <Key>Policy</Key> + <Value>default</Value> + <subsection config:type="list"> + <listentry> + <Key>Limit</Key> + <Value>Send-Document Send-URI Hold-Job Release-Job Restart-Job Purge-Jobs Set-Job-Attributes Create-Job-Subscription Renew-Subscription Cancel-Subscription Get-Notifications Reprocess-Job Cancel-Current-Job Suspend-Current-Job Resume-Job CUPS-Move-Job</Value> + <Require config:type="list"> + <listentry>user @OWNER @SYSTEM</listentry> + </Require> + <Order config:type="list"> + <listentry>deny,allow</listentry> + </Order> + </listentry> + <listentry> + <Key>Limit</Key> + <Value>CUPS-Add-Modify-Printer CUPS-Delete-Printer CUPS-Add-Modify-Class CUPS-Delete-Class CUPS-Set-Default</Value> + <AuthType config:type="list"> + <listentry>Default</listentry> + </AuthType> + <Require config:type="list"> + <listentry>user @SYSTEM</listentry> + </Require> + <Order config:type="list"> + <listentry>deny,allow</listentry> + </Order> + </listentry> + <listentry> + <Key>Limit</Key> + <Value>Pause-Printer Resume-Printer Enable-Printer Disable-Printer Pause-Printer-After-Current-Job Hold-New-Jobs Release-Held-New-Jobs Deactivate-Printer Activate-Printer Restart-Printer Shutdown-Printer Startup-Printer Promote-Job Schedule-Job-After CUPS-Accept-Jobs CUPS-Reject-Jobs</Value> + <AuthType config:type="list"> + <listentry>Default</listentry> + </AuthType> + <Require config:type="list"> + <listentry>user @SYSTEM</listentry> + </Require> + <Order config:type="list"> + <listentry>deny,allow</listentry> + </Order> + </listentry> + <listentry> + <Key>Limit</Key> + <Value>Cancel-Job CUPS-Authenticate-Job</Value> + <Require config:type="list"> + <listentry>user @OWNER @SYSTEM</listentry> + </Require> + <Order config:type="list"> + <listentry>deny,allow</listentry> + </Order> + </listentry> + <listentry> + <Key>Limit</Key> + <Value>All</Value> + <Order config:type="list"> + <listentry>deny,allow</listentry> + </Order> + </listentry> + </subsection> + </section> + </sections> + </server_settings> + </printer> ]]> </screen> </example> Modified: trunk/autoinstallation/package/autoyast2.changes URL: http://svn.opensuse.org/viewcvs/yast/trunk/autoinstallation/package/autoyast2.changes?rev=61295&r1=61294&r2=61295&view=diff ============================================================================== --- trunk/autoinstallation/package/autoyast2.changes (original) +++ trunk/autoinstallation/package/autoyast2.changes Fri Mar 12 11:10:08 2010 @@ -1,4 +1,9 @@ ------------------------------------------------------------------- +Fri Mar 12 11:09:28 CET 2010 - ug@suse.de + +- printer docu updated (bnc#587441) + +------------------------------------------------------------------- Thu Mar 11 11:30:05 CET 2010 - ug@suse.de - location for files added to UI -- To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org For additional commands, e-mail: yast-commit+help@opensuse.org