1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2 3<html> 4 <head> 5 <meta name="generator" content="HTML Tidy, see www.w3.org"> 6 <title>lpc - Administration Program</title> 7 <meta name="GENERATOR" content= 8 "Modular DocBook HTML Stylesheet Version 1.7"> 9 <link rel="HOME" title=" LPRng Reference Manual" href= 10 "index.htm"> 11 <link rel="PREVIOUS" title="lprm Job Selection" href= 12 "x4719.htm"> 13 <link rel="NEXT" title= 14 "Queue Management - enable, disable, up, down" href= 15 "x4771.htm"> 16 </head> 17 18 <body class="CHAPTER" bgcolor="#FFFFFF" text="#000000" link= 19 "#0000FF" vlink="#840084" alink="#0000FF"> 20 <div class="NAVHEADER"> 21 <table summary="Header navigation table" width="100%" border= 22 "0" cellpadding="0" cellspacing="0"> 23 <tr> 24 <th colspan="3" align="center">LPRng Reference Manual: 5 25 Sep 2003 (For LPRng-3.8.22)</th> 26 </tr> 27 28 <tr> 29 <td width="10%" align="left" valign="bottom"><a href= 30 "x4719.htm" accesskey="P">Prev</a></td> 31 32 <td width="80%" align="center" valign="bottom"> 33 </td> 34 35 <td width="10%" align="right" valign="bottom"><a href= 36 "x4771.htm" accesskey="N">Next</a></td> 37 </tr> 38 </table> 39 <hr align="LEFT" width="100%"> 40 </div> 41 42 <div class="CHAPTER"> 43 <h1><a name="LPC"></a>Chapter 9. <b class= 44 "APPLICATION">lpc</b> - Administration Program</h1> 45 46 <div class="TOC"> 47 <dl> 48 <dt><b>Table of Contents</b></dt> 49 50 <dt>9.1. <a href="lpc.htm#AEN4753">Informational Commands 51 - status, flush, active, reread</a></dt> 52 53 <dt>9.2. <a href="x4771.htm">Queue Management - enable, 54 disable, up, down</a></dt> 55 56 <dt>9.3. <a href="x4783.htm">Printing Management - start, 57 stop, up, down</a></dt> 58 59 <dt>9.4. <a href="x4792.htm">Problem Management - abort, 60 redo, kill</a></dt> 61 62 <dt>9.5. <a href="x4798.htm">Job Scheduling - topq, 63 holdall, noholdall, hold, release</a></dt> 64 65 <dt>9.6. <a href="lpcredirect.htm">Queue Management - 66 class, redirect, move</a></dt> 67 </dl> 68 </div> 69 70 <p>The <b class="APPLICATION">lpc</b> command is the main way 71 that the <b class="APPLICATION">lpd</b> server is controlled. 72 Here is the help information displayed by the command:</p> 73 74 <div class="INFORMALEXAMPLE"> 75 <a name="AEN4734"></a> 76<pre class="SCREEN"> 77 <samp class="PROMPT">h4: {308} %</samp> <kbd class= 78"USERINPUT">lpc -=</kbd> 79 lpc: Illegal option '=' 80 usage: lpc [-Ddebuglevel][-Pprinter][-Shost][-Uusername][-V] [command] 81 with no command, reads from stdin 82 -Ddebuglevel - debug level 83 -Pprinter - printer or printer@host 84 -Shost - connect to lpd server on host 85 -Uuser - identify command as coming from user 86 -V - increase information verbosity 87 commands: 88 active (printer[@host]) - check for active server 89 abort (printer[@host] | all) - stop server 90 class printer[@host] (class | off) - show/set class printing 91 disable (printer[@host] | all) - disable queueing 92 debug (printer[@host] | all) debugparms - set debug level for printer 93 down (printer[@host] | all) - disable printing and queueing 94 enable (printer[@host] | all) - enable queueing 95 hold (printer[@host] | all) (name[@host] | job | all)* - hold job 96 holdall (printer[@host] | all) - hold all jobs on 97 kill (printer[@host] | all) - stop and restart server 98 lpd (printer[@host]) - get LPD PID 99 lpq (printer[@host] | all) (name[@host] | job | all)* - run <b 100 class="APPLICATION">lpq</b> 101 lprm (printer[@host] | all) (name[@host]|host|job| all)* - run <b 102 class="APPLICATION">lprm</b> 103 msg printer message text- set status message 104 move printer (user|jobid)* target - move jobs to new queue 105 noholdall (printer[@host] | all)- hold all jobs off 106 printcap(printer[@host] | all) - report printcap values 107 quit - exit LPC 108 redirect(printer[@host] | all) (printer@host | off )* - redirect jobs 109 redo (printer[@host] | all) (name[@host] | job | all)* - redo jobs 110 release (printer[@host] | all) (name[@host] | job | all)* - release jobs 111 reread (printer[@host]) - LPD reread database information 112 start (printer[@host] | all) - start printing 113 status (printer[@host] | all) - status of printers 114 stop (printer[@host] | all) - stop printing 115 topq (printer[@host] | all) (name[@host] | job | all)* - reorder job 116 up (printer[@host] | all) - enable printing and queueing 117 diagnostic: 118 defaultq - show default queue for LPD server 119 defaults - show default configuration values 120 client (printer | all) - client config and printcap information 121 server (printer | all) - server config and printcap 122</pre> 123 </div> 124 <br> 125 <br> 126 127 <p>Most of the <b class="APPLICATION">lpc</b> command line 128 options are common to all <a href="lprngclients.htm"><b 129 class="APPLICATION">LPRng</b> Clients</a>, with the exception 130 of the <var class="LITERAL">-S server</var> literal. This 131 option allows the <b class="APPLICATION">lpd</b> host to be 132 explicitly specified.</p> 133 134 <p>The <b class="APPLICATION">lpc</b> commands can be 135 classified as <span class="emphasis"><i class= 136 "EMPHASIS">informational</i></span>, <span class= 137 "emphasis"><i class="EMPHASIS">queue management</i></span>, 138 <span class="emphasis"><i class="EMPHASIS">problem 139 management</i></span>, <span class="emphasis"><i class= 140 "EMPHASIS">job scheduling</i></span>, and <span class= 141 "emphasis"><i class="EMPHASIS">diagnostic</i></span>.</p> 142 143 <div class="SECT1"> 144 <h1 class="SECT1"><a name="AEN4753">9.1. Informational 145 Commands - status, flush, active, reread</a></h1> 146 147 <p>The <tt class="COMMAND">lpc status</tt> command displays 148 the current status of various activities of interest to the 149 system administrator. This information includes the process 150 ID of the server and other processes.</p> 151 152 <p>During normal operation, when requested for job status 153 information the <b class="APPLICATION">lpd</b> server will 154 create this information and then save it in a status cache. 155 When successive requests for the same information arrive, 156 the cache is checked to see if the information is already 157 in the cache and there have been no status changes. If this 158 is the case, the cached status information is used. The <tt 159 class="COMMAND">lpc flush</tt> command will flush (delete) 160 this cache information and cause the <b class= 161 "APPLICATION">lpd</b> server to regenerate it from the 162 original job files.</p> 163 164 <p>The <tt class="COMMAND">lpc active</tt> command connects 165 to the print server and gets the Process ID of the <b 166 class="APPLICATION">lpd</b> process. This is useful to 167 determine if the <b class="APPLICATION">lpd</b> server is 168 running on the print server.</p> 169 170 <p>The <tt class="COMMAND">reread</tt> command connects to 171 the <b class="APPLICATION">lpd</b> print server and 172 requests that the server reread the <tt class= 173 "FILENAME">printcap</tt>, <tt class= 174 "FILENAME">lpd.conf</tt>, and <tt class= 175 "FILENAME">lpd.perms</tt> database files.</p> 176 </div> 177 </div> 178 179 <div class="NAVFOOTER"> 180 <hr align="LEFT" width="100%"> 181 182 <table summary="Footer navigation table" width="100%" border= 183 "0" cellpadding="0" cellspacing="0"> 184 <tr> 185 <td width="33%" align="left" valign="top"><a href= 186 "x4719.htm" accesskey="P">Prev</a></td> 187 188 <td width="34%" align="center" valign="top"><a href= 189 "index.htm" accesskey="H">Home</a></td> 190 191 <td width="33%" align="right" valign="top"><a href= 192 "x4771.htm" accesskey="N">Next</a></td> 193 </tr> 194 195 <tr> 196 <td width="33%" align="left" valign="top"><b class= 197 "APPLICATION">lprm</b> Job Selection</td> 198 199 <td width="34%" align="center" valign="top"> </td> 200 201 <td width="33%" align="right" valign="top">Queue 202 Management - enable, disable, up, down</td> 203 </tr> 204 </table> 205 </div> 206 </body> 207</html> 208 209