logo

utils-std

commit: 7829de7fe2aa543f80f996088f83672d485122af
parent 9b77db4471c3d5661d1c26028a512d2f0a8b325e
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date:   Sun, 24 Sep 2023 15:46:13 +0200

Update description and README


Diffstat:


MREADME.md24+++++++++++++++---------


Mcmd/base64.c2+-


Mcmd/basename.12+-


Mcmd/basename.c2+-


Mcmd/cat.12+-


Mcmd/cat.c2+-


Mcmd/chroot.12+-


Mcmd/chroot.c2+-


Mcmd/date.12+-


Mcmd/date.c2+-


Mcmd/dirname.12+-


Mcmd/dirname.c2+-


Mcmd/echo.12+-


Mcmd/echo.c2+-


Mcmd/env.12+-


Mcmd/env.c2+-


Mcmd/false.12+-


Mcmd/id.c2+-


Mcmd/link.12+-


Mcmd/link.c2+-


Mcmd/nproc.c2+-


Mcmd/pwd.c2+-


Mcmd/seq.c2+-


Mcmd/sleep.12+-


Mcmd/sleep.c2+-


Mcmd/strings.12+-


Mcmd/strings.c2+-


Mcmd/sync.12+-


Mcmd/sync.c2+-


Mcmd/tee.c2+-


Mcmd/time.12+-


Mcmd/time.c2+-


Mcmd/touch.12+-


Mcmd/touch.c2+-


Mcmd/true.12+-


Mcmd/tty.c2+-


Mcmd/unlink.12+-


Mlib/iso_parse.c2+-


Mlib/iso_parse.h2+-


39 files changed, 53 insertions(+), 47 deletions(-)

diff --git a/README.md b/README.md
@@ -1,16 +1,22 @@
-<!--
-SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
+# utils-std: utils-std: Collection of commonly available Unix tools
+Copyright 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 SPDX-License-Identifier: MPL-2.0
--->
 
-Collection of Unix tools, comparable to coreutils
-Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
-SPDX-License-Identifier: MPL-2.0
+This is a repository of my own implementations of commonly available Unix system tools, mostly using POSIX as a guide but tools also commonly available across different Unix-like systems shall be available here.
+
+Tested on Linux(musl), FreeBSD, NetBSD, OpenBSD: <https://builds.sr.ht/~lanodan/utils>
+
+## Goals
+- (long-run) Effectively serve as one of the blocks to replace BusyBox, GNU coreutils, …
+- Keep the code readable and hackable
+- Portability
+- Efficient, but not without sacrifying the other goals
 
-Tested on Linux(musl), FreeBSD, NetBSD, OpenBSD:
-<https://builds.sr.ht/~lanodan/utils>
+## Non-Goals
+- Reimplement complex tools that already have great code or ought to be maintained separately
+- Implement niche tools, [utils-extra](https://hacktivis.me/git/utils-extra) and [moreutils](https://joeyh.name/code/moreutils/)
 
-# Dependencies
+## Dependencies
 - POSIX System
 - (optional, test) ATF: <https://github.com/jmmv/atf>
 - (optional, test) Kyua: <https://github.com/jmmv/kyua>
diff --git a/cmd/base64.c b/cmd/base64.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/basename.1 b/cmd/basename.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2021-04-05
diff --git a/cmd/basename.c b/cmd/basename.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/cat.1 b/cmd/cat.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-02-13
diff --git a/cmd/cat.c b/cmd/cat.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/chroot.1 b/cmd/chroot.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2023-08-04
diff --git a/cmd/chroot.c b/cmd/chroot.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/date.1 b/cmd/date.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2023-06-03
diff --git a/cmd/date.c b/cmd/date.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/dirname.1 b/cmd/dirname.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2021-04-05
diff --git a/cmd/dirname.c b/cmd/dirname.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/echo.1 b/cmd/echo.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2023-05-31
diff --git a/cmd/echo.c b/cmd/echo.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/env.1 b/cmd/env.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-04-19
diff --git a/cmd/env.c b/cmd/env.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/false.1 b/cmd/false.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-02-13
diff --git a/cmd/id.c b/cmd/id.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/link.1 b/cmd/link.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-04-22
diff --git a/cmd/link.c b/cmd/link.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/nproc.c b/cmd/nproc.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/pwd.c b/cmd/pwd.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/seq.c b/cmd/seq.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/sleep.1 b/cmd/sleep.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-11-19
diff --git a/cmd/sleep.c b/cmd/sleep.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/strings.1 b/cmd/strings.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2023-08-11
diff --git a/cmd/strings.c b/cmd/strings.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/sync.1 b/cmd/sync.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2021-12-27
diff --git a/cmd/sync.c b/cmd/sync.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/tee.c b/cmd/tee.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/time.1 b/cmd/time.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-12-01
diff --git a/cmd/time.c b/cmd/time.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/touch.1 b/cmd/touch.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2023-06-03
diff --git a/cmd/touch.c b/cmd/touch.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/true.1 b/cmd/true.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-02-13
diff --git a/cmd/tty.c b/cmd/tty.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/cmd/unlink.1 b/cmd/unlink.1
@@ -1,4 +1,4 @@
-.\" Collection of Unix tools, comparable to coreutils
+.\" utils-std: Collection of commonly available Unix tools
 .\" Copyright 2017-2022 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 .\" SPDX-License-Identifier: MPL-2.0
 .Dd 2022-05-10
diff --git a/lib/iso_parse.c b/lib/iso_parse.c
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0
 
diff --git a/lib/iso_parse.h b/lib/iso_parse.h
@@ -1,4 +1,4 @@
-// Collection of Unix tools, comparable to coreutils
+// utils-std: Collection of commonly available Unix tools
 // SPDX-FileCopyrightText: 2023 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
 // SPDX-License-Identifier: MPL-2.0