浏览代码

Base: Add man pages for null/zero/full character devices

Brendan Coles 4 年之前
父节点
当前提交
89265be167
共有 3 个文件被更改,包括 80 次插入0 次删除
  1. 35 0
      Base/usr/share/man/man4/full.md
  2. 19 0
      Base/usr/share/man/man4/null.md
  3. 26 0
      Base/usr/share/man/man4/zero.md

+ 35 - 0
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)
+

+ 19 - 0
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)
+

+ 26 - 0
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)
+