KFSCMD(8) KFSCMD(8)
NAME
kfscmd, ksync - kfs administration
SYNOPSIS
disk/kfscmd [-n name] cmd ...
disk/ksync
DESCRIPTION
Kfs is a local user-level file server for a Plan 9 terminal
with a disk. Kfscmd transmits commands to the kfs server
(see kfs(4)). The -n option changes the name of the kfs ser-
vice to kfs.name (by default, full name is just kfs).
Ksync executes the sync command for all active kfs servers.
The known commands are described below. Note that some com-
mands are multiple words and should be quoted to appear as a
single argument to rc(1).
allow Turn permission checking off (to simplify adminis-
tration).
disallow Turn permission checking on.
halt Write all changed blocks and stop the file system.
start The opposite of halt; restart the file system.
help Print the list of commands.
rename file name
Change the name of file to name.
newuser user
Add user to /adm/users and make the standard
directories needed for booting.
remove file
Remove file and place its blocks on the free list.
clri file Remove 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 f (see below).
create file owner group mode [adl]
Create the file. Owner and group are users in
/adm/users and mode is an octal number. If
Page 1 Plan 9 (printed 11/30/25)
KFSCMD(8) KFSCMD(8)
present, `a' creates an append only file, `d' cre-
ates a directory, and `l' creates a file that is
exclusive-use.
sync write to disk all of the dirty blocks in the mem-
ory cache.
stats Report statistics about the performance of the
file system.
user Re-initialize authentication information by read-
ing /adm/users.
cfs filsys
Change the `console' to the named file system
(default is the main system).
chat Toggle tracing of 9P messages.
check [PRdfprtw]
Check the file system. The options are
p print the names of directories as they are
checked.
P print the names of all files as they are
checked.
r read all of the data blocks and check the
tags.
f rebuild the list of free blocks.
d delete redundant references to a block.
t fix bad tags.
c fix bad tags and clear the contents of the
block.
w write all of the blocks that are touched.
listen [address]
Start a listener to serve the network at address,
default il!*!17008. 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
a CPU server, because #c/key needs to be readable.
The production file server (see fs(4)) is strongly
encouraged for anything more than casual use.
noneattach
When listening to the network, the default behav-
ior is that the user 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 none.
The noneattach command toggles whether none can
attach without such a chaperone.
Page 2 Plan 9 (printed 11/30/25)
KFSCMD(8) KFSCMD(8)
SOURCE
/sys/src/cmd/disk/kfscmd.c
/$objtype/bin/disk/ksync
SEE ALSO
kfs(4), mkfs(8), prep(8), sd(3)
Page 3 Plan 9 (printed 11/30/25)