remove kfs references from manual
This commit is contained in:
cinap_lenrek
parent
3db2012126
commit
cb474632d3
9 changed files with 10 additions and 371 deletions
|
|
@ -28,8 +28,7 @@ compressed
|
||||||
.IR paqfs (4)
|
.IR paqfs (4)
|
||||||
.TP
|
.TP
|
||||||
.B kfs
|
.B kfs
|
||||||
Plan 9 disk file system (see
|
old Plan 9 disk file system
|
||||||
.IR kfs (4))
|
|
||||||
.TP
|
.TP
|
||||||
.B fs
|
.B fs
|
||||||
32-bit and
|
32-bit and
|
||||||
|
|
|
||||||
|
|
@ -267,9 +267,9 @@ As an example, the Plan 9 distribution replica configuration looks like:
|
||||||
serverlog=$s/plan9.log
|
serverlog=$s/plan9.log
|
||||||
serverproto=$s/plan9.proto
|
serverproto=$s/plan9.proto
|
||||||
|
|
||||||
fn clientmount { 9fs kfs }
|
fn clientmount { 9fs boot }
|
||||||
clientroot=/n/kfs
|
clientroot=/n/boot
|
||||||
c=/n/kfs/dist/replica
|
c=/n/boot/dist/replica
|
||||||
clientlog=$c/client/plan9.log
|
clientlog=$c/client/plan9.log
|
||||||
clientproto=$c/plan9.proto
|
clientproto=$c/plan9.proto
|
||||||
clientdb=$c/client/plan9.db
|
clientdb=$c/client/plan9.db
|
||||||
|
|
|
||||||
|
|
@ -225,11 +225,11 @@ echo inter data /dev/fs/m0 /dev/fs/m1 >/dev/fs/ctl
|
||||||
.EE
|
.EE
|
||||||
.LP
|
.LP
|
||||||
Run
|
Run
|
||||||
.IR kfs (4)
|
.IR hjfs (4)
|
||||||
on the interleaved device:
|
on the interleaved device:
|
||||||
.IP
|
.IP
|
||||||
.EX
|
.EX
|
||||||
disk/kfs -f /dev/fs/data
|
hjfs -f /dev/fs/data
|
||||||
.EE
|
.EE
|
||||||
.LP
|
.LP
|
||||||
Save the configuration:
|
Save the configuration:
|
||||||
|
|
|
||||||
|
|
@ -180,8 +180,7 @@ on a combination of disks and
|
||||||
write-once-read-many (WORM) magneto-optical disks.
|
write-once-read-many (WORM) magneto-optical disks.
|
||||||
.TP
|
.TP
|
||||||
.B other
|
.B other
|
||||||
is a simple disk-based file system similar to
|
is a simple disk-based file system not backed by worm.
|
||||||
.IR kfs (4) .
|
|
||||||
.TP
|
.TP
|
||||||
.B main
|
.B main
|
||||||
is a worm-based file system with a disk-based
|
is a worm-based file system with a disk-based
|
||||||
|
|
|
||||||
|
|
@ -162,8 +162,6 @@ If the floppy drive has an ejection motor,
|
||||||
will spit out the floppy from drive
|
will spit out the floppy from drive
|
||||||
.IR n ,
|
.IR n ,
|
||||||
default 0.
|
default 0.
|
||||||
.SH "SEE ALSO"
|
|
||||||
.IR kfs (4)
|
|
||||||
.SH SOURCE
|
.SH SOURCE
|
||||||
.B /sys/src/cmd/dossrv
|
.B /sys/src/cmd/dossrv
|
||||||
.br
|
.br
|
||||||
|
|
|
||||||
|
|
@ -45,8 +45,8 @@ on a combination of disks and
|
||||||
write-once-read-many (WORM) magneto-optical disks.
|
write-once-read-many (WORM) magneto-optical disks.
|
||||||
.TP
|
.TP
|
||||||
.B other
|
.B other
|
||||||
is a simple disk-based file system similar to
|
is a simple disk-based file system not backed by
|
||||||
.IR kfs (4) .
|
the worm.
|
||||||
.TP
|
.TP
|
||||||
.B main
|
.B main
|
||||||
is a worm-based file system with a disk-based
|
is a worm-based file system with a disk-based
|
||||||
|
|
|
||||||
135
sys/man/4/kfs
135
sys/man/4/kfs
|
|
@ -1,135 +0,0 @@
|
||||||
.TH KFS 4
|
|
||||||
.SH NAME
|
|
||||||
kfs \- disk file system
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.B disk/kfs
|
|
||||||
[
|
|
||||||
.B -rc
|
|
||||||
] [
|
|
||||||
.B -b
|
|
||||||
.I n
|
|
||||||
] [
|
|
||||||
.B -f
|
|
||||||
.I file
|
|
||||||
] [
|
|
||||||
.B -n
|
|
||||||
.I name
|
|
||||||
] [
|
|
||||||
.B -p
|
|
||||||
.I perm
|
|
||||||
] [
|
|
||||||
.B -s
|
|
||||||
] [
|
|
||||||
.B -B
|
|
||||||
.I nbuf
|
|
||||||
]
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.I Kfs
|
|
||||||
is an old, local user-level file server for a Plan 9 terminal with a disk.
|
|
||||||
It maintains a hierarchical Plan 9 file system on the disk
|
|
||||||
and offers
|
|
||||||
9P (see
|
|
||||||
.IR intro (5))
|
|
||||||
access to it.
|
|
||||||
.I Kfs
|
|
||||||
begins by
|
|
||||||
checking the file system for consistency,
|
|
||||||
rebuilding the free list, and placing a file descriptor in
|
|
||||||
.BI /srv/ name\f1,
|
|
||||||
where
|
|
||||||
.I name
|
|
||||||
is the service name (default
|
|
||||||
.BR kfs ).
|
|
||||||
If the file system is inconsistent,
|
|
||||||
the user is asked for permission to ream
|
|
||||||
.RI ( q.v. )
|
|
||||||
the disk.
|
|
||||||
The file system is not checked if it is reamed.
|
|
||||||
.PP
|
|
||||||
The options are
|
|
||||||
.TF "n name"
|
|
||||||
.TP
|
|
||||||
.BI "b " n
|
|
||||||
If the file system is reamed, use
|
|
||||||
.I n
|
|
||||||
byte blocks.
|
|
||||||
Larger blocks make the file system faster
|
|
||||||
and less space efficient.
|
|
||||||
.B 1024
|
|
||||||
and
|
|
||||||
.B 4096
|
|
||||||
are good choices.
|
|
||||||
.I N
|
|
||||||
must be a multiple of 512.
|
|
||||||
.TP
|
|
||||||
.B c
|
|
||||||
Do not check the file system.
|
|
||||||
.TP
|
|
||||||
.BI "f " file
|
|
||||||
Use
|
|
||||||
.I file
|
|
||||||
as the disk.
|
|
||||||
The default is
|
|
||||||
.BR /dev/sdC0/fs .
|
|
||||||
.TP
|
|
||||||
.BI "n " name
|
|
||||||
Use
|
|
||||||
.RI kfs. name
|
|
||||||
as the name of the service.
|
|
||||||
.TP
|
|
||||||
.BI "p " perm
|
|
||||||
Use
|
|
||||||
.I perm
|
|
||||||
as the initial permissions for the
|
|
||||||
command channel
|
|
||||||
.BI /srv/ service .cmd\fR;
|
|
||||||
the default is 660.
|
|
||||||
.TP
|
|
||||||
.B r
|
|
||||||
Ream the file system, erasing all of the old data
|
|
||||||
and adding all blocks to the free list.
|
|
||||||
.TP
|
|
||||||
.B s
|
|
||||||
Post file descriptor zero in
|
|
||||||
.BI /srv/ service
|
|
||||||
and read and write protocol messages on file descriptor one.
|
|
||||||
.TP
|
|
||||||
.B B
|
|
||||||
Allocate
|
|
||||||
.I nbuf
|
|
||||||
in-memory file system blocks.
|
|
||||||
The default is as many as will fit in 10% of memory
|
|
||||||
or two megabytes, whichever is smaller.
|
|
||||||
.PD
|
|
||||||
.SH EXAMPLES
|
|
||||||
Create a file system with service name
|
|
||||||
.I kfs.local
|
|
||||||
and mount it on
|
|
||||||
.BR /n/kfs .
|
|
||||||
.IP
|
|
||||||
.EX
|
|
||||||
% disk/kfs -rb4096 -nlocal
|
|
||||||
% mount -c /srv/kfs.local /n/kfs
|
|
||||||
.EE
|
|
||||||
.PP
|
|
||||||
.SH FILES
|
|
||||||
.TF /dev/sdC0/fs
|
|
||||||
.TP
|
|
||||||
.B /dev/sdC0/fs
|
|
||||||
Default file holding blocks.
|
|
||||||
.SH SOURCE
|
|
||||||
.B /sys/src/cmd/disk/kfs
|
|
||||||
.SH "SEE ALSO"
|
|
||||||
.IR kfscmd (8),
|
|
||||||
.IR mkfs (8),
|
|
||||||
.IR prep (8),
|
|
||||||
.IR sd (3)
|
|
||||||
.SH BUGS
|
|
||||||
For the moment,
|
|
||||||
.I kfs
|
|
||||||
serves both the old (third edition) and new (fourth
|
|
||||||
edition) versions of 9P, deciding which to serve by sniffing the first packet on each
|
|
||||||
connection.
|
|
||||||
.LP
|
|
||||||
.I Kfs
|
|
||||||
doesn't allow creating files with component names longer than 28 bytes.
|
|
||||||
221
sys/man/8/kfscmd
221
sys/man/8/kfscmd
|
|
@ -1,221 +0,0 @@
|
||||||
.TH KFSCMD 8
|
|
||||||
.SH NAME
|
|
||||||
kfscmd, ksync \- kfs administration
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.B disk/kfscmd
|
|
||||||
.RB [ -n
|
|
||||||
.IR name ]
|
|
||||||
cmd ...
|
|
||||||
.PP
|
|
||||||
.B disk/ksync
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.I Kfs
|
|
||||||
is a local user-level file server for a Plan 9 terminal with a disk.
|
|
||||||
.I Kfscmd
|
|
||||||
transmits commands to the
|
|
||||||
.I kfs
|
|
||||||
server (see
|
|
||||||
.IR kfs (4)).
|
|
||||||
The
|
|
||||||
.B -n
|
|
||||||
option changes the name of the kfs service to
|
|
||||||
.BI kfs. name
|
|
||||||
(by default, full name is just
|
|
||||||
.BR kfs ).
|
|
||||||
.PP
|
|
||||||
.I Ksync
|
|
||||||
executes the
|
|
||||||
.B sync
|
|
||||||
command for all active
|
|
||||||
.I kfs
|
|
||||||
servers.
|
|
||||||
.PP
|
|
||||||
The known commands are described below.
|
|
||||||
Note that some commands are multiple words and
|
|
||||||
should be quoted to appear as a single argument to
|
|
||||||
.IR rc (1).
|
|
||||||
.TP \w'\fLallowoff\ \fIn'u
|
|
||||||
.B allow
|
|
||||||
Turn permission checking off (to simplify administration).
|
|
||||||
.TP
|
|
||||||
.B allowoff
|
|
||||||
.TP
|
|
||||||
.B disallow
|
|
||||||
Turn permission checking on.
|
|
||||||
.TP
|
|
||||||
.B noauth
|
|
||||||
Disable authentication of users.
|
|
||||||
.TP
|
|
||||||
.B halt
|
|
||||||
Write all changed blocks and stop the file system.
|
|
||||||
.TP
|
|
||||||
.B start
|
|
||||||
The opposite of halt; restart the file system.
|
|
||||||
.TP
|
|
||||||
.B help
|
|
||||||
Print the list of commands.
|
|
||||||
.TP
|
|
||||||
.BI "rename " "file name"
|
|
||||||
Change the name of
|
|
||||||
.I file
|
|
||||||
to
|
|
||||||
.IR name .
|
|
||||||
.I Name
|
|
||||||
may be a single path element or a full path; if it is a full path,
|
|
||||||
every element along the path must exist except the last.
|
|
||||||
.TP
|
|
||||||
.BI "newuser " user
|
|
||||||
Add
|
|
||||||
.I user
|
|
||||||
to
|
|
||||||
.B /adm/users
|
|
||||||
and make the standard directories needed for booting.
|
|
||||||
.TP
|
|
||||||
.BI "remove " file
|
|
||||||
Remove
|
|
||||||
.I file
|
|
||||||
and place its blocks on the free list.
|
|
||||||
.TP
|
|
||||||
.BI "clri " file
|
|
||||||
Remove
|
|
||||||
.I file
|
|
||||||
but do not place the blocks on the free list.
|
|
||||||
This command can be used to remove files that have duplicated blocks.
|
|
||||||
The non-duplicate blocks can be retrieved by checking the file system
|
|
||||||
with option
|
|
||||||
.B f
|
|
||||||
(see below).
|
|
||||||
.TP
|
|
||||||
.BI create \ file\ owner\ group\ mode\ [adl]
|
|
||||||
Create the file. Owner and group are users in
|
|
||||||
.B /adm/users
|
|
||||||
and mode is an octal number.
|
|
||||||
If present,
|
|
||||||
.L a
|
|
||||||
creates an append only file,
|
|
||||||
.L d
|
|
||||||
creates a directory, and
|
|
||||||
.L l
|
|
||||||
creates a file that is exclusive-use.
|
|
||||||
.TP
|
|
||||||
.B sync
|
|
||||||
Write to disk all of the dirty blocks in the memory cache.
|
|
||||||
.TP
|
|
||||||
.B atime
|
|
||||||
Toggle whether atimes are updated as files and directories
|
|
||||||
are accessed. By default, atimes are updated. On laptops it can be
|
|
||||||
useful to turn off atime updates to reduce disk accesses.
|
|
||||||
.TP
|
|
||||||
.B stats
|
|
||||||
Report statistics about the performance of the file system.
|
|
||||||
.TP
|
|
||||||
.B user
|
|
||||||
Re-initialize authentication information by reading
|
|
||||||
.BR /adm/users .
|
|
||||||
.TP
|
|
||||||
.B nowritegroup
|
|
||||||
Each time
|
|
||||||
.I kfs
|
|
||||||
rereads
|
|
||||||
.BR /adm/users ,
|
|
||||||
it looks for a group named
|
|
||||||
.BR write .
|
|
||||||
If such a group exists, then the entire file system
|
|
||||||
will appear read-only to users not in the group.
|
|
||||||
If a write group exists but no one is in it,
|
|
||||||
it will be impossible to edit
|
|
||||||
.B /adm/users
|
|
||||||
to correct the problem.
|
|
||||||
To resolve this, the
|
|
||||||
.B nowritegroup
|
|
||||||
command turns off write group checking until the next
|
|
||||||
time
|
|
||||||
.B /adm/users
|
|
||||||
is reread.
|
|
||||||
.TP
|
|
||||||
.BI cfs " filsys
|
|
||||||
Change the `console' to the named file system (default is the main system).
|
|
||||||
.TP
|
|
||||||
.B chat
|
|
||||||
Toggle tracing of 9P messages.
|
|
||||||
.TP
|
|
||||||
.B check [cdfpPqrtw]
|
|
||||||
Check the file system and print summary information.
|
|
||||||
The options are
|
|
||||||
.PD 0
|
|
||||||
.RS
|
|
||||||
.TP
|
|
||||||
.B c
|
|
||||||
fix bad tags and clear the contents of the block.
|
|
||||||
.TP
|
|
||||||
.B d
|
|
||||||
delete redundant references to a block, fix bad UTF filenames.
|
|
||||||
.TP
|
|
||||||
.B f
|
|
||||||
rebuild the list of free blocks.
|
|
||||||
.TP
|
|
||||||
.B p
|
|
||||||
print the names of directories as they are checked.
|
|
||||||
.TP
|
|
||||||
.B P
|
|
||||||
print the names of all files as they are checked.
|
|
||||||
.TP
|
|
||||||
.B q
|
|
||||||
quiet mode: report errors, but suppress summary information
|
|
||||||
.TP
|
|
||||||
.B r
|
|
||||||
read all of the data blocks and check the tags.
|
|
||||||
.TP
|
|
||||||
.B t
|
|
||||||
fix bad tags.
|
|
||||||
.TP
|
|
||||||
.B w
|
|
||||||
write all of the blocks that are touched.
|
|
||||||
.RE
|
|
||||||
.PD
|
|
||||||
.TP
|
|
||||||
.BI listen " [address]
|
|
||||||
Start a listener to serve the network at
|
|
||||||
.IR address ,
|
|
||||||
default
|
|
||||||
.BR tcp!*!564 .
|
|
||||||
This feature is intended to facilitate small networks of a couple
|
|
||||||
machines in the situation when convenience is more
|
|
||||||
important than performance.
|
|
||||||
This command is only useful on machines with
|
|
||||||
(possibly simulated) NVRAM, which needs to be readable
|
|
||||||
to the
|
|
||||||
.I kfs
|
|
||||||
processes;
|
|
||||||
see
|
|
||||||
.I readnvram
|
|
||||||
in
|
|
||||||
.IR authsrv (2).
|
|
||||||
The production file server
|
|
||||||
(see
|
|
||||||
.IR fs (4))
|
|
||||||
is strongly encouraged for anything more than casual use.
|
|
||||||
.TP
|
|
||||||
.B noneattach
|
|
||||||
When listening to the network, the default behavior is that the user
|
|
||||||
.B none
|
|
||||||
may only attach over connections that have already
|
|
||||||
authenticated as someone else.
|
|
||||||
This prevents just anyone from being
|
|
||||||
able to dial your server and attach as
|
|
||||||
.BR none .
|
|
||||||
The
|
|
||||||
.B noneattach
|
|
||||||
command toggles whether
|
|
||||||
.B none
|
|
||||||
can attach without such a chaperone.
|
|
||||||
.PD
|
|
||||||
.SH SOURCE
|
|
||||||
.B /sys/src/cmd/disk/kfscmd.c
|
|
||||||
.br
|
|
||||||
.B /$objtype/bin/disk/ksync
|
|
||||||
.SH "SEE ALSO"
|
|
||||||
.IR kfs (4),
|
|
||||||
.IR mkfs (8),
|
|
||||||
.IR prep (8),
|
|
||||||
.IR sd (3)
|
|
||||||
|
|
@ -28,8 +28,7 @@ the device an error is returned instead.
|
||||||
.SH SOURCE
|
.SH SOURCE
|
||||||
.B /sys/src/cmd/swap.c
|
.B /sys/src/cmd/swap.c
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
Swapping to a file served by a local user-level process, such as
|
Swapping to a file served by a local user-level process
|
||||||
.IR kfs (4),
|
|
||||||
will lead to deadlock if the process isn't made non-swappable
|
will lead to deadlock if the process isn't made non-swappable
|
||||||
(see the
|
(see the
|
||||||
.B noswap
|
.B noswap
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue