Changeset View
Changeset View
Standalone View
Standalone View
sbin/shutdown/shutdown.8
| Show All 22 Lines | |||||
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
| .\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
| .\" | .\" | ||||
| .\" @(#)shutdown.8 8.2 (Berkeley) 4/27/95 | .\" @(#)shutdown.8 8.2 (Berkeley) 4/27/95 | ||||
| .\" $FreeBSD$ | .\" $FreeBSD$ | ||||
| .\" | .\" | ||||
| .Dd September 21, 2016 | .Dd October 23, 2017 | ||||
| .Dt SHUTDOWN 8 | .Dt SHUTDOWN 8 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm shutdown , | .Nm shutdown , | ||||
| .Nm poweroff | .Nm poweroff | ||||
| .Nd "close down the system at a given time" | .Nd "close down the system at a given time" | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .Nm | .Nm | ||||
| .Op Fl | .Op Fl | ||||
| .Oo | .Oo | ||||
| .Fl h | Fl p | | .Fl c | Fl h | Fl p | | ||||
| .Fl r | Fl k | .Fl r | Fl k | ||||
| .Oc | .Oc | ||||
| .Oo | .Oo | ||||
| .Fl o | .Fl o | ||||
| .Op Fl n | .Op Fl n | ||||
| .Oc | .Oc | ||||
| .Ar time | .Ar time | ||||
| .Op Ar warning-message ... | .Op Ar warning-message ... | ||||
| .Nm poweroff | .Nm poweroff | ||||
| .Sh DESCRIPTION | .Sh DESCRIPTION | ||||
| The | The | ||||
| .Nm | .Nm | ||||
| utility provides an automated shutdown procedure for super-users | utility provides an automated shutdown procedure for super-users | ||||
| to nicely notify users when the system is shutting down, | to nicely notify users when the system is shutting down, | ||||
| saving them from system administrators, hackers, and gurus, who | saving them from system administrators, hackers, and gurus, who | ||||
| would otherwise not bother with such niceties. | would otherwise not bother with such niceties. | ||||
| .Pp | .Pp | ||||
| The following options are available: | The following options are available: | ||||
| .Bl -tag -width indent | .Bl -tag -width indent | ||||
| .It Fl c | |||||
| The system is power cycled (power turned off and then back on) | |||||
| at the specified time. | |||||
dhw: "at the specified time"? Where is (or should) it be specified? (A pointer to where one might… | |||||
Not Done Inline ActionsAlready in the shutdown man page. this language is identical to the power off language, so I don't think we need a pointer. imp: Already in the shutdown man page. this language is identical to the power off language, so I… | |||||
Not Done Inline ActionsSilly me! -- overlooked the context; sorry for the noise. dhw: Silly me! -- overlooked the context; sorry for the noise. | |||||
| If the hardware doesn't support power cycle, the system will be | |||||
| halted. | |||||
| At the present time, only systems with BMC supported by the | |||||
| .Xr ipmi 4 | |||||
| driver that implement this functionality support this flag. | |||||
| .It Fl h | .It Fl h | ||||
| The system is halted at the specified | The system is halted at the specified | ||||
| .Ar time . | .Ar time . | ||||
| .It Fl p | .It Fl p | ||||
| The system is halted and the power is turned off | The system is halted and the power is turned off | ||||
| (hardware support required) | (hardware support required, otherwise the system is halted) | ||||
Done Inline ActionsIt looks like it might be clearer if this was turned into a separate sentence. For example: The system is halted and the power is turned off at the specified .Ar time . If the hardware does not support this option, the system is halted instead. jtl: It looks like it might be clearer if this was turned into a separate sentence.
For example… | |||||
Done Inline ActionsGood suggestion. Might also be good to sprinkle kib's suggestion in as well. imp: Good suggestion. Might also be good to sprinkle kib's suggestion in as well.
| |||||
| at the specified | at the specified | ||||
| .Ar time . | .Ar time . | ||||
| .It Fl r | .It Fl r | ||||
| The system is rebooted at the specified | The system is rebooted at the specified | ||||
| .Ar time . | .Ar time . | ||||
| .It Fl k | .It Fl k | ||||
| Kick everybody off. | Kick everybody off. | ||||
| The | The | ||||
| .Fl k | .Fl k | ||||
| option | option | ||||
| does not actually halt the system, but leaves the | does not actually halt the system, but leaves the | ||||
| system multi-user with logins disabled (for all but super-user). | system multi-user with logins disabled (for all but super-user). | ||||
| .It Fl o | .It Fl o | ||||
| If one of the | If one of the | ||||
| .Fl c , | |||||
| .Fl h , | .Fl h , | ||||
| .Fl p | .Fl p | ||||
| or | or | ||||
| .Fl r | .Fl r | ||||
| options are specified, | options are specified, | ||||
| .Nm | .Nm | ||||
| will execute | will execute | ||||
| .Xr halt 8 | .Xr halt 8 | ||||
| ▲ Show 20 Lines • Show All 134 Lines • Show Last 20 Lines | |||||
"at the specified time"? Where is (or should) it be specified? (A pointer to where one might find the information would be fine -- no point in duplicating the information & risking a change in one, but not the other.)