From 89265be167cf26b6a460afee2873c4c2084cfcf7 Mon Sep 17 00:00:00 2001 From: Brendan Coles Date: Wed, 3 Mar 2021 23:18:39 +0000 Subject: Base: Add man pages for null/zero/full character devices --- Base/usr/share/man/man4/full.md | 35 +++++++++++++++++++++++++++++++++++ Base/usr/share/man/man4/null.md | 19 +++++++++++++++++++ Base/usr/share/man/man4/zero.md | 26 ++++++++++++++++++++++++++ 3 files changed, 80 insertions(+) create mode 100644 Base/usr/share/man/man4/full.md create mode 100644 Base/usr/share/man/man4/null.md create mode 100644 Base/usr/share/man/man4/zero.md (limited to 'Base/usr') diff --git a/Base/usr/share/man/man4/full.md b/Base/usr/share/man/man4/full.md new file mode 100644 index 0000000000..a47da13bd7 --- /dev/null +++ b/Base/usr/share/man/man4/full.md @@ -0,0 +1,35 @@ +## Name + +full - always full device + +## Description + +`/dev/full` is a character device which is always full. + +Reading from `/dev/full` returns '\0' bytes and exits with status 0. + +Writing to `/dev/full` fails with ENOSPC error. + +To create it manually: + +```sh +mknod /dev/full c 1 7 +chmod 666 /dev/full +``` + +## Files + +* /dev/full + +## Examples + +```sh +$ head -c 8 /dev/full | hexdump +00 00 00 00 00 00 00 00 +``` + +## See also + +* [`null`(4)](../man4/null.md) +* [`zero`(4)](../man4/zero.md) + diff --git a/Base/usr/share/man/man4/null.md b/Base/usr/share/man/man4/null.md new file mode 100644 index 0000000000..cb26d40453 --- /dev/null +++ b/Base/usr/share/man/man4/null.md @@ -0,0 +1,19 @@ +## Name + +null - data sink + +## Description + +`/dev/null` is a character device file which discards input. + +Reading from `/dev/null` returns end of file and exits with status 0. + +## Files + +* /dev/null + +## See also + +* [`full`(4)](../man4/full.md) +* [`zero`(4)](../man4/zero.md) + diff --git a/Base/usr/share/man/man4/zero.md b/Base/usr/share/man/man4/zero.md new file mode 100644 index 0000000000..2300b5a33b --- /dev/null +++ b/Base/usr/share/man/man4/zero.md @@ -0,0 +1,26 @@ +## Name + +zero - data sink + +## Description + +`/dev/zero` is a character device file which discards input. + +Reading from `/dev/zero` returns '\0' bytes and exits with status 0. + +## Files + +* /dev/zero + +## Examples + +```sh +$ head -c 8 /dev/zero | hexdump +00 00 00 00 00 00 00 00 +``` + +## See also + +* [`null`(4)](../man4/null.md) +* [`full`(4)](../man4/full.md) + -- cgit v1.2.3