Differential D30265 Diff 89510 usr.bin/timeout/timeout.1

Changeset View

Standalone View

usr.bin/timeout/timeout.1

	Show All 20 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" 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.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd July 7, 2020			.Dd May 20, 2021
	.Dt TIMEOUT 1			.Dt TIMEOUT 1
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm timeout			.Nm timeout
	.Nd run a command with a time limit			.Nd run a command with a time limit
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Fl -signal Ar sig \| Fl s Ar sig			.Op Fl -signal Ar sig \| Fl s Ar sig
	▲ Show 20 Lines • Show All 137 Lines • ▼ Show 20 Lines
	.Bd -literal -offset indent			.Bd -literal -offset indent
	$ timeout --preserve-status -s SIGALRM 2 sleep 4			$ timeout --preserve-status -s SIGALRM 2 sleep 4
	$ echo $?			$ echo $?
	142			142
	.Ed			.Ed
	.Pp			.Pp
	Try to			Try to
	.Xr fetch 1			.Xr fetch 1
	the single page version of the			the PDF version of the
	.Fx			.Fx
	Handbook.			Handbook.
	Send a			Send a
	.Va SIGTERM			.Va SIGTERM
	signal after 1 minute and send a			signal after 1 minute and send a
	.Va SIGKILL			.Va SIGKILL
	signal 5 seconds later if the process refuses to stop:			signal 5 seconds later if the process refuses to stop:
	.Bd -literal -offset indent			.Bd -literal -offset indent
	timeout -k 5s 1m fetch \\			timeout -k 5s 1m fetch \\
	https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book.html			https://download.freebsd.org/ftp/doc/en/books/handbook/book.pdf
				dbaioUnsubmitted Not Done Inline Actions This is pointing to the old documentation, this is the right link: https://docs.freebsd.org/en/books/handbook/ We should fix that in the docs side, there are still some redirects to be made. dbaio: This is pointing to the old documentation, this is the right link: https://docs.freebsd.
				ceriAuthorUnsubmitted Done Inline Actions That link just redirects to itself, so will use https://docs.freebsd.org/en/books/handbook/book.html (the description is specifically about the full book too). ceri: That link just redirects to itself, so will use https://docs.freebsd.org/en/books/handbook/book.
				dbaioUnsubmitted Not Done Inline Actions We made some changes this morning and there is an issue with the Handbook. This looping will be fixed. CCing @allanjude dbaio: We made some changes this morning and there is an issue with the Handbook. This looping will be…
				dbaioUnsubmitted Not Done Inline Actions And it's fixed. https://docs.freebsd.org/en/books/handbook/ Thanks Allan. dbaio: And it's fixed. https://docs.freebsd.org/en/books/handbook/ Thanks Allan.
				ceriAuthorUnsubmitted Done Inline Actions OK great. Would still recommend keeping the link I updated to, as the text discusses retrieving the whole book. ceri: OK great. Would still recommend keeping the link I updated to, as the text discusses…
				dbaioUnsubmitted Not Done Inline Actions Got it, it's needed an address that won't be fetched instantly. Well, it's working now, don't know for how long the legacy doc will be available or a redirect will take place. dbaio: Got it, it's needed an address that won't be fetched instantly. Well, it's working now, don't…
				ceriAuthorUnsubmitted Done Inline Actions Ah - I hadn't realised it was an older artefact. Will https://download.freebsd.org/ftp/doc/en/books/handbook/ be updated in time? A PDF link might be better. ceri: Ah - I hadn't realised it was an older artefact. Will https://download.freebsd.
				dbaioUnsubmitted Done Inline Actions Hum, seems the PDF is the better choice, I generated the new Handbook in PDF and it has almost 18MB, it will fit the purpose here. Maybe it's good to open a PR for track the bulk builds in PDF, it's a pending item from the migration to Hugo/Asciidoctor. dbaio: Hum, seems the PDF is the better choice, I generated the new Handbook in PDF and it has almost…
				blackendUnsubmitted Done Inline Actions Indeed, PDF should be better. I have a diff allowing to build all docs in PDF with language selection. I'm going to create a review for it today. blackend: Indeed, PDF should be better. I have a diff allowing to build all docs in PDF with language…
				ceriAuthorUnsubmitted Done Inline Actions OK, done in attached. (will rebump .Dd in all pages before committing). ceri: OK, done in attached. (will rebump .Dd in all pages before committing).
				ceriAuthorUnsubmitted Done Inline Actions PR 255972 opened. ceri: PR 255972 opened.
	.Ed			.Ed
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr kill 1 ,			.Xr kill 1 ,
	.Xr signal 3			.Xr signal 3
	.Sh HISTORY			.Sh HISTORY
	The			The
	.Nm			.Nm
	command first appeared in			command first appeared in
	.Fx 10.3 .			.Fx 10.3 .
	.Sh AUTHORS			.Sh AUTHORS
	.An Baptiste Daroussin Aq Mt bapt@FreeBSD.org			.An Baptiste Daroussin Aq Mt bapt@FreeBSD.org
	and			and
	.An Vsevolod Stakhov Aq Mt vsevolod@FreeBSD.org			.An Vsevolod Stakhov Aq Mt vsevolod@FreeBSD.org