54c2e46443
According to the coreutils regression testsuite for timeout(1) It is expect to exit with a status being: 125 in case an invalid duration or signal is passed in arguments 126 in case an invalid command is passed in arguments 127 in case the command passed in arguments does not exists. While here document this behaviour in the man page
130 lines
3.2 KiB
Groff
130 lines
3.2 KiB
Groff
.\" Copyright (c) 2014 Baptiste Daroussin <bapt@FreeBSD.org>
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" 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
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd Oct 28, 2014
|
|
.Dt TIMEOUT 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm timeout
|
|
.Nd run a command with a time limit
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl -signal Ar sig | Fl s Ar sig
|
|
.Op Fl -preserve-status
|
|
.Op Fl -kill-after Ar time | Fl k Ar time
|
|
.Op Fl -foreground
|
|
.Ao Ar duration Ac
|
|
.Ao Ar command Ac
|
|
.Ao Ar args ... Ac
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
starts the
|
|
.Ar command
|
|
with its
|
|
.Ar args.
|
|
If
|
|
.Ar command
|
|
is still running after
|
|
.Ar duration ,
|
|
it is killed.
|
|
By default,
|
|
.Ar SIGTERM.
|
|
is sent.
|
|
.Bl -tag -width "-k time, --kill-after time"
|
|
.It Fl -preserve-status
|
|
Always exits with the same status as
|
|
.Ar command
|
|
even if it times out.
|
|
.It Fl -foreground
|
|
Do not propagate timeout to the
|
|
.Ar command
|
|
children.
|
|
.It Fl s Ar sig , Fl -signal Ar sig
|
|
Specify the signal to send on timeout.
|
|
By default,
|
|
.Ar SIGTERM .
|
|
is sent.
|
|
.It Fl k Ar time , Fl -kill-after Ar time
|
|
Send a second kill signal if
|
|
.Ar command
|
|
is still running after
|
|
.Ar time
|
|
after the first signal was sent.
|
|
.El
|
|
.Sh DURATION FORMAT
|
|
.Ar duration
|
|
and
|
|
.Ar time
|
|
can be integer or decimal numbers.
|
|
Values without unit symbols are interpreted as seconds.
|
|
.Pp
|
|
Supported unit symbols are:
|
|
.Bl -tag -width indent -compact
|
|
.It s
|
|
seconds
|
|
.It m
|
|
minutes
|
|
.It h
|
|
hours
|
|
.It d
|
|
days
|
|
.El
|
|
.Sh EXIT STATUS
|
|
If the timeout was not reached, the exit status of
|
|
.Ar command
|
|
is returned.
|
|
.Pp
|
|
If the timeout was reached and
|
|
.Fl -preserve-status
|
|
is set, the exit status of
|
|
.Ar command
|
|
is returned.
|
|
If
|
|
.Fl -preserve-status
|
|
is not set, an exit status of 124 is returned.
|
|
.Pp
|
|
If
|
|
.Ar command
|
|
exits after receiving a signal, the exit status returned is the signal number
|
|
plus 128.
|
|
.Pp
|
|
If
|
|
.Ar command
|
|
is an invalid command, the exit status returned is 126.
|
|
.Pp
|
|
If
|
|
.Ar command
|
|
is a non existing command, the exit status returned is 127.
|
|
.Pp
|
|
If an invalid parameter is passed to
|
|
.Fl s
|
|
or
|
|
.Fl k ,
|
|
the exit status return is 125.
|
|
.Sh SEE ALSO
|
|
.Xr kill 1 ,
|
|
.Xr signal 3
|