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 service 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 commands are multiple words and should be quoted to appear as a single argument to rc(1).

­allow Turn permission checking off (to simplify administration). 

­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 present, ­a creates an append only file, ­d creates a directory, and ­l creates a file that is exclusive-use. 

­sync write to disk all of the dirty blocks in the memory cache. 

­stats Report statistics about the performance of the file system. 

­user Re-initialize authentication information by reading /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 behavior 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. 

SOURCE

­/sys/src/cmd/disk/kfscmd.c
­/$objtype/bin/disk/ksync

SEE ALSO

kfs(4), mkfs(8), prep(8), sd(3)

Plan 9  —  March 27, 2001