42 lines
1.8 KiB
JSON
42 lines
1.8 KiB
JSON
{
|
|
"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)" }
|
|
],
|
|
"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"
|
|
],
|
|
"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"
|
|
}
|
|
],
|
|
"listCategory": "coreutils"
|
|
}
|