argued(1): re-write in Rust

Makefile

@@ -32,7 +32,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: argued dj false fop hru intcmp mm npc rpn scrut str strcmp swab true
 
 # keep build/include until bindgen(1) has stdin support
 # https://github.com/rust-lang/rust-bindgen/issues/2703
@@ -87,6 +87,11 @@ build/o/libsysexits.rlib: build/include/sysexits.h
 build/include/sysexits.h: build $(SYSEXITS)sysexits.h
 	printf '\043define EXIT_FAILURE 1\n' | cat - $(SYSEXITS)sysexits.h > $@
 
+.PHONY: argued
+argued: build/bin/argued
+build/bin/argued: src/argued.rs build
+	$(RUSTC) $(RUSTFLAGS) -o $@ src/argued.rs
+
 .PHONY: dj
 dj: build/bin/dj
 build/bin/dj: src/dj.c build

docs/argued.1

@@ -0,0 +1,28 @@
+.\" Copyright (c) 2022–2024 DTB <trinity@trinity.moe>
+.\"
+.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
+.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
+.\"
+.TH ARGUED 1 2024-07-23 "Harakit-overgrown X.X.X"
+.SH NAME
+argued \(en check for arguments
+.\"
+.SH DESCRIPTION
+
+.BR argued (1)
+exits successfully if any arguments are provided, and unsuccessfully
+otherwise.
+.\"
+.SH AUTHOR
+
+Written by DTB
+.MT trinity@trinity.moe
+.ME .
+.\"
+.SH COPYRIGHT
+
+This work is marked with CC0 1.0. To see a copy of this license, visit
+<http://creativecommons.org/publicdomain/zero/1.0>.
+.\"
+.SH SEE ALSO
+.BR test (1)

docs/simexec.1

@@ -1,49 +0,0 @@
-.TH SIMEXEC 1
-
-.SH NAME
-
-simexec \(en execute a program with the given argv
-
-.SH SYNOPSIS
-
-simexec
-.RB [ pathname ]
-.RB [ argv... ]
-
-.SH DESCRIPTION
-
-Simexec executes a given program with the given argv.
-
-.SH PITFALLS
-
-Non-binary programs cannot be executed. The PATH environment variable is not used and a valid pathname (relative or absolute) must be specified.
-.PP
-Simexec relies on the user to take proper precautions.
-argv is not just the operands for the program but in fact directly the argv it will receive in runtime;
-the first argv entry is the program's name, and forgoing this, though acceptable by simexec, can break customary assumptions.
-for example, the true(1) implementation in the GNU coreutils suffers a segmentation fault if there is no argv[0].
-.PP
-While POSIX.1-2017 doesn't mandate there being an argv[0] per se a Strictly Conforming POSIX Application must pass an argv[0].
-It has also been said that those who do not pass an argv[0] are mean and nasty and smell of elderberries.
-.PP
-Simexec directly uses the execv library function. It cannot execute shell scripts intelligently (via shebang).
-It is inadviseable to use simexec as an alternative to simply calling a program, and in fact probably inadviseable to use simexec at all.
-
-.SH DIAGNOSTICS
-
-Simexec returns the value of execv(3), which will be -1 (or 0xFF; 255) if an error occurs.
-This is not distinguishable from the executed program returning the same exit status.
-.PP
-Simexec will print a error message and return the proper sysexits(3) value if used in an invalid manner.
-
-.SH COPYRIGHT
-
-Public domain.
-
-.SH SEE ALSO
-
-exec(3)
-.PP
-The C89 standard's draft, section 2.1.2.2: "Hosted environment".
-.PP
-POSIX.1-2017 System Interfaces: execv. Particularly under the RATIONALE section header.

src/argued.rs

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 DTB <trinity@trinity.moe>
+ * Copyright (c) 2022_2024 DTB <trinity@trinity.moe>
  * SPDX-License-Identifier: AGPL-3.0-or-later
  *
  * This program is free software: you can redistribute it and/or modify it under
@@ -16,20 +16,13 @@
  * along with this program. If not, see https://www.gnu.org/licenses/.
  */
 
-#include <stdio.h> /* fprintf(3), NULL */
-#include <unistd.h> /* execv(3), */
-#include <sysexits.h> /* EX_USAGE */
+ use std::{ env::args, process::ExitCode };
 
-char *program_name = "simexec";
+ fn main() -> ExitCode {
+ 	let argv = args().collect::<Vec<String>>();
 
-int main(int argc, char *argv[]){
-
-	if(argc < 2){
-		fprintf(stderr, "Usage: %s binary argv...\n",
-			argv[0] == NULL ? program_name : argv[0]
-		);
-		return EX_USAGE;
-	}
-
-	execv(argv[1], &argv[2]);
-}
+ 	match argv.len() {
+ 		0 | 1 => ExitCode::FAILURE,
+ 		_ =>     ExitCode::SUCCESS
+ 	}
+ }