home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Libraries / stdwin / Doc / man / qview.man < prev    next >
Encoding:
Text File  |  1988-04-21  |  4.8 KB  |  176 lines  |  [TEXT/????]

  1. .TH QVIEW 1
  2. .SH NAME
  3. qview \- printer queue viewer
  4. .SH SYNOPSIS
  5. .B qview
  6. [
  7. .B -S
  8. .I spooldir
  9. ]
  10. [
  11. .BI -P printer
  12. ]
  13. [
  14. .B \-s
  15. ]
  16. [
  17. .B \-n
  18. ]
  19. [
  20. .B \-l
  21. ]
  22. [
  23. .B +\n
  24. .I interval
  25. ]
  26. .SH DESCRIPTION
  27. .I Qview
  28. is a STDWIN-based application which continuously displays the status of
  29. a printer queue.
  30. It is intended as a replacement for
  31. .IR lpq (1),
  32. continuously sitting in a corner of your display.
  33. In order to reduce the required screen ``real estate'', an optional
  34. compact listing format is available.
  35. .PP
  36. This is a single-window program;
  37. to monitor several printer queues simultaneous you must run separate
  38. copies for each printer, or circulate through the different queues
  39. using the Printers menu (see below).
  40. .SH COMMAND LINE OPTIONS
  41. .IP "\-S spooldir"
  42. Uses
  43. .IR spooldir / printer
  44. instead of
  45. .RI /usr/spool/ printer
  46. to find the spool directory.
  47. .IP "\-Pprinter"
  48. Displays  the queue for printer
  49. .I printer.
  50. The default is taken from the shell environment variable PRINTER;
  51. if this isn't set the default is lp.
  52. .IP "-s"
  53. Displays a short, columnar listing.
  54. This only shows job number, size and owner for each job.
  55. .IP "-n"
  56. Displays a normal listing, using one line per job.
  57. This shows the queue ordinal, control file name, owner, size and number
  58. of data files per job.
  59. This is the default.
  60. .IP "-l"
  61. Displays a long listing, showing additional information for each data
  62. file.
  63. .IP "+interval"
  64. Sets the number of seconds between window updates.
  65. The default is 30 seconds.
  66. This option must be last!
  67. .LP
  68. There may be other options which are processed by the particular
  69. implementation of STDWIN used.
  70. .SH SELECTING JOBS
  71. A job may be selected by pointing at it with the mouse.
  72. The selected job is displayed highlighted;
  73. it is the target of certain commands (see below).
  74. The up and down arrow keys can also be used to select jobs.
  75. The selection is removed when the display is refreshed;
  76. to give you a chance to do something to the selected job,
  77. the display refresh is put off for at least 10 seconds
  78. when a selection has been made.
  79. .SH MENUS
  80. .I Qview
  81. has three menus.
  82. .PP
  83. The
  84. .B Command
  85. menu contains the following items:
  86. .IP "Delete job"
  87. Only enabled when a job has been selected (see above);
  88. this command deletes the job from the queue if allowed.
  89. .IP "Move job to queue top"
  90. Only enabled when a job has been selected (see above);
  91. this command moves the job to the top of the queue if allowed
  92. (you must be root for this to work).
  93. .IP "Restart daemon"
  94. Restart the printer daemon, if allowed.
  95. Use with caution; this can cause the current job to be killed and
  96. restarted.
  97. .IP "Refresh display"
  98. Updates the display with fresh information (see below).
  99. .IP "Set refresh interval..."
  100. Allows you to type the new time interval between display refreshes
  101. (the + option on the command line).
  102. .IP "Quit"
  103. Exits the program.
  104. .PP
  105. The
  106. .B Format
  107. menu allows the current listing format to be changed between Short,
  108. Normal and Long.
  109. The current listing format is indicated with a tick mark or an asterisk.
  110. .PP
  111. The
  112. .B Printers
  113. menu shows the different printers available in the system, with the
  114. printer whose queue is currently shown checked.
  115. Choosing an entry causes the program to switch to that printer's queue.
  116. .SH DISPLAY REFRESHING
  117. Normally the information is refreshed every
  118. .I interval
  119. seconds.
  120. It is also refreshed:
  121. when the window is resized,
  122. when the listing format is changed,
  123. when a different printer is chosen,
  124. when the Return key is pressed,
  125. or when
  126. .B "Refresy display"
  127. from the
  128. .B Quit
  129. menu is chosen.
  130. After such a forced refresh, the next refresh is scheduled in
  131. .I interval
  132. seconds.
  133. .SH DIAGNOSTICS
  134. Panics if it can't chdir to the spool directory or can't create
  135. windows or menus.
  136. .br
  137. Beeps if a command couldn't be executed.
  138. .SH FILES
  139. /usr/spool/*
  140. .I "spool directories"
  141. .br
  142. .SH SEE ALSO
  143. lpq(1), lprm(1), lpc(8)
  144. .br
  145. STDWIN documentation
  146. .SH AUTHOR
  147. Guido van Rossum
  148. .SH BUGS
  149. Because it isn't suid daemon, it can't list remote queues like lpq can
  150. and it can't look in the control files.
  151. Because it can't look in the control files it uses a heuristic to find
  152. out which data files belong to a control file; this heuristic may fail
  153. and then it will lie about some jobs.
  154. .br
  155. Instead of consulting /etc/printcap, it assumes the printer spool
  156. directory is
  157. .RI /usr/spool/ printer ,
  158. except when
  159. .I printer
  160. is lp, in which case it knows the spool directory is /usr/spool/lpd.
  161. .br
  162. Long format is unimplemented (shows identical sas normal format).
  163. .br
  164. The display flashes at each refresh, even if the information displayed
  165. isn't changed.
  166. .br
  167. Deleting takes extraordinary long because lprm seems to take forever;
  168. also lprm doesn't return a meaningful exit status so success or failure
  169. can't be reported.
  170. .br
  171. The entries in the Printers menu are hardwirde in the program, except
  172. that any printer specified on the command line is added to the menu if
  173. it is not already in it.
  174. .br
  175. I suspect that restarting a daemon frequently may cause it to hang.
  176.