------------------------------------------------------------ revno: 1585 committer: James Hunt <[email protected]> branch nick: upstart timestamp: Fri 2013-12-20 17:37:26 +0000 message: * init/man/init.8: - Refer to job goals in start/stop/restart commands. - Explain actual semantics of restart (debian bug#732126). modified: ChangeLog util/man/initctl.8
-- lp:upstart https://code.launchpad.net/~upstart-devel/upstart/trunk Your team Upstart Reviewers is subscribed to branch lp:upstart. To unsubscribe from this branch go to https://code.launchpad.net/~upstart-devel/upstart/trunk/+edit-subscription
=== modified file 'ChangeLog' --- ChangeLog 2013-12-20 16:48:41 +0000 +++ ChangeLog 2013-12-20 17:37:26 +0000 @@ -8,6 +8,8 @@ * util/man/initctl.8: - Added reference to Job States section in init(8). - Updated date+copyright. + - Refer to job goals in start/stop/restart commands. + - Explain actual semantics of restart (debian bug#732126). * init/man/init.5: Provide additional detail on start/stop on stanzas with respect to how Upstart deals with complex conditions containing multiple events (debian bug#732122). === modified file 'util/man/initctl.8' --- util/man/initctl.8 2013-12-20 15:13:45 +0000 +++ util/man/initctl.8 2013-12-20 17:37:26 +0000 @@ -132,8 +132,10 @@ Requests that a new instance of the named .I JOB -be started, outputting the status of the job to standard output when the -command completes. +be started by changing its goal to +.BR start "." +The status of the job is displayed on standard output when the command +completes. See .B status @@ -172,8 +174,10 @@ Requests that an instance of the named .I JOB -be stopped, outputting the status of the job to standard output when the -command completes. +be stopped by changing its goal to +.BR stop "." +The status of the job is displayed on standard output when the command +completes. See .B status @@ -187,6 +191,20 @@ .B stop may be called without an argument to cancel the .B start. + +By default +.B SIGTERM +is sent to the job process. If it does not respond within a reasonable +period, it will be forcibly stopped by sending +.B SIGKILL. + +This behaviour can be changed using the +.B kill signal +and +.B kill timeout +stanzas. See +.BR init (5) +for further details. .\" .TP .B restart @@ -195,10 +213,21 @@ Requests that an instance of the named .I JOB -be restarted, outputting the status of the job to standard output when -the command completes. +be restarted by first changing its goal to +.BR stop ", " +and then changing its goal to +.BR start "." +The status of the job is displayed on standard output when the command +completes. -The job instance being restarted will retain its original configuration. +This command is +.I similar +to running +.B stop +followed by +.B start +with one exception: the job instance being restarted will retain its +original configuration. To have the new instance run with the latest job configuration, .B stop the job and then
-- upstart-devel mailing list [email protected] Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/upstart-devel
