summaryrefslogtreecommitdiff
path: root/static/plan9-4e/man4/ramfs.4
diff options
context:
space:
mode:
Diffstat (limited to 'static/plan9-4e/man4/ramfs.4')
-rw-r--r--static/plan9-4e/man4/ramfs.474
1 files changed, 74 insertions, 0 deletions
diff --git a/static/plan9-4e/man4/ramfs.4 b/static/plan9-4e/man4/ramfs.4
new file mode 100644
index 00000000..af2dece0
--- /dev/null
+++ b/static/plan9-4e/man4/ramfs.4
@@ -0,0 +1,74 @@
+.TH RAMFS 4
+.SH NAME
+ramfs \- memory file system
+.SH SYNOPSIS
+.B ramfs
+[
+.B -i
+]
+[
+.B -s
+]
+[
+.B -p
+]
+[
+.B -m
+.I mountpoint
+]
+.SH DESCRIPTION
+.I Ramfs
+starts a process that mounts itself (see
+.IR bind (2))
+on
+.I mountpoint
+(default
+.BR /tmp ).
+The
+.I ramfs
+process implements a file tree rooted at
+.IR dir ,
+keeping all files in memory.
+Initially the file tree is empty.
+.PP
+The
+.B -i
+flag tells
+.I ramfs
+to use file descriptors 0 and 1 for its communication channel
+rather than create a pipe.
+This makes it possible to use
+.I ramfs
+as a file server on a remote machine: the file descriptors 0
+and 1 will be the network channel from
+.I ramfs
+to the client machine.
+The
+.B -s
+flag causes
+.I ramfs
+to post its channel on
+.B /srv/ramfs
+rather than mounting it on
+.IR mountpoint ,
+enabling multiple clients to access its files.
+However, it does not authenticate its clients and its
+implementation of groups is simplistic, so
+it should not be used for precious data.
+.PP
+The
+.B -p
+flag causes
+.I ramfs
+to make its memory `private'
+(see
+.IR proc (3))
+so that its files are not accessible through the debugging interface.
+.PP
+This program is useful mainly as an example of how
+to write a user-level file server.
+It can also be used to provide high-performance temporary files.
+.SH SOURCE
+.B /sys/src/cmd/ramfs.c
+.SH "SEE ALSO"
+.IR bind (2)