github
/
winsw
mirror of https://github.com/winsw/winsw
1
0
Fork 0
Code Issues Releases Wiki Activity

Remove `<*argument>` from docs (#771)

pull/784/head
Next Turn 2021-01-02 12:51:06 +08:00 committed by GitHub
parent ad5f78b3c5
commit 2edcee7f49
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/xmlConfigFile.md
View File

@ -94,33 +94,27 @@ See the [Logging and error reporting](loggingAndErrorReporting.md) page for more
### Arguments ### Arguments
`<argument>` element specifies the arguments to be passed to the executable. `<arguments>` element specifies the arguments to be passed to the executable.
Winsw will quote each argument if necessary, so do not put quotes in `<argument>` to avoid double quotation.
```xml ```xml
<argument>arg1</argument> <arguments>arg1 arg2 arg3</arguments>
<argument>arg2</argument>
<argument>arg3</argument>
``` ```
`<arguments>` element can be used instead to specify the whole command line in a single element.
### stopargument/stopexecutable ### stopargument/stopexecutable
~~When the service is requested to stop, winsw simply calls [TerminateProcess function](https://docs.microsoft.com/windows/win32/api/processthreadsapi/nf-processthreadsapi-terminateprocess) to kill the service instantly.~~ ~~When the service is requested to stop, winsw simply calls [TerminateProcess function](https://docs.microsoft.com/windows/win32/api/processthreadsapi/nf-processthreadsapi-terminateprocess) to kill the service instantly.~~
However, if `<stopargument>`/`<stoparguments>` elements are present, winsw will instead launch another process of `<executable>` (or `<stopexecutable>` if that's specified) with the specified arguments, and expects that to initiate the graceful shutdown of the service process. However, if `<stoparguments>` element is present, winsw will instead launch another process of `<executable>` (or `<stopexecutable>` if that's specified) with the specified arguments, and expects that to initiate the graceful shutdown of the service process.
Winsw will then wait for the two processes to exit on its own, before reporting back to Windows that the service has terminated. Winsw will then wait for the two processes to exit on its own, before reporting back to Windows that the service has terminated.
When you use the `<stopargument>`/`<stoparguments>`, you must use `<startargument>`/`<startarguments>` instead of `<argument>`. See the complete example below: When you use the `<stoparguments>`, you must use `<startarguments>` instead of `<arguments>`. See the complete example below:
```xml ```xml
<executable>catalina.sh</executable> <executable>catalina.sh</executable>
<startargument>jpda</startargument> <startarguments>jpda run</startarguments>
<startargument>run</startargument>
<stopexecutable>catalina.sh</stopexecutable> <stopexecutable>catalina.sh</stopexecutable>
<stopargument>stop</stopargument> <stoparguments>stop</stoparguments>
``` ```
### stoptimeout ### stoptimeout