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)
|
||||
.TP
|
||||
.B kfs
|
||||
Plan 9 disk file system (see
|
||||
.IR kfs (4))
|
||||
old Plan 9 disk file system
|
||||
.TP
|
||||
.B fs
|
||||
32-bit and
|
||||
|
|
|
|||
|
|
@ -267,9 +267,9 @@ As an example, the Plan 9 distribution replica configuration looks like:
|
|||
serverlog=$s/plan9.log
|
||||
serverproto=$s/plan9.proto
|
||||
|
||||
fn clientmount { 9fs kfs }
|
||||
clientroot=/n/kfs
|
||||
c=/n/kfs/dist/replica
|
||||
fn clientmount { 9fs boot }
|
||||
clientroot=/n/boot
|
||||
c=/n/boot/dist/replica
|
||||
clientlog=$c/client/plan9.log
|
||||
clientproto=$c/plan9.proto
|
||||
clientdb=$c/client/plan9.db
|
||||
|
|
|
|||
|
|
@ -225,11 +225,11 @@ echo inter data /dev/fs/m0 /dev/fs/m1 >/dev/fs/ctl
|
|||
.EE
|
||||
.LP
|
||||
Run
|
||||
.IR kfs (4)
|
||||
.IR hjfs (4)
|
||||
on the interleaved device:
|
||||
.IP
|
||||
.EX
|
||||
disk/kfs -f /dev/fs/data
|
||||
hjfs -f /dev/fs/data
|
||||
.EE
|
||||
.LP
|
||||
Save the configuration:
|
||||
|
|
|
|||
|
|
@ -180,8 +180,7 @@ on a combination of disks and
|
|||
write-once-read-many (WORM) magneto-optical disks.
|
||||
.TP
|
||||
.B other
|
||||
is a simple disk-based file system similar to
|
||||
.IR kfs (4) .
|
||||
is a simple disk-based file system not backed by worm.
|
||||
.TP
|
||||
.B main
|
||||
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
|
||||
.IR n ,
|
||||
default 0.
|
||||
.SH "SEE ALSO"
|
||||
.IR kfs (4)
|
||||
.SH SOURCE
|
||||
.B /sys/src/cmd/dossrv
|
||||
.br
|
||||
|
|
|
|||
|
|
@ -45,8 +45,8 @@ on a combination of disks and
|
|||
write-once-read-many (WORM) magneto-optical disks.
|
||||
.TP
|
||||
.B other
|
||||
is a simple disk-based file system similar to
|
||||
.IR kfs (4) .
|
||||
is a simple disk-based file system not backed by
|
||||
the worm.
|
||||
.TP
|
||||
.B main
|
||||
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
|
||||
.B /sys/src/cmd/swap.c
|
||||
.SH BUGS
|
||||
Swapping to a file served by a local user-level process, such as
|
||||
.IR kfs (4),
|
||||
Swapping to a file served by a local user-level process
|
||||
will lead to deadlock if the process isn't made non-swappable
|
||||
(see the
|
||||
.B noswap
|
||||
|
|
|
|||
Loading…
Reference in a new issue