From e674027b3ea285a94fb0c8bb32db88e639ba7963 Mon Sep 17 00:00:00 2001 From: DTB Date: Thu, 21 Mar 2024 20:40:19 -0600 Subject: [PATCH 1/7] Makefile: add sleep(1) --- Makefile | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Makefile b/Makefile index cbfe3a7..d564a3c 100644 --- a/Makefile +++ b/Makefile @@ -103,6 +103,13 @@ scrut: build/bin/scrut build/bin/scrut: src/scrut.c build $(CC) $(CFLAGS) -o $@ src/scrut.c +.PHONY: sleep +sleep: build/bin/sleep +build/bin/sleep: src/sleep.rs build + $(RUSTC) $(RUSTFLAGS) + --extern sysexits=build/o/libsysexits.rlib \ + -o $@ src/sleep.rs + .PHONY: str str: build/bin/str build/bin/str: src/str.c build From 82a941eee38b484967833ab11c401fd8eb2bf295 Mon Sep 17 00:00:00 2001 From: DTB Date: Thu, 21 Mar 2024 20:41:05 -0600 Subject: [PATCH 2/7] sleep(1): initial implementation --- src/sleep.rs | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 src/sleep.rs diff --git a/src/sleep.rs b/src/sleep.rs new file mode 100644 index 0000000..f5af47d --- /dev/null +++ b/src/sleep.rs @@ -0,0 +1,47 @@ +/* + * Copyright (c) 2024 DTB + * SPDX-License-Identifier: AGPL-3.0-or-later + * + * This program is free software: you can redistribute it and/or modify it under + * the terms of the GNU Affero General Public License as published by the Free + * Software Foundation, either version 3 of the License, or (at your option) any + * later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more + * details. + * + * You should have received a copy of the GNU Affero General Public License + * along with this program. If not, see https://www.gnu.org/licenses/. + */ + +use std::{ + env::args, + process::ExitCode, + thread::sleep, + time::Duration +}; + +extern crate sysexits; +use sysexits::{EX_OK, EX_USAGE}; + +fn usage(s: &str) -> ExitCode { + eprintln!("Usage: {} [seconds]", s); + ExitCode::from(EX_USAGE as u8) +} + +fn main() -> ExitCode { + let argv = args().collect::>(); + + if argv.len() == 2 { + if let Ok(s) = argv[1].parse::() { + sleep(Duration::from_secs(s)); + ExitCode::from(EX_OK as u8) + } else { + usage(&argv[0]) + } + } else { + usage(&argv[0]) + } +} From 82f6c46b64a4ef270a995cbd7a0ecb81c6ea55b3 Mon Sep 17 00:00:00 2001 From: DTB Date: Fri, 3 May 2024 21:22:07 -0600 Subject: [PATCH 3/7] Makefile: update sleep recipe --- Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Makefile b/Makefile index 70ab13c..09110e3 100644 --- a/Makefile +++ b/Makefile @@ -120,8 +120,8 @@ build/bin/scrut: src/scrut.c build .PHONY: sleep sleep: build/bin/sleep -build/bin/sleep: src/sleep.rs build - $(RUSTC) $(RUSTFLAGS) +build/bin/sleep: src/sleep.rs build rustlibs + $(RUSTC) $(RUSTFLAGS) \ --extern sysexits=build/o/libsysexits.rlib \ -o $@ src/sleep.rs From b06c1d5488614b077f9b50e64bab83263acf8722 Mon Sep 17 00:00:00 2001 From: DTB Date: Fri, 3 May 2024 21:22:38 -0600 Subject: [PATCH 4/7] sleep(1): reduce dependence on sysexits --- src/sleep.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/sleep.rs b/src/sleep.rs index f5af47d..3226802 100644 --- a/src/sleep.rs +++ b/src/sleep.rs @@ -24,7 +24,7 @@ use std::{ }; extern crate sysexits; -use sysexits::{EX_OK, EX_USAGE}; +use sysexits::EX_USAGE; fn usage(s: &str) -> ExitCode { eprintln!("Usage: {} [seconds]", s); @@ -37,7 +37,7 @@ fn main() -> ExitCode { if argv.len() == 2 { if let Ok(s) = argv[1].parse::() { sleep(Duration::from_secs(s)); - ExitCode::from(EX_OK as u8) + ExitCode::SUCCESS } else { usage(&argv[0]) } From 327c71c8ae52215818567a02c8536c73e6f4e72a Mon Sep 17 00:00:00 2001 From: DTB Date: Fri, 3 May 2024 21:29:49 -0600 Subject: [PATCH 5/7] sleep.1: import from trinity/src --- docs/sleep.1 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 docs/sleep.1 diff --git a/docs/sleep.1 b/docs/sleep.1 new file mode 100644 index 0000000..09cace0 --- /dev/null +++ b/docs/sleep.1 @@ -0,0 +1,48 @@ +.TH SLEEP 1 + +.SH NAME + +sleep \(en wait a moment + +.SH SYNOPSIS + +sleep +.RB [ seconds ] + +.SH DESCRIPTION + +Sleep waits the given amount of seconds before exiting. + +.SH DIAGNOSTICS + +Sleep exits successfully when the time specified has elapsed, or unsuccessfully +if the time fails to elapse or if invoked incorrectly. In the latter scenario +sleep will also print a usage synopsis. + +.SH BUGS + +User may still be tired after invoking sleep. + +.SH EXAMPLES + +The following invocation sleeps for five seconds. + +.RS +.R sleep 5 +.RE + +The following sh(1p) command line sleeps for five minutes, or for sixty +seconds, five times, using rpn(1) and xargs(1p). + +.RS +.R $ rpn 60 5 '*' | xargs sleep +.RE + +.SH COPYRIGHT + +Copyright (c) 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later +. + +.SH SEE ALSO + +sleep(3) From 003f5aeb1f65f08334beb4629f7e493fbb47dc7a Mon Sep 17 00:00:00 2001 From: DTB Date: Fri, 3 May 2024 21:30:39 -0600 Subject: [PATCH 6/7] Makefile: add sleep to the all recipe --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 09110e3..0099840 100644 --- a/Makefile +++ b/Makefile @@ -28,7 +28,7 @@ RUSTLIBS = --extern getopt=build/o/libgetopt.rlib \ CFLAGS += -I$(SYSEXITS) .PHONY: all -all: dj false fop hru intcmp mm npc rpn scrut str strcmp swab true +all: dj false fop hru intcmp mm npc rpn scrut sleep str strcmp swab true build: # keep build/include until bindgen(1) has stdin support From ba55c4c8e7812595c5f6141e5e9b5b29709928a5 Mon Sep 17 00:00:00 2001 From: DTB Date: Fri, 3 May 2024 21:32:10 -0600 Subject: [PATCH 7/7] sleep.1: add copyright header --- docs/sleep.1 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/sleep.1 b/docs/sleep.1 index 09cace0..5b7108b 100644 --- a/docs/sleep.1 +++ b/docs/sleep.1 @@ -1,3 +1,8 @@ +.\" Copyright (c) 2024 DTB +.\" +.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license, +.\" visit . + .TH SLEEP 1 .SH NAME