home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / CMDS / uustat.t.Z / uustat.t / uustat.prf < prev   
Text File  |  2009-11-06  |  7KB  |  242 lines
  1. .fill
  2. .justify
  3. .offset 5
  4. .rightmargin 70
  5. .pagesize 72
  6. .m1 3
  7. .m2 2
  8. .m3 2
  9. .m4 5
  10. .ec \
  11. .header /Uustat/UTILITY COMMAND/Uustat
  12. .footer /Page #//Printed (%)/
  13. .in +5
  14. .define topic
  15. .bold
  16. .in -5
  17. $1 $2 $3 $4 $5
  18. .in +5
  19. .en
  20. .define endtopic
  21.  
  22.  
  23. .en
  24. .define noform
  25. .nojustify
  26. .nofill
  27. .en
  28. .define noformend
  29. .justify
  30. .fill
  31. .en
  32. .! Manual created with MWB
  33. .! END-OF-MACRO
  34. .topic NAME
  35. Uustat - uucp status inquiry and job control
  36. .endtopic
  37. .topic SYNOPSIS
  38. .noform
  39. uustat [-x[=]<num>] [-s[=]<system>] [-u[=]<user>]
  40. uustat [-x[=]<num>] -k[[=]<jobid>] [-v]
  41. uustat [-x[=]<num>] -r[[=]<jobid>] [-v]
  42. uustat -?
  43. .noformend
  44. .endtopic
  45. .topic DESCRIPTION
  46. Uustat will display the status of, or kill or rejuvenate,
  47. previously specified uucp commands.
  48. .sp
  49. The options have the following meaning:
  50. .sp
  51. .in +5
  52. .noform
  53. -k                kill all uucp requests
  54. -k[=]<jobid>      kill uucp request <jobid>
  55. -r                rejuvenate all uucp requests
  56. -r[=]<jobid>      rejuvenate uucp request <jobid>
  57. -s[=]<system>     display status for <system>
  58. -u[=]<user>       report requests issued by <user>
  59. -v                verbose mode (with -k or -r)
  60. -x[=]<num>        debug level <num>
  61. -?                print help message
  62. .noformend
  63. .in -5
  64. .sp
  65. If the neither the -k nor the -r option are present,
  66. uustat displays the status of active uucp requests.
  67. The requests displayed can be selected with the -u and -s options.
  68. .sp
  69. Uustat scans the C. and X. files in the uucp spool directory.
  70. From these files uustat extracts the required information.
  71. If a display is requested, uustat produces the following output:
  72. .sp
  73. .noform
  74. uploxa0131  89/07/21-16:17  S  uploxa  notes  3195  D.uploxaA0131
  75.             89/07/21-16:17  S  uploxa  notes  nfrcv  ums.sh sephh
  76. uploxa0132  89/07/21-16:18  S  uploxa  system  645  D.uploxaA0132
  77.             89/07/21-16:18  S  uploxa  system  rmail  exhh!ktshh!helle
  78. uploxaA3720  89/07/20-10:07  X  uploxa  schubi  rmail  system
  79. uploxaA3744  89/07/20-11:04  X  uploxa  notes  nfrcv  sub.config uploxa
  80. .noformend
  81. .sp
  82. The first field is the uucp job ID, i.e. the name of the C. or X. file.
  83. Each C. file can contain multiple remote commands;
  84. uustat prints duplicate job IDs as white space.
  85. This is field is followed by the access date and time of the file involved
  86. in the transfer.
  87. The next field is either 'S', 'R', or 'X' depending on whether the job is to
  88. send or request (C. control file) or execute (X. control file) a file.
  89. This is followed by the remote system name and the user ID of the
  90. user who queued the request.
  91. In the case of pending execution,
  92. the user ID is that of the remote user,
  93. which is usually senseless on the local system.
  94. The last field contains the size of the file and its name or,
  95. in the case of a remote execution the command to be executed.
  96. .sp
  97. The user names (also remote user names!) and system names can be restricted
  98. with the -u and -s options.
  99. No check is made for the validity of the user IDs.
  100. .sp
  101. The -k option is used to kill a previously scheduled uucp request,
  102. which can be defined by either a C. or a X. command file.
  103. The command file is scanned for all depending files.
  104. These files and the command file are deleted.
  105. The killed request must belong to the user ID that issued the request
  106. unless one is logged in as the super-user (user ID 0.0).
  107. This also does apply to X. command files
  108. which can be killed only by the super-user because
  109. the local user ID is unknown.
  110. If no uucp request ID is given with the -k option,
  111. all available requests are killed.
  112. Note that 'orphan files' in the uucp spool directory
  113. that do not belong to any request remain untouched.
  114. .sp
  115. The -r option works precisely the same way as the -k option
  116. except that is does not
  117. delete the files but touches them to modify their access date.
  118. This is useful for requests that would be removed by
  119. uumailclean in an automatic periodical
  120. clean-up of the uucp spool directory.
  121. .sp
  122. The -v (verbose) option displays a message for each job deleted or touched
  123. with the -k or -r command.
  124. .sp
  125. The -x option is useful if parsing errors occur during scan of the
  126. C. and X. command files.
  127. This should not normally happen,
  128. but since the uucp syntax is very specific,
  129. the -x option may help tracing the fault.
  130. The -x option takes a debug level indication as a numeric argument.
  131. Useful numbers are from the range 0..3 where
  132. 0 means that no debug messages are printed (the default)
  133. while 3 means that all available debug information is given.
  134. .endtopic
  135. .topic BUGS
  136. Uustat does not check  the validity of a system name against the uucp
  137. systems file.
  138. .sp
  139. Since the uucp command file syntax is very specific,
  140. uustat may crash in extreme situations although precautions
  141. have been taken to allow graceful degradation.
  142. .endtopic
  143. .topic FILES
  144. .noform
  145. /h0/SPOOL/UUCP/*
  146. /dd/SYS/password
  147. .noformend
  148. .endtopic
  149. .topic SYSINFO
  150. .noform
  151. UUCP.SPOOL
  152. lck.uucp
  153. .sp
  154. .noformend
  155. Note that uustat does not modify the uucp lock (lck.uucp) itself.
  156. Rather, it emits a warning message indicating that uucp may be active
  157. at the moment.
  158. As a result, a uustat command with the -k or -r option
  159. may possibly delete or touch files that are (to be) accessed
  160. by other uucp activities working on the spool directory.
  161. In rare circumstances, this may crash these programs.
  162. .noformend
  163. .endtopic
  164. .topic EXAMPLES
  165. .noform
  166. uustat
  167. .in +5
  168. .noformend
  169. Displays the complete status information. Output is as follows:
  170. .noform
  171. .sp
  172. uploxa0131  89/07/21-16:17  S  uploxa  notes  3195  D.uploxaA0131
  173.             89/07/21-16:17  S  uploxa  notes  nfrcv  ums.sh sephh
  174. uploxa0132  89/07/21-16:18  S  uploxa  system  645  D.uploxaA0132
  175.             89/07/21-16:18  S  uploxa  system  rmail  exhh!ktshh!helle
  176. uploxaA3720  89/07/20-10:07  X  uploxa  schubi  rmail  system
  177. uploxaA3744  89/07/20-11:04  X  uploxa  notes  nfrcv  sub.config uploxa
  178. .in -5
  179. .sp
  180. uustat -u=schubi -suploxa
  181. .in +5
  182. .noformend
  183. Display requests from the (local or remote) user 'schubi' to or
  184. from remote system 'uploxa':
  185. .noform
  186. .sp
  187. uploxaA3720  89/07/20-10:07  X  uploxa  schubi  rmail  system
  188. .in -5
  189. .sp
  190. uustat -kuploxaA3720 -v
  191. .in +5
  192. .noformend
  193. Kills the job displayed in the previous example.
  194. Uustat confirms with (-v option):
  195. .noform
  196. .sp
  197. uustat: uploxaA3720 killed
  198. .in -5
  199. .sp
  200. uustat -vr
  201. .in +5
  202. .noformend
  203. Touches the remaining requests:
  204. .noform
  205. .sp
  206. uustat: uploxa0131 rejuvenated
  207. uustat: uploxa0132 rejuvenated
  208. uustat: uploxaA3744 rejuvenated
  209. .in -5
  210. .sp
  211. uustat -usystem
  212. .in +5
  213. .noformend
  214. Displays freshly touched status for user 'system':
  215. .noform
  216. .sp
  217. uploxa0132  89/08/22-03:55  S  uploxa  system  645  D.uploxaA0132
  218.             89/08/22-03:55  S  uploxa  system  rmail  exhh!ktshh!helle
  219. .in -5
  220. .sp
  221. su -c uucp
  222. uustat -vkuploxaA3744
  223. .in +5
  224. .noformend
  225. Try to kill request uploxaA3744 after changing user ID to uucp:
  226. .noform
  227. .sp
  228. uustat: wrong user ID to kill uploxaA3744
  229. .in -5
  230. .noformend
  231. .endtopic
  232. .topic SEE ALSO
  233. .noform
  234. uucp, uucico, uuxqt, uux, uulog
  235. .endtopic
  236. .topic AUTHOR
  237. Helge Oldach, Hamburg, West Germany
  238. Electronic Mail: he@sephh.sub.org
  239.                  ..!unido!stollco!he
  240. .noformend
  241. .endtopic
  242.