logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

qsig.1p (7050B)


  1. '\" et
  2. .TH QSIG "1P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. qsig
  12. \(em signal batch jobs
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. qsig \fB[\fR-s \fIsignal\fB] \fIjob_identifier\fR...
  17. .fi
  18. .SH DESCRIPTION
  19. To signal a batch job is to send a signal to the session leader of the
  20. batch job. A batch job is signaled by sending a request to the batch
  21. server that manages the batch job. The
  22. .IR qsig
  23. utility is a user-accessible batch client that requests the signaling
  24. of a batch job.
  25. .P
  26. The
  27. .IR qsig
  28. utility shall signal those batch jobs for which a batch
  29. .IR job_identifier
  30. is presented to the utility. The
  31. .IR qsig
  32. utility shall not signal any batch jobs whose batch
  33. .IR job_identifier s
  34. are not presented to the utility.
  35. .P
  36. The
  37. .IR qsig
  38. utility shall signal batch jobs in the order in which the corresponding
  39. batch
  40. .IR job_identifier s
  41. are presented to the utility. If the
  42. .IR qsig
  43. utility fails to process a batch
  44. .IR job_identifier
  45. successfully, the utility shall proceed to process the remaining batch
  46. .IR job_identifier s,
  47. if any.
  48. .P
  49. The
  50. .IR qsig
  51. utility shall signal batch jobs by sending a
  52. .IR "Signal Job Request"
  53. to the batch server that manages the batch job.
  54. .P
  55. For each successfully processed batch
  56. .IR job_identifier ,
  57. the
  58. .IR qsig
  59. utility shall have received a completion reply to each
  60. .IR "Signal Job Request"
  61. sent to a batch server at the time the utility exits.
  62. .SH OPTIONS
  63. The
  64. .IR qsig
  65. utility shall conform to the Base Definitions volume of POSIX.1\(hy2017,
  66. .IR "Section 12.2" ", " "Utility Syntax Guidelines".
  67. .P
  68. The following option shall be supported by the implementation:
  69. .IP "\fB\-s\ \fIsignal\fR" 10
  70. Define the signal to be sent to the batch job.
  71. .RS 10
  72. .P
  73. The
  74. .IR qsig
  75. utility shall accept a
  76. .IR signal
  77. option-argument that is either a symbolic signal name or an unsigned
  78. integer signal number (see the POSIX.1\(hy1990 standard, Section 3.3.1.1). The
  79. .IR qsig
  80. utility shall accept signal names for which the SIG prefix has been
  81. omitted.
  82. .P
  83. If the
  84. .IR signal
  85. option-argument is a signal name, the
  86. .IR qsig
  87. utility shall send that name.
  88. .P
  89. If the
  90. .IR signal
  91. option-argument is a number, the
  92. .IR qsig
  93. utility shall send the signal value represented by the number.
  94. .P
  95. If the
  96. .BR \-s
  97. option is not presented to the
  98. .IR qsig
  99. utility, the utility shall send the signal SIGTERM to each signaled
  100. batch job.
  101. .RE
  102. .SH OPERANDS
  103. The
  104. .IR qsig
  105. utility shall accept one or more operands that conform to the syntax
  106. for a batch
  107. .IR job_identifier
  108. (see
  109. .IR "Section 3.3.1" ", " "Batch Job Identifier").
  110. .SH STDIN
  111. Not used.
  112. .SH "INPUT FILES"
  113. None.
  114. .SH "ENVIRONMENT VARIABLES"
  115. The following environment variables shall affect the execution of
  116. .IR qsig :
  117. .IP "\fILANG\fP" 10
  118. Provide a default value for the internationalization variables that are
  119. unset or null. (See the Base Definitions volume of POSIX.1\(hy2017,
  120. .IR "Section 8.2" ", " "Internationalization Variables"
  121. the precedence of internationalization variables used to determine the
  122. values of locale categories.)
  123. .IP "\fILC_ALL\fP" 10
  124. If set to a non-empty string value, override the values of all the
  125. other internationalization variables.
  126. .IP "\fILC_CTYPE\fP" 10
  127. Determine the locale for the interpretation of sequences of bytes of
  128. text data as characters (for example, single-byte as opposed to
  129. multi-byte characters in arguments).
  130. .IP "\fILC_MESSAGES\fP" 10
  131. .br
  132. Determine the locale that should be used to affect the format and
  133. contents of diagnostic messages written to standard error.
  134. .IP "\fILOGNAME\fP" 10
  135. Determine the login name of the user.
  136. .SH "ASYNCHRONOUS EVENTS"
  137. Default.
  138. .SH STDOUT
  139. An implementation of the
  140. .IR qsig
  141. utility may write informative messages to standard output.
  142. .SH STDERR
  143. The standard error shall be used only for diagnostic messages.
  144. .SH "OUTPUT FILES"
  145. None.
  146. .SH "EXTENDED DESCRIPTION"
  147. None.
  148. .SH "EXIT STATUS"
  149. The following exit values shall be returned:
  150. .IP "\00" 6
  151. Successful completion.
  152. .IP >0 6
  153. An error occurred.
  154. .SH "CONSEQUENCES OF ERRORS"
  155. In addition to the default behavior, the
  156. .IR qsig
  157. utility shall not be required to write a diagnostic message to standard
  158. error when the error reply received from a batch server indicates that
  159. the batch
  160. .IR job_identifier
  161. does not exist on the server. Whether or not the
  162. .IR qsig
  163. utility waits to output the diagnostic message while attempting to
  164. locate the batch job on other servers is implementation-defined.
  165. .LP
  166. .IR "The following sections are informative."
  167. .SH "APPLICATION USAGE"
  168. None.
  169. .SH EXAMPLES
  170. None.
  171. .SH RATIONALE
  172. The
  173. .IR qsig
  174. utility allows users to signal batch jobs.
  175. .P
  176. A user may be unable to signal a batch job with the
  177. .IR kill
  178. utility of the operating system for a number of reasons. First, the
  179. process ID of the batch job may be unknown to the user. Second, the
  180. processes of the batch job may be on a remote node. However, by virtue
  181. of communication between batch nodes, the
  182. .IR qsig
  183. utility can arrange for the signaling of a process.
  184. .P
  185. Because a batch job that is not running cannot be signaled, and because
  186. the signal may not terminate the batch job, the
  187. .IR qsig
  188. utility is not a substitute for the
  189. .IR qdel
  190. utility.
  191. .P
  192. The options of the
  193. .IR qsig
  194. utility allow the user to specify the signal that is to be sent to the
  195. batch job.
  196. .P
  197. The
  198. .BR \-s
  199. option allows users to specify a signal by name or by number, and thus
  200. override the default signal. The POSIX.1\(hy1990 standard defines signals by both name and
  201. number.
  202. .P
  203. The
  204. .IR qsig
  205. utility is a new utility, \fIvis-a-vis\fP existing practice; it has
  206. been defined in this volume of POSIX.1\(hy2017 in response to user-perceived shortcomings in
  207. existing practice.
  208. .SH "FUTURE DIRECTIONS"
  209. The
  210. .IR qsig
  211. utility may be removed in a future version.
  212. .SH "SEE ALSO"
  213. .IR "Chapter 3" ", " "Batch Environment Services",
  214. .IR "\fIkill\fR\^",
  215. .IR "\fIqdel\fR\^"
  216. .P
  217. The Base Definitions volume of POSIX.1\(hy2017,
  218. .IR "Chapter 8" ", " "Environment Variables",
  219. .IR "Section 12.2" ", " "Utility Syntax Guidelines"
  220. .\"
  221. .SH COPYRIGHT
  222. Portions of this text are reprinted and reproduced in electronic form
  223. from IEEE Std 1003.1-2017, Standard for Information Technology
  224. -- Portable Operating System Interface (POSIX), The Open Group Base
  225. Specifications Issue 7, 2018 Edition,
  226. Copyright (C) 2018 by the Institute of
  227. Electrical and Electronics Engineers, Inc and The Open Group.
  228. In the event of any discrepancy between this version and the original IEEE and
  229. The Open Group Standard, the original IEEE and The Open Group Standard
  230. is the referee document. The original Standard can be obtained online at
  231. http://www.opengroup.org/unix/online.html .
  232. .PP
  233. Any typographical or formatting errors that appear
  234. in this page are most likely
  235. to have been introduced during the conversion of the source files to
  236. man page format. To report such errors, see
  237. https://www.kernel.org/doc/man-pages/reporting_bugs.html .