Changeset 3413 for pykota/trunk/docs/scripts.sgml
- Timestamp:
- 09/27/08 22:02:37 (16 years ago)
- Files:
-
- 1 modified
Legend:
- Unmodified
- Added
- Removed
-
pykota/trunk/docs/scripts.sgml
r2551 r3413 4 4 <title>Useful Shell Scripts</title> 5 5 <para>Last modified on $Date$</para> 6 6 7 7 <para> 8 8 <application>PyKota</application> comes with a number of shell scripts which … … 10 10 them to your own configuration. All are installed in the <filename>/usr/share/pykota</filename> 11 11 directory. 12 </para> 13 12 </para> 13 14 14 <sect1> 15 15 <title>waitprinter.sh</title> 16 16 <para> 17 This script which accepts a printer's hostname or <acronym>IP</acronym> address as its first parameter 17 This script which accepts a printer's hostname or <acronym>IP</acronym> address as its first parameter 18 18 is used to wait for a printer which supports the <acronym>SNMP</acronym> protocol to be in <literal>idle</literal> state. 19 19 It exits as soon as the printer is <literal>idle</literal>, else loops forever. 20 20 </para> 21 21 22 22 <para> 23 23 When defining an hardware <literal>accounter</literal> for a printer, it is important to wait for the printer being … … 26 26 value will be lower than expected with regard to the real job's size. 27 27 </para> 28 28 29 29 <para> 30 30 <command>waitprinter.sh</command> can be used to be sure that <application>PyKota</application> 31 waits until no job is being printed, and no paper sheet is travelling inside the printer. 31 waits until no job is being printed, and no paper sheet is travelling inside the printer. 32 32 </para> 33 33 34 34 <tip> 35 35 <title>Tip</title> … … 37 37 See the sample configuration file <filename>conf/pykota.conf.sample</filename> for examples. 38 38 </para> 39 </tip> 39 </tip> 40 40 </sect1> 41 41 42 42 <sect1> 43 43 <title>papwaitprinter.sh</title> 44 44 <para> 45 This script which accepts a printer's AppleTalk name as its first parameter 45 This script which accepts a printer's AppleTalk name as its first parameter 46 46 is used to wait for a printer which supports the <acronym>AppleTalk</acronym> protocol to be in <literal>idle</literal> state. 47 47 It exits as soon as the printer is <literal>idle</literal>, else loops forever. 48 48 </para> 49 49 50 50 <para> 51 51 When defining an hardware <literal>accounter</literal> for a printer, it is important to wait for the printer being … … 54 54 value will be lower than expected with regard to the real job's size. 55 55 </para> 56 56 57 57 <para> 58 58 <command>papwaitprinter.sh</command> can be used to be sure that <application>PyKota</application> 59 waits until no job is being printed, and no paper sheet is travelling inside the printer. 60 </para> 61 59 waits until no job is being printed, and no paper sheet is travelling inside the printer. 60 </para> 61 62 62 <tip> 63 63 <title>Tip</title> … … 65 65 See the sample configuration file <filename>conf/pykota.conf.sample</filename> for examples. 66 66 </para> 67 </tip> 67 </tip> 68 68 </sect1> 69 69 70 70 <sect1> 71 71 <title>mailandpopup.sh</title> … … 75 75 whenever print quota is low or reached. 76 76 </para> 77 77 78 78 <para> 79 For this script to work successfully, you may need to have a <application>Samba</application> 79 For this script to work successfully, you may need to have a <application>Samba</application> 80 80 Primary Domain Controller. Some modifications may be needed in other configurations. 81 81 </para> 82 82 83 83 <tip> 84 84 <title>Tip</title> … … 86 86 See the sample configuration file <filename>conf/pykota.conf.sample</filename> for examples. 87 87 </para> 88 </tip> 88 </tip> 89 89 </sect1> 90 90 91 91 <sect1> 92 92 <title>pagecount.pl</title> … … 97 97 It accepts the printer's hostname or <acronym>IP</acronym> address as its first parameter, 98 98 and the optional <acronym>TCP</acronym> port as its second parameter (it defaults to 9100). 99 </para> 100 99 </para> 100 101 101 <para> 102 102 Most of the time you'll use this script in combination with a script which waits for the printer 103 103 to be in <literal>idle</literal> state, in something like : 104 <screen> 104 <screen> 105 105 accounter: hardware(somewaitscript.sh && pagecount.pl %(printer)s) 106 106 </screen> 107 107 </para> 108 108 109 109 <tip> 110 110 <title>Tip</title> … … 112 112 See the sample configuration file <filename>conf/pykota.conf.sample</filename> for examples. 113 113 </para> 114 </tip> 114 </tip> 115 115 </sect1> 116 116 </chapter>