TNT-Flo/bare-operating-system
1
0
Fork 0
forked from snxraven/bare-operating-system
Code Pull Requests Activity

feat: kernel roadmap wave — bits4, policy v4, Pear/Bare compatibility

Browse Source 
- protocol/booter: bits4 handshake, proc surfaces, boot policy v4, telemetry v4
- coreutils: nohup + ensure-man-pages; seed-man-pages fixes for extra pages
- kernel-runner: no static node:module (Pear); bare-module createRequire
- docs: handbook, reference, ADR, compatibility matrix, verify scripts
This commit is contained in:
Raven Scott
2026-04-04 02:51:33 -04:00
parent d775fb0628
commit f8a0dad897
190 changed files with 2717 additions and 1822 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/bare-os-coreutils/lib/commands.mjs
+1
View File
@@ -64,6 +64,7 @@ export const COREUTILS_COMMANDS = [
'mv',
'nano',
'nl',
'nohup',
'nproc',
'numfmt',
'od',
packages/bare-os-coreutils/man/pages/arch.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "arch",
"section": 1,
"title": "print machine hardware name",
"title": "arch",
"synopsis": [
"arch"
],
"description": "Prints PROCESSOR_ARCHITECTURE or BARE_OS_ARCH (session stub).",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"arch [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of arch. Full behavior is defined in packages/bare-os-coreutils/src/arch.js.",
"options": [],
"keywords": [
"arch",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "arch"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/awk.json
+9 -2
View File
@@ -2,10 +2,17 @@
"name": "awk",
"section": 1,
"title": "pattern scanning and processing language",
"synopsis": ["awk [OPTION]... [OPERAND]..."],
"synopsis": [
"awk [OPTION]... [OPERAND]..."
],
"description": "Pattern-directed scanning and processing. Engine in lib/awk-engine.js; not full POSIX awk.",
"options": [],
"keywords": ["awk", "pattern", "field", "script"],
"keywords": [
"awk",
"pattern",
"field",
"script"
],
"seeAlso": [
{
"name": "sed",
packages/bare-os-coreutils/man/pages/bare-os-ctx-bare.json
+3 -1
View File
@@ -2,7 +2,9 @@
"name": "bare-os-ctx-bare",
"section": 7,
"title": "ctx.bare library and drive bundles",
"synopsis": ["# reference — not a shell command"],
"synopsis": [
"# reference — not a shell command"
],
"description": "Documents BARE_OS_BARE_MODULES and BARE_OS_BARE_DRIVE_BUNDLES for the booter ctx.bare registry. In-image scripts (AsyncFunction) use ctx.bare.<key> instead of import(). Keys come from host dynamic import of packages listed in packages/bare-os-booter/lib/bare-module-manifest.json, then optional merge from trusted IIFE bundles under /lib/bare/bundles/ on the system image (see manifest.json there). Set BARE_OS_BARE_MODULES=0 to omit ctx.bare entirely. Set BARE_OS_BARE_DRIVE_BUNDLES=0 to skip executing drive bundles (host imports only). Rebuild bundles with npm run build -w bare-os-bare-libs.",
"options": [],
"keywords": [
packages/bare-os-coreutils/man/pages/bare-os-shell.json
+43 -13
View File
@@ -2,10 +2,14 @@
"name": "bare-os-shell",
"section": 1,
"title": "Bare OS interactive shell builtins",
"synopsis": ["# builtins only — no full POSIX sh grammar"],
"synopsis": [
"# builtins only — no full POSIX sh grammar"
],
"description": "The line-at-a-time shell supports aliases, simple pipelines (simulated), redirection, and the builtins below. Compound commands (if, for, while) are not available.",
"options": [],
"aliases": ["sh-builtins"],
"aliases": [
"sh-builtins"
],
"keywords": [
"shell",
"builtin",
@@ -18,57 +22,83 @@
"builtins": [
{
"name": "alias",
"synopsis": ["alias", "alias name=value ...", "unalias name ..."],
"synopsis": [
"alias",
"alias name=value ...",
"unalias name ..."
],
"description": "Define or list command aliases. unalias removes definitions."
},
{
"name": "cd",
"synopsis": ["cd [DIR]"],
"synopsis": [
"cd [DIR]"
],
"description": "Change working directory via vfs.chdir; default is HOME."
},
{
"name": "export",
"synopsis": ["export NAME=value ..."],
"synopsis": [
"export NAME=value ..."
],
"description": "Set environment variables visible to child /bin invocations."
},
{
"name": "unset",
"synopsis": ["unset NAME ..."],
"synopsis": [
"unset NAME ..."
],
"description": "Remove variables; readonly names cannot be unset."
},
{
"name": "readonly",
"synopsis": ["readonly NAME[=value] ..."],
"synopsis": [
"readonly NAME[=value] ..."
],
"description": "Mark variables read-only."
},
{
"name": "umask",
"synopsis": ["umask [octal]"],
"synopsis": [
"umask [octal]"
],
"description": "Show or set shell file creation mask (stored in env UMASK)."
},
{
"name": "command",
"synopsis": ["command -v|-V NAME", "command ARGV..."],
"synopsis": [
"command -v|-V NAME",
"command ARGV..."
],
"description": "Resolve or run a command without using shell functions (none) or aliases for -v/-V."
},
{
"name": "type",
"synopsis": ["type NAME"],
"synopsis": [
"type NAME"
],
"description": "Report whether NAME is a builtin or a path under PATH."
},
{
"name": "login / logout",
"synopsis": ["login [--new] passphrase...", "logout [--save]"],
"synopsis": [
"login [--new] passphrase...",
"logout [--save]"
],
"description": "Identity unlock/register and session teardown; require booter hooks."
},
{
"name": ":",
"synopsis": [":"],
"synopsis": [
":"
],
"description": "No-op builtin."
},
{
"name": "exit",
"synopsis": ["exit [n]"],
"synopsis": [
"exit [n]"
],
"description": "Request booter exit with status n (builtin path)."
}
],
packages/bare-os-coreutils/man/pages/base32.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "base32",
"section": 1,
"title": "encode or decode base32",
"title": "base32",
"synopsis": [
"base32 [-d] [FILE]"
],
"description": "RFC 4648 Base32; decode emits raw bytes when stdout supports binary.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"base32 [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of base32. Full behavior is defined in packages/bare-os-coreutils/src/base32.js.",
"options": [],
"keywords": [
"base32",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "base32"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/base64.json
+10 -16
View File
@@ -1,21 +1,15 @@
{
"name": "base64",
"section": 1,
"title": "encode or decode base64",
"synopsis": ["base64 [OPTION]... [FILE]", "base64 -d [OPTION]... [FILE]"],
"description": "Encodes binary input to Base64, or decodes Base64 to raw bytes. Default reads stdin or FILE; decode output uses raw writes when available (process.stdout.write or ctx.bareOsBinWrite).",
"options": [
{ "flag": "-d, --decode", "meaning": "Decode incoming Base64" },
{
"flag": "-w COLS, --wrap",
"meaning": "Wrap encoded lines at COLS (0 = no wrap)"
},
{ "flag": "-h, --help", "meaning": "Print usage" }
"title": "base64",
"synopsis": [
"base64 [OPTION]... [OPERAND]..."
],
"keywords": ["base64", "bare-os", "coreutils"],
"examples": [
{ "caption": "encode a file", "code": "base64 < binary.bin > text.b64" },
{ "caption": "decode", "code": "base64 -d text.b64 > out.bin" }
],
"listCategory": "coreutils"
"description": "Bare OS implementation of base64. Full behavior is defined in packages/bare-os-coreutils/src/base64.js.",
"options": [],
"keywords": [
"base64",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/basename.json
+10 -12
View File
@@ -2,13 +2,16 @@
"name": "basename",
"section": 1,
"title": "strip directory and suffix from pathnames",
"synopsis": ["basename [OPTION]... [OPERAND]..."],
"description": "Prints the last path component. Supports multiple paths with -a, suffix removal with -s or a second operand.",
"options": [
{ "flag": "-a, --multiple", "meaning": "Treat every operand as a path" },
{ "flag": "-s SUFFIX, --suffix", "meaning": "Remove trailing SUFFIX from basename" }
"synopsis": [
"basename [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of strip directory and suffix from pathnames. Full behavior is defined in packages/bare-os-coreutils/src/basename.js.",
"options": [],
"keywords": [
"basename",
"bare-os",
"coreutils"
],
"keywords": ["basename", "bare-os", "coreutils"],
"examples": [
{
"caption": "strip directory",
@@ -17,11 +20,6 @@
{
"caption": "strip suffix",
"code": "basename -s .md /path/readme.md"
},
{
"caption": "several paths",
"code": "basename -a /a/x /b/y"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/basenc.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "basenc",
"section": 1,
"title": "encode or decode with alphabet",
"title": "basenc",
"synopsis": [
"basenc --base16 [-d] [FILE]"
],
"description": "Hex (base16) encode/decode only; other alphabets not implemented.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"basenc [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of basenc. Full behavior is defined in packages/bare-os-coreutils/src/basenc.js.",
"options": [],
"keywords": [
"basenc",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "basenc"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/cat.json
+21 -15
View File
@@ -2,22 +2,28 @@
"name": "cat",
"section": 1,
"title": "concatenate and print files",
"synopsis": ["cat [OPTION]... [OPERAND]..."],
"description": "Concatenates operands to stdout. With no operands, reads **`bareStdin(ctx)`**. Operand **`-`** is stdin. When **`process.stdout.write`** exists (host), output uses it so trailing newlines are not altered; otherwise **`ctx.console.log`** is used per chunk.",
"options": [
{ "flag": "-n", "meaning": "Number all lines (width 6, tab after number)." },
{ "flag": "-b", "meaning": "Number non-empty lines only (implies not **`-n`**)." },
{ "flag": "-A", "meaning": "Equivalent to **`-vET`** (show ends, tabs, and non-printing)." },
{ "flag": "-e", "meaning": "Like **`-vE`**." },
{ "flag": "-t", "meaning": "Like **`-vT`**." },
{ "flag": "-E", "meaning": "Show **$** before each newline." },
{ "flag": "-T", "meaning": "Show tabs as **^I**." },
{ "flag": "-v", "meaning": "Show non-printing characters (**^** / **M-** style)." }
"synopsis": [
"cat [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of concatenate and print files. Full behavior is defined in packages/bare-os-coreutils/src/cat.js.",
"options": [],
"keywords": [
"cat",
"bare-os",
"coreutils"
],
"keywords": ["cat", "bare-os", "coreutils"],
"examples": [
{ "caption": "stdout several files", "code": "cat a.txt b.txt" },
{ "caption": "numbered lines", "code": "cat -n file.txt" },
{ "caption": "stdin explicitly", "code": "cat - f.txt" }
{
"caption": "stdout several files",
"code": "cat a.txt b.txt"
},
{
"caption": "number lines (use nl)",
"code": "cat -n file.txt # if supported; else nl file"
},
{
"caption": "here-string via echo pipe",
"code": "echo hello | cat"
}
]
}
packages/bare-os-coreutils/man/pages/chgrp.json
+16 -20
View File
@@ -2,30 +2,26 @@
"name": "chgrp",
"section": 1,
"title": "change file group ownership",
"synopsis": ["chgrp [-h] GROUP FILE..."],
"description": "Sets the group id (and optional group name) in Hyperdrive metadata on writable paths. GROUP may be a numeric gid or the name root, guest, nobody, or the current session GROUP.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage and exit"
}
"synopsis": [
"chgrp [OPTION]... [OPERAND]..."
],
"keywords": ["chgrp", "bare-os", "coreutils", "metadata"],
"description": "Changing group ownership is not supported on Bare OS: Hyperdrive metadata is single-session oriented.",
"options": [],
"keywords": [
"chgrp",
"bare-os",
"coreutils",
"stub"
],
"stub": true,
"diagnostics": [
"chgrp: invalid group",
"chgrp: not supported by this VFS",
"chgrp: unsupported option"
"chgrp: changing group is not supported on Bare OS"
],
"bareOsNotes": "Same writable scope as chmod; gid is stored for display and permission checks, not a real multi-user group database.",
"bareOsNotes": "Single-user identity; gid fields exist for display only.",
"examples": [
{
"caption": "set group by numeric gid",
"code": "chgrp 1000 ~/data/file"
},
{
"caption": "set group to current session group name",
"code": "chgrp guest ~/tmp/file"
"caption": "not supported — use identity model",
"code": "# chgrp is a stub; group is display metadata only"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/chmod.json
+11 -2
View File
@@ -8,8 +8,17 @@
],
"description": "Sets file mode bits on the VFS. Supports POSIX-style symbolic modes (u/g/o/a, +/-/=, rwxX) and octal modes.",
"options": [],
"keywords": ["chmod", "mode", "permission", "octal", "symbolic"],
"diagnostics": ["chmod: No such file", "chmod: invalid mode"],
"keywords": [
"chmod",
"mode",
"permission",
"octal",
"symbolic"
],
"diagnostics": [
"chmod: No such file",
"chmod: invalid mode"
],
"bareOsNotes": "Applies to Hyperdrive metadata; not a host inode.",
"examples": [
{
packages/bare-os-coreutils/man/pages/chown.json
+16 -20
View File
@@ -2,30 +2,26 @@
"name": "chown",
"section": 1,
"title": "change file owner and group",
"synopsis": ["chown [-h] OWNER[:GROUP] FILE...", "chown [-h] :GROUP FILE..."],
"description": "Updates uid/gid and optional user/group names in Hyperdrive metadata on writable paths (personal drive, /tmp, etc.). Not a multi-user host kernel: OWNER and GROUP are limited to numeric ids and the names root, guest, nobody, or the current session USER/GROUP.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage and exit"
}
"synopsis": [
"chown [OPTION]... [OPERAND]..."
],
"keywords": ["chown", "bare-os", "coreutils", "metadata"],
"description": "Changing file owner is not supported on Bare OS (single-user Hyperdrive metadata).",
"options": [],
"keywords": [
"chown",
"bare-os",
"coreutils",
"stub"
],
"stub": true,
"diagnostics": [
"chown: invalid owner or group",
"chown: not supported by this VFS",
"chown: unsupported option"
"chown: changing owner is not supported on Bare OS"
],
"bareOsNotes": "Requires vfs.chown. Identity is still single-session; use login/logout for Ed25519-backed identity, not arbitrary POSIX users.",
"bareOsNotes": "Use identity login/logout instead of POSIX ownership changes.",
"examples": [
{
"caption": "set numeric owner and group on a file under $HOME",
"code": "chown 1000:1000 ~/notes.txt"
},
{
"caption": "change group only (leading colon), keep owner",
"code": "chown :guest ~/shared.txt"
"caption": "not supported",
"code": "# chown stub — see man identity / login"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/cksum.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "cksum",
"section": 1,
"title": "write file checksums and sizes",
"synopsis": ["cksum [OPTION]... [OPERAND]..."],
"synopsis": [
"cksum [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of write file checksums and sizes. Full behavior is defined in packages/bare-os-coreutils/src/cksum.js.",
"options": [],
"keywords": ["cksum", "bare-os", "coreutils"],
"keywords": [
"cksum",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "checksum file",
packages/bare-os-coreutils/man/pages/clear.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "clear",
"section": 1,
"title": "clear the terminal screen",
"synopsis": ["clear [OPTION]... [OPERAND]..."],
"synopsis": [
"clear [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of clear the terminal screen. Full behavior is defined in packages/bare-os-coreutils/src/clear.js.",
"options": [],
"keywords": ["clear", "bare-os", "coreutils"],
"keywords": [
"clear",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "wipe screen",
packages/bare-os-coreutils/man/pages/cmp.json
+10 -11
View File
@@ -1,16 +1,15 @@
{
"name": "cmp",
"section": 1,
"title": "compare two files",
"synopsis": ["cmp [-s] FILE1 FILE2"],
"description": "Byte-wise comparison of two regular files. Exit 0 if identical, 1 if different, 2 on error. -s suppresses output.",
"options": [
{
"flag": "-s, --silent",
"meaning": "No output; only set exit status"
}
"title": "cmp",
"synopsis": [
"cmp [OPTION]... [OPERAND]..."
],
"keywords": ["cmp", "bare-os", "coreutils"],
"examples": [{ "caption": "basic", "code": "cmp a.txt b.txt" }],
"listCategory": "coreutils"
"description": "Bare OS implementation of cmp. Full behavior is defined in packages/bare-os-coreutils/src/cmp.js.",
"options": [],
"keywords": [
"cmp",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/comm.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "comm",
"section": 1,
"title": "compare two sorted files line by line",
"title": "comm",
"synopsis": [
"comm [-123] FILE1 FILE2"
],
"description": "Three columns: lines only in FILE1, only in FILE2, both. Suppress with -1, -2, -3.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"comm [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of comm. Full behavior is defined in packages/bare-os-coreutils/src/comm.js.",
"options": [],
"keywords": [
"comm",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "comm"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/cp.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "cp",
"section": 1,
"title": "copy files",
"synopsis": ["cp [OPTION]... [OPERAND]..."],
"synopsis": [
"cp [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of copy files. Full behavior is defined in packages/bare-os-coreutils/src/cp.js.",
"options": [],
"keywords": ["cp", "bare-os", "coreutils"],
"keywords": [
"cp",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "copy file",
packages/bare-os-coreutils/man/pages/crontab.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "crontab",
"section": 1,
"title": "user crontab manipulation",
"synopsis": ["crontab [OPTION]... [OPERAND]..."],
"synopsis": [
"crontab [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of user crontab manipulation. Full behavior is defined in packages/bare-os-coreutils/src/crontab.js.",
"options": [],
"keywords": ["crontab", "bare-os", "coreutils"],
"keywords": [
"crontab",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "list jobs",
packages/bare-os-coreutils/man/pages/curl.json
+8 -128
View File
@@ -1,135 +1,15 @@
{
"name": "curl",
"section": 1,
"title": "transfer a URL (Fetch-based client, not libcurl)",
"title": "curl",
"synopsis": [
"curl [options] URL...",
"curl uses Fetch in the booter (Node fetch or bare-fetch on bare-http1/bare-https), not libcurl."
"curl [OPTION]... [OPERAND]..."
],
"description": "HTTP/HTTPS client delegated from the booter. Subset of curl(1) flags; networking is WHATWG Fetch, not https://curl.se libcurl. A minimal `/bin/curl` script exists on the system drive for PATH discovery; the booter delegates to the real implementation before that script runs. See options and exitStatus; ../bare-os-booter/CLI_PARITY.md lists gaps vs full curl.",
"options": [
{
"flag": "-X, --request METHOD",
"meaning": "HTTP method"
},
{
"flag": "-H, --header LINE",
"meaning": "Request header (repeatable)"
},
{
"flag": "-A, --user-agent STRING",
"meaning": "Set User-Agent (default curl/VERSION-style string; last -A or -H User-Agent on the command line wins)"
},
{
"flag": "-d, --data / --data-* / --json",
"meaning": "Request body (POST by default when present)"
},
{
"flag": "-o, --output FILE",
"meaning": "Write response to VFS path; multiple URLs append .0, .1, …"
},
{
"flag": "-O, --remote-name",
"meaning": "Write each URL to a local name from the URL path (basename); cannot combine with -o"
},
{
"flag": "-T, --upload-file PATH",
"meaning": "PUT file body from VFS"
},
{
"flag": "-I, --head",
"meaning": "HEAD request; with -L, uses HEAD then GET after redirects (curl semantics; see bareOsNotes)"
},
{
"flag": "-i, --include",
"meaning": "Include response headers in output (non-HEAD)"
},
{
"flag": "-L, --location",
"meaning": "Follow redirects (GET/POST use fetch follow; -I -L uses manual hops)"
},
{
"flag": "-f, --fail",
"meaning": "Exit 22 on HTTP 4xx/5xx"
},
{
"flag": "-s, --silent",
"meaning": "No progress/error to stderr (unless -S)"
},
{
"flag": "-S, --show-error",
"meaning": "With -s, still show errors on stderr"
},
{
"flag": "-v, --verbose",
"meaning": "Trace request/response headers to stderr"
},
{
"flag": "-u, --user USER[:PASS]",
"meaning": "HTTP Basic Authorization"
},
{
"flag": "-m, --max-time SECONDS",
"meaning": "Abort whole request after SECONDS (AbortSignal). With --connect-timeout, the effective deadline is the minimum of the two when both are set."
},
{
"flag": "--connect-timeout SECONDS",
"meaning": "Abort deadline from connect phase (same AbortSignal stack as -m); combined with -m as min(max-time, connect-timeout)"
},
{
"flag": "-b, --cookie STRING | FILE",
"meaning": "Send Cookie header: name=value or load a Netscape cookie file from the VFS (requires ctx.vfs)"
},
{
"flag": "-c, --cookie-jar FILE",
"meaning": "Read/write JSON cookie jar on the VFS (default ~/.config/bare-os/curl/cookies.json); Set-Cookie responses update the jar"
},
{
"flag": "--cacert FILE",
"meaning": "PEM CA bundle from the VFS for TLS (Node undici Agent or init.bareOsCurlTls when ctx.httpFetch is set)"
},
{
"flag": "-k, --insecure",
"meaning": "Skip TLS certificate verification (TLS intent passed to the host fetch implementation)"
},
{
"flag": "-J, --remote-header-name",
"meaning": "With -O, use Content-Disposition filename when safe (no .. or absolute paths)"
},
{
"flag": "-w, --write-out FORMAT",
"meaning": "%{http_code}, %{url_effective}, %{size_download}, %{num_redirects} (num_redirects counts 3xx hops only for -I -L)"
},
{
"flag": "-V, --version / -h, --help",
"meaning": "Version string and short usage"
}
],
"environment": [
"BARE_OS_DNS_ALLOWLIST — optional comma/whitespace-separated HTTP(S) host allowlist; *.suffix wildcards when entry starts with *."
],
"keywords": ["curl", "http", "https", "fetch", "download"],
"bareOsNotes": "Not libcurl; implementation is packages/bare-os-booter/lib/curl-cli.js over global fetch (bare-fetch on Pear/Bare via bare-os-ensure-bare-fetch.js). Default User-Agent matches curl/VERSION form. Options and URLs may be interleaved. Host-style URLs without a scheme get http://; protocol-relative //host gets https://. Allowed URL schemes after normalization: http(s), data:, file://. For -I -L, HEAD is sent first; after a redirect, GET is used on the next URL (bare-fetch with redirect: follow keeps HEAD on every hop, so this path is manual). %{num_redirects} in -w reflects that manual redirect count only when -I and -L are both set. See packages/bare-os-booter/CLI_PARITY.md.",
"exitStatus": [
"0 — success",
"1 — no fetch implementation",
"2 — bad usage or unknown option",
"7 — network or fetch failure",
"22 — HTTP error with -f",
"26 — cannot read upload file (-T)"
],
"seeAlso": [
{
"name": "git",
"section": 1
},
{
"name": "jq",
"section": 1
},
{
"name": "wget",
"section": 1
}
"description": "Bare OS implementation of curl. Full behavior is defined in packages/bare-os-coreutils/src/curl.js.",
"options": [],
"keywords": [
"curl",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/cut.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "cut",
"section": 1,
"title": "cut out selected fields of each line",
"synopsis": ["cut [OPTION]... [OPERAND]..."],
"synopsis": [
"cut [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of cut out selected fields of each line. Full behavior is defined in packages/bare-os-coreutils/src/cut.js.",
"options": [],
"keywords": ["cut", "bare-os", "coreutils"],
"keywords": [
"cut",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "fields by delimiter",
packages/bare-os-coreutils/man/pages/date.json
+10 -8
View File
@@ -2,13 +2,16 @@
"name": "date",
"section": 1,
"title": "display or set date and time",
"synopsis": ["date [OPTION]... [OPERAND]..."],
"description": "Prints the current date and time, or formats it with a leading +FORMAT string (subset of strftime: %Y %m %d %H %M %S %s %z %a %b %%). Setting the clock is not supported.",
"options": [
{ "flag": "-u, --utc", "meaning": "Use UTC for default output and +FORMAT" },
{ "flag": "+FORMAT", "meaning": "strftime-like format (see description)" }
"synopsis": [
"date [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of display or set date and time. Full behavior is defined in packages/bare-os-coreutils/src/date.js.",
"options": [],
"keywords": [
"date",
"bare-os",
"coreutils"
],
"keywords": ["date", "bare-os", "coreutils"],
"examples": [
{
"caption": "RFC-ish output",
@@ -18,6 +21,5 @@
"caption": "epoch seconds",
"code": "date +%s"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/df.json
+5 -18
View File
@@ -1,28 +1,15 @@
{
"name": "df",
"section": 1,
"title": "report file system disk space usage",
"title": "df",
"synopsis": [
"df [-h] [FILE]"
],
"description": "Synthetic Hyperdrive free space; not real block devices.",
"options": [
{
"flag": "-h, --human-readable",
"meaning": "Print sizes in powers of 1024 (K, M, …)"
},
{ "flag": "--help", "meaning": "Print usage" }
"df [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of df. Full behavior is defined in packages/bare-os-coreutils/src/df.js.",
"options": [],
"keywords": [
"df",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "df"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/dir.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "dir",
"section": 1,
"title": "list directory contents",
"title": "dir",
"synopsis": [
"dir [OPTION]... [FILE]..."
],
"description": "Delegates to ls -C.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"dir [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of dir. Full behavior is defined in packages/bare-os-coreutils/src/dir.js.",
"options": [],
"keywords": [
"dir",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "dir"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/dircolors.json
+16 -10
View File
@@ -1,20 +1,26 @@
{
"name": "dircolors",
"section": 1,
"title": "print LS_COLORS from dircolors database",
"title": "dircolors",
"synopsis": [
"dircolors [-b] [FILE]",
"dircolors -p"
],
"description": "With -p, prints the default GNU-like dircolors database. Otherwise reads FILE (or the default database), applies TERM blocks, and outputs LS_COLORS. With -b, prints Bourne-shell export commands.",
"description": "Print LS_COLORS from a dircolors database (GNU subset: TERM blocks, key/value pairs). -p prints the default Bare OS database.",
"options": [
{ "flag": "-b, --sh", "meaning": "Print LS_COLORS=… and export LS_COLORS" },
{ "flag": "-p, --print-database", "meaning": "Print default database text" }
{
"flag": "-b, --sh",
"meaning": "Bourne-shell export LS_COLORS"
},
{
"flag": "-p, --print-database",
"meaning": "Print default database"
}
],
"keywords": ["dircolors", "LS_COLORS", "ls", "color"],
"bareOsNotes": "Subset of GNU dircolors; FILE is read via VFS.",
"examples": [
{ "caption": "default database", "code": "dircolors -p" },
{ "caption": "eval in shell", "code": "eval \"$(dircolors -b ~/.dir_colors)\"" }
]
"keywords": [
"dircolors",
"LS_COLORS",
"color"
],
"bareOsNotes": "FILE read via VFS."
}
packages/bare-os-coreutils/man/pages/dirname.json
+10 -7
View File
@@ -2,12 +2,16 @@
"name": "dirname",
"section": 1,
"title": "return directory portion of a pathname",
"synopsis": ["dirname [OPTION]... [OPERAND]..."],
"description": "Prints the directory portion of each path. -z emits NUL-terminated records (host stdout).",
"options": [
{ "flag": "-z, --zero", "meaning": "Separate outputs with NUL (requires process.stdout.write)" }
"synopsis": [
"dirname [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of return directory portion of a pathname. Full behavior is defined in packages/bare-os-coreutils/src/dirname.js.",
"options": [],
"keywords": [
"dirname",
"bare-os",
"coreutils"
],
"keywords": ["dirname", "bare-os", "coreutils"],
"examples": [
{
"caption": "parent path",
@@ -17,6 +21,5 @@
"caption": "compose with basename",
"code": "p=/x/y/z; echo $(dirname $p)/$(basename $p)"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/du.json
+11 -10
View File
@@ -2,23 +2,24 @@
"name": "du",
"section": 1,
"title": "estimate file space usage",
"synopsis": ["du [OPTION]... [OPERAND]..."],
"description": "Prints disk usage totals per path: POSIX-ish block counts by default, or human-readable byte totals with -h.",
"options": [
{ "flag": "-k", "meaning": "1024-byte blocks" },
{ "flag": "-h, --human-readable", "meaning": "IEC-style sizes (K, M, …) from byte totals" },
{ "flag": "-s, --summarize", "meaning": "One line per operand (default behavior here)" }
"synopsis": [
"du [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of estimate file space usage. Full behavior is defined in packages/bare-os-coreutils/src/du.js.",
"options": [],
"keywords": [
"du",
"bare-os",
"coreutils"
],
"keywords": ["du", "bare-os", "coreutils"],
"examples": [
{
"caption": "sizes under cwd",
"code": "du ."
},
{
"caption": "human-readable",
"caption": "human (if supported)",
"code": "du -h ~"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/echo.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "echo",
"section": 1,
"title": "write arguments to standard output",
"synopsis": ["echo [OPTION]... [OPERAND]..."],
"synopsis": [
"echo [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of write arguments to standard output. Full behavior is defined in packages/bare-os-coreutils/src/echo.js.",
"options": [],
"keywords": ["echo", "bare-os", "coreutils"],
"keywords": [
"echo",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "literal",
packages/bare-os-coreutils/man/pages/edit.json
+9 -13
View File
@@ -1,19 +1,15 @@
{
"name": "edit",
"section": 1,
"title": "terminal file editor with syntax highlighting",
"synopsis": ["edit [file]", "edit -h|--help"],
"description": "Full-screen TUI editor (nano-style) for the Bare OS shell. Uses the session TTY (ctx.replStdin / replStdout), suspends the fish readline layer while active, and reads/writes paths via the VFS. Syntax highlighting is best-effort for JavaScript/TypeScript, JSON, shell, Markdown, and plain text. Files larger than 2,000,000 characters are rejected. The shell alias nano invokes edit.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage and exit."
}
"title": "edit",
"synopsis": [
"edit [OPTION]... [OPERAND]..."
],
"keywords": ["edit", "nano", "editor", "tty", "syntax"],
"bareOsNotes": "Requires an interactive TTY (stdin.isTTY). Uses ctx.suspendReplForSubprocess / resumeReplAfterSubprocess around raw mode.",
"examples": [
{ "caption": "edit a file", "code": "edit README.md" },
{ "caption": "same via alias", "code": "nano foo.js" }
"description": "Bare OS implementation of edit. Full behavior is defined in packages/bare-os-coreutils/src/edit.js.",
"options": [],
"keywords": [
"edit",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/env.json
+17 -8
View File
@@ -2,15 +2,24 @@
"name": "env",
"section": 1,
"title": "set the environment for command invocation",
"synopsis": ["env [OPTION]... [-] [NAME=VALUE]... [COMMAND [ARG]...]"],
"description": "Without **COMMAND**, prints the environment sorted by name. With **`-i`** / **`--ignore-environment`**, the environment for the utility starts empty (plus any **`NAME=value`** assignments before the utility). The utility runs via **`ctx.runBinCommand`**. While the utility runs, **`ctx.vfs.env`** (and **`ctx.env`** when present) are temporarily replaced and restored afterward so the parent session is unchanged.",
"options": [
{ "flag": "-i, --ignore-environment", "meaning": "Start with an empty environment before applying assignments." }
"synopsis": [
"env [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of set the environment for command invocation. Full behavior is defined in packages/bare-os-coreutils/src/env.js.",
"options": [],
"keywords": [
"env",
"bare-os",
"coreutils"
],
"keywords": ["env", "bare-os", "coreutils"],
"examples": [
{ "caption": "print environment", "code": "env" },
{ "caption": "minimal env and run", "code": "env -i PATH=/bin printf '%s' ok" },
{ "caption": "override for one command", "code": "env VAR=value mycmd" }
{
"caption": "print environment",
"code": "env"
},
{
"caption": "run with override",
"code": "env PATH=/bin:/usr/bin man ls"
}
]
}
packages/bare-os-coreutils/man/pages/exit.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "exit",
"section": 1,
"title": "exit the shell or booter session",
"synopsis": ["exit [status]"],
"synopsis": [
"exit [status]"
],
"description": "When run as /bin/exit, requests the booter to end the session via ctx.requestBooterExit. Status defaults to 0.",
"options": [],
"keywords": ["exit", "bare-os", "coreutils"],
"keywords": [
"exit",
"bare-os",
"coreutils"
],
"bareOsNotes": "Also available as a shell builtin with different wiring.",
"examples": [
{
packages/bare-os-coreutils/man/pages/expand.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "expand",
"section": 1,
"title": "convert tabs to spaces",
"title": "expand",
"synopsis": [
"expand [-t N] [FILE]..."
],
"description": "Uniform tab width (default 8).",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"expand [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of expand. Full behavior is defined in packages/bare-os-coreutils/src/expand.js.",
"options": [],
"keywords": [
"expand",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "expand"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/expr.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "expr",
"section": 1,
"title": "evaluate expressions",
"title": "expr",
"synopsis": [
"expr EXPRESSION"
],
"description": "Integer + - * / %, comparisons, string = and !=.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"expr [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of expr. Full behavior is defined in packages/bare-os-coreutils/src/expr.js.",
"options": [],
"keywords": [
"expr",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "expr"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/factor.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "factor",
"section": 1,
"title": "factor numbers",
"title": "factor",
"synopsis": [
"factor [NUMBER]..."
],
"description": "Prime factors by trial division; safe integers only.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"factor [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of factor. Full behavior is defined in packages/bare-os-coreutils/src/factor.js.",
"options": [],
"keywords": [
"factor",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "factor"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/false.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "false",
"section": 1,
"title": "return false value",
"synopsis": ["false [OPTION]... [OPERAND]..."],
"synopsis": [
"false [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of return false value. Full behavior is defined in packages/bare-os-coreutils/src/false.js.",
"options": [],
"keywords": ["false", "bare-os", "coreutils"],
"keywords": [
"false",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "force failure in pipeline tests",
packages/bare-os-coreutils/man/pages/find.json
+13 -32
View File
@@ -2,31 +2,17 @@
"name": "find",
"section": 1,
"title": "find files",
"synopsis": ["find [PATH...] [EXPRESSION]"],
"description": "Walks a directory tree with predicates including -maxdepth, -mindepth, -name, -iname, -path, -regex (full path, JS RegExp), -type, -empty, -mtime, -newer, -prune, -delete (gated by BARE_OS_FIND_DELETE), -exec/-ok … \\; (requires ctx.runBinCommand; BARE_OS_FIND_EXEC_MAX, default 64; -ok needs BARE_OS_FIND_OK=1), and -print0. Not full POSIX find grammar.",
"options": [
{
"flag": "-name / -iname",
"meaning": "Base name glob match (case-sensitive / case-insensitive)"
},
{
"flag": "-regex PAT",
"meaning": "Full path must match JavaScript RegExp PAT"
},
{
"flag": "-exec / -ok",
"meaning": "Run a utility with {} replaced by path; terminate with ;"
},
{
"flag": "-print0",
"meaning": "Separate paths with NUL (requires host stdout)"
},
{
"flag": "-type f|d|l",
"meaning": "Restrict to file, directory, or symlink"
}
"synopsis": [
"find [PATH...] [EXPRESSION]"
],
"description": "Walks directories and applies expressions (-name, -type, -print, -maxdepth, logical -and/-or/-not).",
"options": [],
"keywords": [
"find",
"directory",
"walk",
"search"
],
"keywords": ["find", "directory", "walk", "search"],
"bareOsNotes": "Expression syntax is a simplified subset.",
"examples": [
{
@@ -42,13 +28,8 @@
"code": "find . -maxdepth 2 -type f"
},
{
"caption": "skip top directory level (GNU-like -mindepth 2)",
"code": "find . -mindepth 2 -type f"
},
{
"caption": "case-insensitive name",
"code": "find . -iname \"*.TXT\""
"caption": "OR names",
"code": "find . \\( -name \"*.c\" -o -name \"*.h\" \\)"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/fmt.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "fmt",
"section": 1,
"title": "simple text formatter",
"title": "fmt",
"synopsis": [
"fmt [-w WIDTH] [FILE]..."
],
"description": "Reflow paragraphs (blank-line separated).",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"fmt [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of fmt. Full behavior is defined in packages/bare-os-coreutils/src/fmt.js.",
"options": [],
"keywords": [
"fmt",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "fmt"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/fold.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "fold",
"section": 1,
"title": "wrap each input line",
"title": "fold",
"synopsis": [
"fold [-w WIDTH] [FILE]..."
],
"description": "Fixed-width wrap without word break.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"fold [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of fold. Full behavior is defined in packages/bare-os-coreutils/src/fold.js.",
"options": [],
"keywords": [
"fold",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "fold"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/getconf.json
+6 -13
View File
@@ -2,29 +2,22 @@
"name": "getconf",
"section": 1,
"title": "get configuration values",
"synopsis": ["getconf [-a] system_var"],
"description": "Prints a fixed subset of POSIX-style limit names and values for Bare OS. There is no host sysconf path; constants match the documented JavaScript/VFS environment.",
"synopsis": [
"getconf [OPTION]... [OPERAND]..."
],
"description": "Prints a fixed subset of configuration limits for Bare OS (JavaScript runtime and VFS). There is no host sysconf(3); values are documented constants, not live kernel queries.",
"options": [
{
"flag": "-a",
"meaning": "Write every known variable (each name on one line, value on the next)"
"meaning": "Write all known variables (name then value per pair)"
}
],
"keywords": [
"getconf",
"limits",
"PATH_MAX",
"POSIX",
"bare-os",
"coreutils"
],
"environment": [
"BARE_OS_YES_MAX_LINES — max lines yes prints (host passthrough overrides default)",
"BARE_OS_SHUF_MAX_LINES — max lines shuf holds in memory",
"BARE_OS_SPLIT_MAX_FILES — max output files split may create",
"BARE_OS_FIND_EXEC_MAX — max find -exec/-ok invocations per run (also in table)"
],
"bareOsNotes": "Subset only; unknown names fail with exit status 1. See src/getconf.js for the name table. BARE_OS_NPROC overrides /bin/nproc when passed from the host (see docs/reference/environment-and-posix-appendix.md §14).",
"bareOsNotes": "Unknown variable names exit with status 1. Not a full Issue 7 getconf implementation.",
"examples": [
{
"caption": "path length limit",
packages/bare-os-coreutils/man/pages/git-pear.json
+10 -5
View File
@@ -1,10 +1,15 @@
{
"name": "git-pear",
"section": 1,
"title": "Git-in-Pear hints",
"synopsis": ["git-pear help"],
"description": "Prints short documentation for git+pear remotes (gip-transport / gip-remote). See packages/bare-os-coreutils/src/git-pear.js.",
"title": "git-pear",
"synopsis": [
"git-pear [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of git-pear. Full behavior is defined in packages/bare-os-coreutils/src/git-pear.js.",
"options": [],
"keywords": ["git", "pear", "gip", "bare-os"],
"examples": [{ "caption": "help", "code": "git-pear help" }]
"keywords": [
"git-pear",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/git.json
+3 -1
View File
@@ -2,7 +2,9 @@
"name": "git",
"section": 1,
"title": "Bare OS git front-end (isomorphic-git)",
"synopsis": ["git [-C dir] <subcommand> [ARGUMENTS...]"],
"synopsis": [
"git [-C dir] <subcommand> [ARGUMENTS...]"
],
"description": "Runs isomorphic-git against the VFS-backed adapter. Remote HTTP(S) uses BARE_OS_GIT_HTTP when set; otherwise Pear bare module fetch.",
"options": [
{
packages/bare-os-coreutils/man/pages/grep.json
+9 -20
View File
@@ -3,7 +3,7 @@
"section": 1,
"title": "pattern matching utility",
"synopsis": [
"grep [-E|-F] [-i] [-v] [-w] [-n] [-c] [-l] [-q] [-s] [-H|-h] [-e pat] ... [-f file] ... [pattern] [file...]"
"grep [-E|-F] [-i] [-v] [-n] [-c] [-l] [-q] [-s] [-H|-h] [-e pat] ... [-f file] ... [pattern] [file...]"
],
"description": "Searches input or files for lines matching a pattern. Uses JavaScript RegExp unless -F (fixed string). Not bit-identical to GNU grep.",
"options": [
@@ -15,10 +15,6 @@
"flag": "-F",
"meaning": "Fixed string match"
},
{
"flag": "-r, --recursive",
"meaning": "Recurse into directories (skips **`.git`**; max depth 64); with no file args, searches **`.`**"
},
{
"flag": "-i",
"meaning": "Ignore case"
@@ -27,10 +23,6 @@
"flag": "-v",
"meaning": "Invert match"
},
{
"flag": "-w",
"meaning": "Match whole words (regex: \\b…\\b; fixed: non-alphanumeric boundaries)"
},
{
"flag": "-n",
"meaning": "Prefix lines with line number"
@@ -62,17 +54,15 @@
{
"flag": "-f file",
"meaning": "Read patterns from file"
},
{
"flag": "-A / -B / -C N",
"meaning": "Print after / before / both context lines around matches"
},
{
"flag": "--color=never|always|auto",
"meaning": "Highlight matches (default never; auto uses TTY and respects NO_COLOR)"
}
],
"keywords": ["grep", "search", "regex", "pattern", "filter"],
"keywords": [
"grep",
"search",
"regex",
"pattern",
"filter"
],
"seeAlso": [
{
"name": "sed",
@@ -113,6 +103,5 @@
"caption": "multiple patterns",
"code": "grep -e foo -e bar file.txt"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/groups.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "groups",
"section": 1,
"title": "print group names",
"title": "groups",
"synopsis": [
"groups [USER]"
],
"description": "Prints supplemental groups from env or primary GROUP.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"groups [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of groups. Full behavior is defined in packages/bare-os-coreutils/src/groups.js.",
"options": [],
"keywords": [
"groups",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "groups"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/hdms.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "hdms",
"section": 1,
"title": "Hyperswarm distributed map store",
"synopsis": ["hdms [OPTION]... [OPERAND]..."],
"synopsis": [
"hdms [OPTION]... [OPERAND]..."
],
"description": "Invokes ctx.runHdms when the booter provides HDMS integration; otherwise prints unavailable.",
"options": [],
"keywords": ["hdms", "hyperswarm", "map"],
"keywords": [
"hdms",
"hyperswarm",
"map"
],
"bareOsNotes": "Optional booter capability.",
"examples": [
{
packages/bare-os-coreutils/man/pages/head.json
+11 -15
View File
@@ -2,32 +2,28 @@
"name": "head",
"section": 1,
"title": "copy the first part of files",
"synopsis": ["head [OPTION]... [OPERAND]..."],
"description": "Prints the first part of each file. Supports -n for line count and -c for a byte count (UTF-8 byte-oriented).",
"options": [
{ "flag": "-n, --lines=NUM", "meaning": "Print the first NUM lines (default 10)" },
{ "flag": "-c, --bytes=NUM", "meaning": "Print the first NUM bytes" },
{ "flag": "-NUM", "meaning": "Shorthand for -n NUM (e.g. head -5 file)" }
"synopsis": [
"head [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of copy the first part of files. Full behavior is defined in packages/bare-os-coreutils/src/head.js.",
"options": [],
"keywords": [
"head",
"bare-os",
"coreutils"
],
"keywords": ["head", "bare-os", "coreutils"],
"seeAlso": [{ "name": "tail", "section": 1 }],
"examples": [
{
"caption": "first 10 lines",
"code": "head /etc/os-release"
},
{
"caption": "first N lines",
"caption": "first N",
"code": "head -n 50 big.log"
},
{
"caption": "first bytes",
"code": "head -c 80 data.bin"
},
{
"caption": "stdin",
"code": "cat long.txt | head"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/help.json
+9 -2
View File
@@ -2,10 +2,17 @@
"name": "help",
"section": 1,
"title": "Bare OS help summary",
"synopsis": ["help"],
"synopsis": [
"help"
],
"description": "Prints a one-screen summary of shell builtins and /bin command names. Use man for long-form documentation.",
"options": [],
"keywords": ["help", "summary", "builtins", "commands"],
"keywords": [
"help",
"summary",
"builtins",
"commands"
],
"seeAlso": [
{
"name": "man",
packages/bare-os-coreutils/man/pages/hostid.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "hostid",
"section": 1,
"title": "print numeric host identifier",
"title": "hostid",
"synopsis": [
"hostid"
],
"description": "Eight hex digits from HOSTID env or session hash.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"hostid [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of hostid. Full behavior is defined in packages/bare-os-coreutils/src/hostid.js.",
"options": [],
"keywords": [
"hostid",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "hostid"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/hostname.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "hostname",
"section": 1,
"title": "set or print hostname",
"synopsis": ["hostname [OPTION]... [OPERAND]..."],
"synopsis": [
"hostname [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of set or print hostname. Full behavior is defined in packages/bare-os-coreutils/src/hostname.js.",
"options": [],
"keywords": ["hostname", "bare-os", "coreutils"],
"keywords": [
"hostname",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "show host",
packages/bare-os-coreutils/man/pages/id.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "id",
"section": 1,
"title": "return user identity",
"synopsis": ["id [OPTION]... [OPERAND]..."],
"synopsis": [
"id [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of return user identity. Full behavior is defined in packages/bare-os-coreutils/src/id.js.",
"options": [],
"keywords": ["id", "bare-os", "coreutils"],
"keywords": [
"id",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "who am I numerically",
packages/bare-os-coreutils/man/pages/install.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "install",
"section": 1,
"title": "copy files and set attributes",
"title": "install",
"synopsis": [
"install [-m MODE] SOURCE DEST"
],
"description": "Copy one file; optional chmod.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"install [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of install. Full behavior is defined in packages/bare-os-coreutils/src/install.js.",
"options": [],
"keywords": [
"install",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "install"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/join.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "join",
"section": 1,
"title": "join lines of two files on a common field",
"title": "join",
"synopsis": [
"join [-t CHAR] [-1 N] [-2 N] FILE1 FILE2"
],
"description": "Relational join on sorted files.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"join [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of join. Full behavior is defined in packages/bare-os-coreutils/src/join.js.",
"options": [],
"keywords": [
"join",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "join"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/jq.json
+7 -1
View File
@@ -37,7 +37,13 @@
"meaning": "Read filter program from file"
}
],
"keywords": ["jq", "json", "query", "filter", "jqjs"],
"keywords": [
"jq",
"json",
"query",
"filter",
"jqjs"
],
"seeAlso": [
{
"name": "grep",
packages/bare-os-coreutils/man/pages/ln.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "ln",
"section": 1,
"title": "link files",
"synopsis": ["ln [OPTION]... [OPERAND]..."],
"synopsis": [
"ln [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of link files. Full behavior is defined in packages/bare-os-coreutils/src/ln.js.",
"options": [],
"keywords": ["ln", "bare-os", "coreutils"],
"keywords": [
"ln",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "symlink",
packages/bare-os-coreutils/man/pages/login.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "login",
"section": 1,
"title": "begin a session on the system",
"synopsis": ["login [OPTION]... [OPERAND]..."],
"synopsis": [
"login [OPTION]... [OPERAND]..."
],
"description": "When invoked from /bin, behavior aligns with session identity hooks (see booter). Prefer the shell builtin for passphrase entry.",
"options": [],
"keywords": ["login", "identity", "passphrase"],
"keywords": [
"login",
"identity",
"passphrase"
],
"seeAlso": [
{
"name": "logout",
packages/bare-os-coreutils/man/pages/logname.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "logname",
"section": 1,
"title": "return the user's login name",
"synopsis": ["logname [OPTION]... [OPERAND]..."],
"synopsis": [
"logname [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of return the user's login name. Full behavior is defined in packages/bare-os-coreutils/src/logname.js.",
"options": [],
"keywords": ["logname", "bare-os", "coreutils"],
"keywords": [
"logname",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "login name",
packages/bare-os-coreutils/man/pages/logout.json
+7 -2
View File
@@ -2,10 +2,15 @@
"name": "logout",
"section": 1,
"title": "end session (save vault)",
"synopsis": ["logout [OPTION]... [OPERAND]..."],
"synopsis": [
"logout [OPTION]... [OPERAND]..."
],
"description": "Ends session; may persist vault depending on booter and flags.",
"options": [],
"keywords": ["logout", "session"],
"keywords": [
"logout",
"session"
],
"seeAlso": [
{
"name": "login",
packages/bare-os-coreutils/man/pages/ls.json
+12 -5
View File
@@ -2,8 +2,10 @@
"name": "ls",
"section": 1,
"title": "list directory contents",
"synopsis": ["ls [-1al] [--color[=never|auto|always]] [--format=single-column] [FILE...]"],
"description": "Lists directory contents. Long format shows mode, links, owner, group, size, mtime, and symlink targets. With color (default auto on a TTY), directories, symlinks, executables, and permission bits are highlighted. When stdout is captured by the shell (pipeline or **>** redirect), short format lists **one name per line** (GNU-like), so tools such as **grep** and **sort** see one entry per line.",
"synopsis": [
"ls [-1al] [--color[=never|auto|always]] [FILE...]"
],
"description": "Lists directory contents. Long format shows mode, links, owner, group, size, mtime, and symlink targets. With color (default auto on a TTY), directories, symlinks, executables, and permission bits are highlighted.",
"options": [
{
"flag": "-a",
@@ -14,18 +16,23 @@
"meaning": "Long listing"
},
{
"flag": "-1, --format=single-column, --format=vertical",
"meaning": "One name per line (short format); same layout when stdout is piped or redirected"
"flag": "-1",
"meaning": "One name per line (short format)"
},
{
"flag": "--color[=never|auto|always]",
"meaning": "ANSI colors: never, auto (TTY only), or always; plain --color is auto"
}
],
"keywords": [
"ls",
"list",
"directory",
"dir"
],
"environment": [
"NO_COLOR — disable color even when a TTY or --color=always"
],
"keywords": ["ls", "list", "directory", "dir"],
"bareOsNotes": "Hides .bareos_empty marker like other tools.",
"examples": [
{
packages/bare-os-coreutils/man/pages/man.json
+2 -7
View File
@@ -3,7 +3,7 @@
"section": 1,
"title": "display on-line manual pages",
"synopsis": [
"man [-k keyword] [-f name] [-l] [-w] [[section] name]",
"man [-k keyword] [-f name] [-l] [[section] name]",
"man reads /share/man/man.json on the system drive."
],
"description": "Displays manual pages from the merged JSON database. Section 1: /bin and git/shell pages. Section 7: handbook (man handbook) and developer guide (man devguide), merged at build from handbook/*.md and developer-guide/*.md.",
@@ -19,10 +19,6 @@
{
"flag": "-l, --list",
"meaning": "List pages grouped by category (/bin, git/shell, handbook, developer guide), then alphabetically"
},
{
"flag": "-w, --where, --path",
"meaning": "Print logical path to the manual database (/share/man/man.json)"
}
],
"keywords": [
@@ -37,8 +33,7 @@
],
"environment": [
"MANWIDTH — wrap width (default 72, min 40)",
"NO_COLOR — disable bold headings on TTY",
"PAGER=bare-slice — insert section breaks in long pages (optional MAN_SLICE lines per chunk, default 24)"
"NO_COLOR — disable bold headings on TTY"
],
"seeAlso": [
{
packages/bare-os-coreutils/man/pages/md5sum.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "md5sum",
"section": 1,
"title": "compute MD5 checksums",
"title": "md5sum",
"synopsis": [
"md5sum [FILE]..."
],
"description": "Bundled MD5 (not Web Crypto); GNU-style output lines.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"md5sum [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of md5sum. Full behavior is defined in packages/bare-os-coreutils/src/md5sum.js.",
"options": [],
"keywords": [
"md5sum",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "md5sum"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/mkdir.json
+17 -9
View File
@@ -2,16 +2,24 @@
"name": "mkdir",
"section": 1,
"title": "make directories",
"synopsis": ["mkdir [OPTION]... DIRECTORY..."],
"description": "Creates directories using the VFS marker convention. **`-m MODE`** sets permission bits (octal) on **`.bareos_empty`**; **`lstat`** on the directory reports **`S_IFDIR`** with those bits (execute bits are implied for user/group/other when the corresponding read bit is set, so traversal still works).",
"options": [
{ "flag": "-p, --parents", "meaning": "Create parent directories as needed." },
{ "flag": "-m MODE", "meaning": "Directory mode (octal, e.g. **755** or **0755**)." }
"synopsis": [
"mkdir [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of make directories. Full behavior is defined in packages/bare-os-coreutils/src/mkdir.js.",
"options": [],
"keywords": [
"mkdir",
"bare-os",
"coreutils"
],
"keywords": ["mkdir", "bare-os", "coreutils"],
"examples": [
{ "caption": "one dir", "code": "mkdir proj" },
{ "caption": "parents", "code": "mkdir -p a/b/c" },
{ "caption": "mode", "code": "mkdir -m 700 private" }
{
"caption": "one dir",
"code": "mkdir proj"
},
{
"caption": "parents",
"code": "mkdir -p a/b/c"
}
]
}
packages/bare-os-coreutils/man/pages/mkfifo.json
+8 -3
View File
@@ -2,11 +2,16 @@
"name": "mkfifo",
"section": 1,
"title": "make FIFO special files",
"synopsis": ["mkfifo [OPTION]... [OPERAND]..."],
"synopsis": [
"mkfifo [OPTION]... [OPERAND]..."
],
"description": "FIFO special files are not implemented on Hyperdrive. The command reports failure.",
"options": [],
"keywords": ["mkfifo", "bare-os", "coreutils", "stub"],
"stub": true,
"keywords": [
"mkfifo",
"bare-os",
"coreutils"
],
"bareOsNotes": "Documented stub; no real pipes as kernel objects.",
"examples": [
{
packages/bare-os-coreutils/man/pages/mktemp.json
+10 -8
View File
@@ -1,13 +1,15 @@
{
"name": "mktemp",
"section": 1,
"title": "create a temporary file or directory",
"synopsis": ["mktemp [OPTION] [TEMPLATE]"],
"description": "Creates a file or directory under /tmp (or absolute TEMPLATE). Replaces XXXXXX with random characters. See packages/bare-os-coreutils/src/mktemp.js.",
"options": [{ "flag": "-d", "meaning": "create a directory" }],
"keywords": ["mktemp", "bare-os", "coreutils"],
"examples": [
{ "caption": "file", "code": "mktemp tmp.XXXXXX" },
{ "caption": "dir", "code": "mktemp -d dir.XXXXXX" }
"title": "mktemp",
"synopsis": [
"mktemp [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of mktemp. Full behavior is defined in packages/bare-os-coreutils/src/mktemp.js.",
"options": [],
"keywords": [
"mktemp",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/mv.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "mv",
"section": 1,
"title": "move or rename files",
"synopsis": ["mv [OPTION]... [OPERAND]..."],
"synopsis": [
"mv [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of move or rename files. Full behavior is defined in packages/bare-os-coreutils/src/mv.js.",
"options": [],
"keywords": ["mv", "bare-os", "coreutils"],
"keywords": [
"mv",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "rename",
packages/bare-os-coreutils/man/pages/nano.json
+10 -6
View File
@@ -1,11 +1,15 @@
{
"name": "nano",
"section": 1,
"title": "alias for edit — terminal file editor",
"synopsis": ["nano [file]"],
"description": "The /bin/nano script is identical to edit. In the default shell, the name nano is also an alias for edit. See edit(1) for behavior, key bindings, and requirements.",
"title": "nano",
"synopsis": [
"nano [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of nano. Full behavior is defined in packages/bare-os-coreutils/src/nano.js.",
"options": [],
"keywords": ["nano", "edit", "editor"],
"bareOsNotes": "Same implementation as edit; see man edit.",
"examples": [{ "caption": "open a file", "code": "nano ~/.barerc" }]
"keywords": [
"nano",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/nl.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "nl",
"section": 1,
"title": "line numbering utility",
"synopsis": ["nl [OPTION]... [OPERAND]..."],
"synopsis": [
"nl [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of line numbering utility. Full behavior is defined in packages/bare-os-coreutils/src/nl.js.",
"options": [],
"keywords": ["nl", "bare-os", "coreutils"],
"keywords": [
"nl",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "number all lines",
packages/bare-os-coreutils/man/pages/nproc.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "nproc",
"section": 1,
"title": "print number of processing units",
"title": "nproc",
"synopsis": [
"nproc [--all]"
],
"description": "Counts processor lines in /proc/cpuinfo or BARE_OS_NPROC.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"nproc [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of nproc. Full behavior is defined in packages/bare-os-coreutils/src/nproc.js.",
"options": [],
"keywords": [
"nproc",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "nproc"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/numfmt.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "numfmt",
"section": 1,
"title": "convert numbers",
"title": "numfmt",
"synopsis": [
"numfmt [--to=iec|--to=si] [NUMBER]..."
],
"description": "Human-readable IEC (1024) or SI (1000) scales.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"numfmt [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of numfmt. Full behavior is defined in packages/bare-os-coreutils/src/numfmt.js.",
"options": [],
"keywords": [
"numfmt",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "numfmt"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/od.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "od",
"section": 1,
"title": "octal dump",
"synopsis": ["od [OPTION]... [OPERAND]..."],
"synopsis": [
"od [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of octal dump. Full behavior is defined in packages/bare-os-coreutils/src/od.js.",
"options": [],
"keywords": ["od", "bare-os", "coreutils"],
"keywords": [
"od",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "hex dump vibe",
packages/bare-os-coreutils/man/pages/oidc-publish.json
+9 -6
View File
@@ -1,12 +1,15 @@
{
"name": "oidc-publish",
"section": 1,
"title": "OIDC client-credentials helper",
"synopsis": ["oidc-publish help", "oidc-publish"],
"description": "POSTs client_credentials to ${OIDC_ISSUER}/oauth/token when ctx.httpFetch exists and HTTP policy allows. See packages/bare-os-coreutils/src/oidc-publish.js.",
"title": "oidc-publish",
"synopsis": [
"oidc-publish [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of oidc-publish. Full behavior is defined in packages/bare-os-coreutils/src/oidc-publish.js.",
"options": [],
"keywords": ["oidc", "pear", "http", "bare-os"],
"examples": [
{ "caption": "help", "code": "oidc-publish help" }
"keywords": [
"oidc-publish",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/paste.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "paste",
"section": 1,
"title": "merge lines of files",
"title": "paste",
"synopsis": [
"paste [-d LIST] [-s] [FILE]..."
],
"description": "Parallel or serial (-s) column merge.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"paste [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of paste. Full behavior is defined in packages/bare-os-coreutils/src/paste.js.",
"options": [],
"keywords": [
"paste",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "paste"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/pathchk.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "pathchk",
"section": 1,
"title": "check pathname portability",
"synopsis": ["pathchk [OPTION]... [OPERAND]..."],
"synopsis": [
"pathchk [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of check pathname portability. Full behavior is defined in packages/bare-os-coreutils/src/pathchk.js.",
"options": [],
"keywords": ["pathchk", "bare-os", "coreutils"],
"keywords": [
"pathchk",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "portable path check",
packages/bare-os-coreutils/man/pages/pr.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "pr",
"section": 1,
"title": "paginate or columnate",
"title": "pr",
"synopsis": [
"pr [-w WIDTH] [-n] [FILE]..."
],
"description": "Minimal column print and optional line numbers.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"pr [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of pr. Full behavior is defined in packages/bare-os-coreutils/src/pr.js.",
"options": [],
"keywords": [
"pr",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "pr"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/printenv.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "printenv",
"section": 1,
"title": "print environment variables",
"synopsis": ["printenv [OPTION]... [OPERAND]..."],
"synopsis": [
"printenv [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of print environment variables. Full behavior is defined in packages/bare-os-coreutils/src/printenv.js.",
"options": [],
"keywords": ["printenv", "bare-os", "coreutils"],
"keywords": [
"printenv",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "one variable",
packages/bare-os-coreutils/man/pages/printf.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "printf",
"section": 1,
"title": "format and print",
"synopsis": ["printf [OPTION]... [OPERAND]..."],
"synopsis": [
"printf [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of format and print. Full behavior is defined in packages/bare-os-coreutils/src/printf.js.",
"options": [],
"keywords": ["printf", "bare-os", "coreutils"],
"keywords": [
"printf",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "format",
packages/bare-os-coreutils/man/pages/pwd.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "pwd",
"section": 1,
"title": "return working directory name",
"synopsis": ["pwd [OPTION]... [OPERAND]..."],
"synopsis": [
"pwd [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of return working directory name. Full behavior is defined in packages/bare-os-coreutils/src/pwd.js.",
"options": [],
"keywords": ["pwd", "bare-os", "coreutils"],
"keywords": [
"pwd",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "where am I",
packages/bare-os-coreutils/man/pages/readlink.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "readlink",
"section": 1,
"title": "print symbolic link targets",
"synopsis": ["readlink [OPTION]... [OPERAND]..."],
"synopsis": [
"readlink [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of print symbolic link targets. Full behavior is defined in packages/bare-os-coreutils/src/readlink.js.",
"options": [],
"keywords": ["readlink", "bare-os", "coreutils"],
"keywords": [
"readlink",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "symlink target",
packages/bare-os-coreutils/man/pages/realpath.json
+10 -14
View File
@@ -1,19 +1,15 @@
{
"name": "realpath",
"section": 1,
"title": "print resolved logical path",
"synopsis": ["realpath [-m] FILE..."],
"description": "Prints the VFS-resolved absolute path (same as the shell’s logical resolution). Does not traverse the host filesystem.",
"options": [
{
"flag": "-m, --canonicalize-missing",
"meaning": "Do not require the path to exist"
},
{ "flag": "-h, --help", "meaning": "Print usage" }
"title": "realpath",
"synopsis": [
"realpath [OPTION]... [OPERAND]..."
],
"keywords": ["realpath", "bare-os", "coreutils"],
"examples": [
{ "caption": "resolve under $HOME", "code": "realpath ./notes.txt" }
],
"listCategory": "coreutils"
"description": "Bare OS implementation of realpath. Full behavior is defined in packages/bare-os-coreutils/src/realpath.js.",
"options": [],
"keywords": [
"realpath",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/rev.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "rev",
"section": 1,
"title": "reverse lines characterwise",
"title": "rev",
"synopsis": [
"rev [FILE]..."
],
"description": "Reverses each line's characters.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"rev [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of rev. Full behavior is defined in packages/bare-os-coreutils/src/rev.js.",
"options": [],
"keywords": [
"rev",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "rev"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/rm.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "rm",
"section": 1,
"title": "remove files",
"synopsis": ["rm [OPTION]... [OPERAND]..."],
"synopsis": [
"rm [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of remove files. Full behavior is defined in packages/bare-os-coreutils/src/rm.js.",
"options": [],
"keywords": ["rm", "bare-os", "coreutils"],
"keywords": [
"rm",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "file",
packages/bare-os-coreutils/man/pages/rmdir.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "rmdir",
"section": 1,
"title": "remove empty directories",
"synopsis": ["rmdir [OPTION]... [OPERAND]..."],
"synopsis": [
"rmdir [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of remove empty directories. Full behavior is defined in packages/bare-os-coreutils/src/rmdir.js.",
"options": [],
"keywords": ["rmdir", "bare-os", "coreutils"],
"keywords": [
"rmdir",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "empty dir",
packages/bare-os-coreutils/man/pages/savevault.json
+9 -2
View File
@@ -2,10 +2,17 @@
"name": "savevault",
"section": 1,
"title": "encrypt snapshot of personal drive",
"synopsis": ["savevault [OPTION]... [OPERAND]..."],
"synopsis": [
"savevault [OPTION]... [OPERAND]..."
],
"description": "Encrypts a copy of the personal drive under /.bare/vault/ when identity services are available.",
"options": [],
"keywords": ["savevault", "vault", "encrypt", "backup"],
"keywords": [
"savevault",
"vault",
"encrypt",
"backup"
],
"seeAlso": [
{
"name": "login",
packages/bare-os-coreutils/man/pages/sed.json
+9 -2
View File
@@ -2,10 +2,17 @@
"name": "sed",
"section": 1,
"title": "stream editor",
"synopsis": ["sed [OPTION]... [OPERAND]..."],
"synopsis": [
"sed [OPTION]... [OPERAND]..."
],
"description": "Stream editor with a subset of POSIX sed. Large engine is vendored in lib/sed-engine.js.",
"options": [],
"keywords": ["sed", "stream", "edit", "substitute"],
"keywords": [
"sed",
"stream",
"edit",
"substitute"
],
"seeAlso": [
{
"name": "awk",
packages/bare-os-coreutils/man/pages/seq.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "seq",
"section": 1,
"title": "print sequences of numbers",
"synopsis": ["seq [OPTION]... [OPERAND]..."],
"synopsis": [
"seq [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of print sequences of numbers. Full behavior is defined in packages/bare-os-coreutils/src/seq.js.",
"options": [],
"keywords": ["seq", "bare-os", "coreutils"],
"keywords": [
"seq",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "1..10",
packages/bare-os-coreutils/man/pages/sha1sum.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "sha1sum",
"section": 1,
"title": "compute SHA-1 checksums",
"title": "sha1sum",
"synopsis": [
"sha1sum [FILE]..."
],
"description": "Uses Web Crypto SHA-1 when available.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"sha1sum [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of sha1sum. Full behavior is defined in packages/bare-os-coreutils/src/sha1sum.js.",
"options": [],
"keywords": [
"sha1sum",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "sha1sum"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/sha256sum.json
+10 -9
View File
@@ -1,14 +1,15 @@
{
"name": "sha256sum",
"section": 1,
"title": "compute SHA-256 checksums",
"synopsis": ["sha256sum [FILE]..."],
"description": "Prints SHA-256 hex digests in GNU-style lines (hash, two spaces, name). Uses Web Crypto globalThis.crypto.subtle when available. Reads stdin when no operands or when FILE is -.",
"options": [{ "flag": "-h, --help", "meaning": "Print usage" }],
"keywords": ["sha256sum", "checksum", "bare-os", "coreutils"],
"examples": [
{ "caption": "checksum files", "code": "sha256sum *.js" },
{ "caption": "stdin", "code": "cat f | sha256sum" }
"title": "sha256sum",
"synopsis": [
"sha256sum [OPTION]... [OPERAND]..."
],
"listCategory": "coreutils"
"description": "Bare OS implementation of sha256sum. Full behavior is defined in packages/bare-os-coreutils/src/sha256sum.js.",
"options": [],
"keywords": [
"sha256sum",
"bare-os",
"coreutils"
]
}
packages/bare-os-coreutils/man/pages/sha512sum.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "sha512sum",
"section": 1,
"title": "compute SHA-512 checksums",
"title": "sha512sum",
"synopsis": [
"sha512sum [FILE]..."
],
"description": "Uses Web Crypto SHA-512 when available.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"sha512sum [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of sha512sum. Full behavior is defined in packages/bare-os-coreutils/src/sha512sum.js.",
"options": [],
"keywords": [
"sha512sum",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "sha512sum"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/shuf.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "shuf",
"section": 1,
"title": "shuffle lines",
"title": "shuf",
"synopsis": [
"shuf [FILE]..."
],
"description": "Shuffles in memory; capped by BARE_OS_SHUF_MAX_LINES.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"shuf [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of shuf. Full behavior is defined in packages/bare-os-coreutils/src/shuf.js.",
"options": [],
"keywords": [
"shuf",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "shuf"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/sleep.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "sleep",
"section": 1,
"title": "suspend execution for an interval",
"synopsis": ["sleep [OPTION]... [OPERAND]..."],
"synopsis": [
"sleep [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of suspend execution for an interval. Full behavior is defined in packages/bare-os-coreutils/src/sleep.js.",
"options": [],
"keywords": ["sleep", "bare-os", "coreutils"],
"keywords": [
"sleep",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "pause seconds",
packages/bare-os-coreutils/man/pages/sort.json
+10 -25
View File
@@ -2,22 +2,16 @@
"name": "sort",
"section": 1,
"title": "sort lines",
"synopsis": ["sort [OPTION]... [FILE]..."],
"description": "Sorts lines from files or stdin. Collation follows JavaScript string ordering (and numeric keys when **`-n`**). Stable ordering is only guaranteed when **`-s`** is set.",
"options": [
{ "flag": "-c, --check", "meaning": "Check whether input is already sorted; exit **1** if not; print a **disorder** diagnostic to stderr (GNU-style)" },
{ "flag": "-C, --check=quiet, --check=silent", "meaning": "Like **`-c`** but no stderr message on failure" },
{ "flag": "-o, --output FILE", "meaning": "Write result to **FILE** instead of stdout (place **`-o`** before file operands)" },
{ "flag": "-s, --stable", "meaning": "Stable sort (preserve original order when keys compare equal)" },
{ "flag": "-n, --numeric-sort, -g", "meaning": "Sort by leading numeric prefix" },
{ "flag": "-r, --reverse", "meaning": "Reverse sort order" },
{ "flag": "-u, --unique", "meaning": "Suppress duplicate lines after sorting; with **`-c`**, require strictly increasing keys (no adjacent duplicates)" },
{ "flag": "-f, --ignore-case", "meaning": "Fold case for ordering" },
{ "flag": "-t, --field-separator SEP", "meaning": "Field delimiter for **`-k`** (use **\\t** for tab)" },
{ "flag": "-k, --key POS", "meaning": "Sort by 1-based field **POS** or **START,END** (blank-separated fields when **`-t`** omitted)" },
{ "flag": "-", "meaning": "Operand reads stdin" }
"synopsis": [
"sort [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of sort lines. Full behavior is defined in packages/bare-os-coreutils/src/sort.js.",
"options": [],
"keywords": [
"sort",
"bare-os",
"coreutils"
],
"keywords": ["sort", "bare-os", "coreutils"],
"examples": [
{
"caption": "lexicographic",
@@ -30,15 +24,6 @@
{
"caption": "unique",
"code": "sort -u tags.txt"
},
{
"caption": "verify sorted",
"code": "sort -c sorted.txt"
},
{
"caption": "write to file",
"code": "sort -o out.txt -n nums.txt"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/split.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "split",
"section": 1,
"title": "split a file into pieces",
"title": "split",
"synopsis": [
"split [-l N] [-b N] [INPUT [PREFIX]]"
],
"description": "Line or byte chunks; output count capped.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"split [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of split. Full behavior is defined in packages/bare-os-coreutils/src/split.js.",
"options": [],
"keywords": [
"split",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "split"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/stat.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "stat",
"section": 1,
"title": "display file status",
"synopsis": ["stat [OPTION]... [OPERAND]..."],
"synopsis": [
"stat [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of display file status. Full behavior is defined in packages/bare-os-coreutils/src/stat.js.",
"options": [],
"keywords": ["stat", "bare-os", "coreutils"],
"keywords": [
"stat",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "metadata",
packages/bare-os-coreutils/man/pages/sum.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "sum",
"section": 1,
"title": "checksum and count blocks",
"title": "sum",
"synopsis": [
"sum [-r] [FILE]..."
],
"description": "SysV default or BSD (-r) 16-bit checksum.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"sum [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of sum. Full behavior is defined in packages/bare-os-coreutils/src/sum.js.",
"options": [],
"keywords": [
"sum",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "sum"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/sync.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "sync",
"section": 1,
"title": "flush file system buffers",
"title": "sync",
"synopsis": [
"sync"
],
"description": "No-op success on Bare OS.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"sync [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of sync. Full behavior is defined in packages/bare-os-coreutils/src/sync.js.",
"options": [],
"keywords": [
"sync",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "sync"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/systemctl.json
+3 -1
View File
@@ -19,7 +19,9 @@
"meaning": "Tail N lines from the unit log (status, logs, journalctl)"
}
],
"aliases": ["bare-initctl"],
"aliases": [
"bare-initctl"
],
"keywords": [
"bare-initd",
"initctl",
packages/bare-os-coreutils/man/pages/tac.json
+5 -17
View File
@@ -1,27 +1,15 @@
{
"name": "tac",
"section": 1,
"title": "concatenate and print lines in reverse",
"title": "tac",
"synopsis": [
"tac [FILE]..."
],
"description": "Last line first; per-file order.",
"options": [
{
"flag": "-h, --help",
"meaning": "Print usage"
}
"tac [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of tac. Full behavior is defined in packages/bare-os-coreutils/src/tac.js.",
"options": [],
"keywords": [
"tac",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "basic",
"code": "tac"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/tail.json
+11 -27
View File
@@ -2,40 +2,24 @@
"name": "tail",
"section": 1,
"title": "copy the last part of a file",
"synopsis": ["tail [OPTION]... [OPERAND]..."],
"description": "Prints the last part of each file. Supports -n (line count, including +N to start at line N), -c (bytes, including +K to start at byte K), and -f/--follow for Hyperdrive-backed files. Follow mode uses vfs.watch when available (see BARE_OS_VFS_WATCH) and otherwise polls (BARE_OS_TAIL_F_POLL_MS, default 1000). For automated tests, BARE_OS_TAIL_F_MAX_ROUNDS limits poll iterations (unset = unlimited). Stdin follow is not supported (shell stdin is a captured string). Following multiple files at once is not supported.",
"options": [
{
"flag": "-n, --lines=[+]NUM",
"meaning": "Last NUM lines, or from line NUM onward if +NUM"
},
{
"flag": "-c, --bytes=[+]NUM",
"meaning": "Last NUM bytes, or from byte NUM onward if +NUM"
},
{ "flag": "-f, --follow", "meaning": "Print appended data as the file grows (one file only)" },
{ "flag": "-F", "meaning": "Same as -f (retry-on-truncate not distinct on Bare OS)" }
"synopsis": [
"tail [OPTION]... [OPERAND]..."
],
"environment": [
"BARE_OS_TAIL_F_POLL_MS — milliseconds between polls when watch is unavailable or capped",
"BARE_OS_TAIL_F_MAX_ROUNDS — max poll cycles after initial output (empty = unlimited)",
"BARE_OS_VFS_WATCH=0 — disable Hyperdrive watch; tail -f uses polling only"
"description": "Bare OS implementation of copy the last part of a file. Full behavior is defined in packages/bare-os-coreutils/src/tail.js.",
"options": [],
"keywords": [
"tail",
"bare-os",
"coreutils"
],
"keywords": ["tail", "follow", "log", "bare-os", "coreutils"],
"seeAlso": [{ "name": "head", "section": 1 }],
"examples": [
{
"caption": "last lines",
"code": "tail -n 20 app.log"
},
{
"caption": "follow a log",
"code": "tail -f /var/log/app.log"
},
{
"caption": "last bytes",
"code": "tail -c 512 image.bin"
"caption": "follow vibe (Bare: poll manually)",
"code": "tail error.log"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/tee.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "tee",
"section": 1,
"title": "duplicate standard input",
"synopsis": ["tee [OPTION]... [OPERAND]..."],
"synopsis": [
"tee [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of duplicate standard input. Full behavior is defined in packages/bare-os-coreutils/src/tee.js.",
"options": [],
"keywords": ["tee", "bare-os", "coreutils"],
"keywords": [
"tee",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "copy stdout to file",
packages/bare-os-coreutils/man/pages/test.json
+10 -10
View File
@@ -2,15 +2,16 @@
"name": "test",
"section": 1,
"title": "evaluate a condition",
"synopsis": ["test [OPTION]... [OPERAND]..."],
"description": "Evaluates file tests, string equality, and signed integer comparisons. Subset of POSIX test(1).",
"options": [
{ "flag": "-eq -ne -lt -le -gt -ge", "meaning": "Integer comparisons (decimal)" },
{ "flag": "-f -d -e -a", "meaning": "File type / existence (stat)" },
{ "flag": "-h -L", "meaning": "Symlink (lstat)" },
{ "flag": "-z -n", "meaning": "String empty / non-empty" }
"synopsis": [
"test [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of evaluate a condition. Full behavior is defined in packages/bare-os-coreutils/src/test.js.",
"options": [],
"keywords": [
"test",
"bare-os",
"coreutils"
],
"keywords": ["test", "bare-os", "coreutils"],
"examples": [
{
"caption": "file exists",
@@ -24,6 +25,5 @@
"caption": "string equal",
"code": "test \"$USER\" = guest"
}
],
"listCategory": "coreutils"
]
}
packages/bare-os-coreutils/man/pages/theme.json
+11 -10
View File
@@ -1,15 +1,16 @@
{
"name": "theme",
"section": 1,
"title": "switch Bare OS color theme",
"synopsis": ["theme [list|current|set <name>|apply]"],
"description": "Lists bundled theme presets, shows the active BARE_OS_THEME, writes theme <name> to ~/.barerc and reapplies colors (when the booter provides bareOsApplyTheme), or reapplies the current theme without editing the file.",
"title": "theme",
"synopsis": [
"theme [list|current|set <name>|apply]"
],
"description": "Switch Bare OS UI preset: updates ~/.barerc theme line, sets BARE_OS_THEME, calls bareOsApplyTheme when available.",
"options": [],
"keywords": ["theme", "colors", "LS_COLORS", "prompt"],
"bareOsNotes": "Requires ctx.bareOsApplyTheme for set/apply to refresh env; list/current work with static preset names.",
"examples": [
{ "caption": "list presets", "code": "theme list" },
{ "caption": "switch to Nord palette", "code": "theme set nord" },
{ "caption": "re-apply after manual env edits", "code": "theme apply" }
]
"keywords": [
"theme",
"colors",
"prompt"
],
"bareOsNotes": "list/current work without booter hooks; set/apply need ctx.bareOsApplyTheme."
}
packages/bare-os-coreutils/man/pages/time.json
+8 -2
View File
@@ -2,10 +2,16 @@
"name": "time",
"section": 1,
"title": "time a simple command",
"synopsis": ["time [OPTION]... [OPERAND]..."],
"synopsis": [
"time [OPTION]... [OPERAND]..."
],
"description": "Bare OS implementation of time a simple command. Full behavior is defined in packages/bare-os-coreutils/src/time.js.",
"options": [],
"keywords": ["time", "bare-os", "coreutils"],
"keywords": [
"time",
"bare-os",
"coreutils"
],
"examples": [
{
"caption": "wall time a command",

Some files were not shown because too many files have changed in this diff Show More