shithub: riscv

Info  •  Files  •  Log  •  Branches

remove kfs references from manual

--- a/sys/man/1/fstype

+++ b/sys/man/1/fstype

@@ -28,8 +28,7 @@

 .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

--- a/sys/man/1/replica

+++ b/sys/man/1/replica

@@ -267,9 +267,9 @@

     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

--- a/sys/man/3/fs

+++ b/sys/man/3/fs

@@ -225,11 +225,11 @@

 .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:

--- a/sys/man/4/cwfs

+++ b/sys/man/4/cwfs

@@ -180,8 +180,7 @@

 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

--- a/sys/man/4/dossrv

+++ b/sys/man/4/dossrv

@@ -162,8 +162,6 @@

 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

--- a/sys/man/4/fs

+++ b/sys/man/4/fs

@@ -45,8 +45,8 @@

 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

--- a/sys/man/4/kfs

+++ /dev/null

@@ -1,135 +1,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.

--- a/sys/man/8/kfscmd

+++ /dev/null

@@ -1,221 +1,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)

--- a/sys/man/8/swap

+++ b/sys/man/8/swap

@@ -28,8 +28,7 @@

 .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