Hacking

Cargo.toml

@@ -9,6 +9,7 @@ members = [
 	"misc",
 	"pathnames",
 	"plib",
+	"sys",
 	"text",
 	"tree",
 	"users",

README.md

@@ -151,9 +151,9 @@ A similar project from the author, written in C++, is https://github.com/jgarzik
  - [ ] tr
  - [x] true
  - [ ] tsort
- - [ ] tty
+ - [x] tty
  - [ ] ulimit
- - [ ] uname
+ - [x] uname
  - [ ] uncompress (compress cat.)
  - [ ] unexpand
  - [ ] unget

display/src/echo.rs

@@ -6,15 +6,20 @@
 // file in the root directory of this project.
 // SPDX-License-Identifier: MIT
 //
+// TODO:
+// - echo needs to translate backslash-escaped octal numbers:
+// ```
+// \0num
+//	Write an 8-bit value that is the 0, 1, 2 or 3-digit octal number _num_.
+//
 
 extern crate plib;
 
 use gettextrs::{bind_textdomain_codeset, textdomain};
 use plib::PROJECT_NAME;
 
 fn translate_str(s: &str) -> String {
-    let mut output = String::new();
-    output.reserve(s.len());
+    let mut output = String::with_capacity(s.len());
 
     let mut in_bs = false;
     let mut nl = true;

file/src/cat.rs

@@ -6,6 +6,11 @@
 // file in the root directory of this project.
 // SPDX-License-Identifier: MIT
 //
+// TODO:
+// - Bug:  if stdout write_all() produces Err, the program will erroneously
+//   output the filename as the culprit, rather than the string "stdout"
+// - Questionable behavior:  if write_all() produces Err, the program will
+//   continue to the next file, rather than stopping.
 
 extern crate clap;
 extern crate plib;

link/src/link.rs

@@ -15,6 +15,7 @@ use gettextrs::{bind_textdomain_codeset, textdomain};
 use plib::PROJECT_NAME;
 use std::{fs, io};
 
+/// link - call link function
 #[derive(Parser, Debug)]
 #[command(author, version, about, long_about)]
 struct Args {

link/src/ln.rs

@@ -16,6 +16,7 @@ use plib::PROJECT_NAME;
 use std::path::{Path, PathBuf};
 use std::{fs, io};
 
+/// ln - link files
 #[derive(Parser, Debug)]
 #[command(author, version, about, long_about)]
 struct Args {

link/src/unlink.rs

@@ -15,9 +15,11 @@ use gettextrs::{bind_textdomain_codeset, textdomain};
 use plib::PROJECT_NAME;
 use std::{fs, io};
 
+/// unlink - call the unlink function
 #[derive(Parser, Debug)]
 #[command(author, version, about, long_about)]
 struct Args {
+    /// The pathname of an existing file.
     pathname: String,
 }
 

pathnames/src/basename.rs

@@ -15,6 +15,7 @@ use gettextrs::{bind_textdomain_codeset, textdomain};
 use plib::PROJECT_NAME;
 use std::path::Path;
 
+/// basename - return non-directory portion of a pathname
 #[derive(Parser, Debug)]
 #[command(author, version, about, long_about)]
 struct Args {

pathnames/src/dirname.rs

@@ -15,6 +15,7 @@ use gettextrs::{bind_textdomain_codeset, textdomain};
 use plib::PROJECT_NAME;
 use std::path::PathBuf;
 
+/// dirname - return the directory portion of a pathname
 #[derive(Parser, Debug)]
 #[command(author, version, about, long_about)]
 struct Args {

sys/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "posixutils-sys"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+plib = { path = "../plib" }
+clap = { version = "4", features = ["derive"] }
+gettext-rs = { version = "0.7", features = ["gettext-system"] }
+uname = "0.1"
+
+[[bin]]
+name = "uname"
+path = "src/uname.rs"
+

sys/src/uname.rs

@@ -0,0 +1,98 @@
+//
+// Copyright (c) 2024 Jeff Garzik
+//
+// This file is part of the posixutils-rs project covered under
+// the MIT License.  For the full license text, please see the LICENSE
+// file in the root directory of this project.
+// SPDX-License-Identifier: MIT
+//
+// TODO:
+// - the "-v" option is specified by POSIX and cannot be clap default -v
+//
+
+extern crate clap;
+extern crate plib;
+extern crate uname;
+
+use clap::Parser;
+use gettextrs::{bind_textdomain_codeset, textdomain};
+use plib::PROJECT_NAME;
+
+/// uname - return system name
+#[derive(Parser, Debug)]
+#[command(author, version, about, long_about)]
+struct Args {
+    /// Behave as though all of the options -mnrsv were specified.
+    #[arg(short, long)]
+    all: bool,
+
+    /// Write the name of the hardware type on which the system is running to standard output.
+    #[arg(short, long)]
+    machine: bool,
+
+    /// Write the name of this node within an implementation-defined communications network.
+    #[arg(short, long)]
+    node: bool,
+
+    /// Write the current release level of the operating system implementation.
+    #[arg(short, long)]
+    release: bool,
+
+    /// Write the name of the implementation of the operating system.
+    #[arg(short, long)]
+    system: bool,
+
+    /// Write the current version level of this release of the operating system implementation.
+    #[arg(short, long)]
+    osversion: bool,
+}
+
+fn print_info(args: &Args, info: uname::Info) {
+    let mut outs = Vec::new();
+
+    if args.system {
+        outs.push(info.sysname);
+    }
+    if args.node {
+        outs.push(info.nodename);
+    }
+    if args.release {
+        outs.push(info.release);
+    }
+    if args.osversion {
+        outs.push(info.version);
+    }
+    if args.machine {
+        outs.push(info.machine);
+    }
+
+    println!("{}", outs.join(" "));
+}
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // parse command line arguments
+    let mut args = Args::parse();
+
+    if args.all {
+        args.machine = true;
+        args.node = true;
+        args.release = true;
+        args.system = true;
+        args.osversion = true;
+    }
+
+    textdomain(PROJECT_NAME)?;
+    bind_textdomain_codeset(PROJECT_NAME, "UTF-8")?;
+
+    let mut exit_code = 0;
+
+    match uname::uname() {
+        Ok(info) => print_info(&args, info),
+        Err(e) => {
+            eprintln!("{}", e);
+            exit_code = 1;
+        }
+    }
+
+    std::process::exit(exit_code)
+}