Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ (8) — Plan9 3rd Edition (Vita Nuova)

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

kfs(3)

mkfs(8)

ata(3)

KFSCMD(8)

NAME

kfscmd, kfswiz − kfs administration

SYNOPSIS

­disk/kfscmd [-n name] cmd ...

­disk/kfswiz

DESCRIPTION

­Kfscmd issues commands to the kfs(3) device. The ­-n option names the file system to which the ­cmd applies (the ­main file system by default). 

The known commands are described below.  Note that some commands are multiple words and should be quoted to appear as a single argument to sh(1).

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

­disallow Turn permission checking on. 

­halt write all changed blocks and stop the file system. 

­help print the list of commands. 

cfs[name] Apply subsequent commands to file system name; the ­main file system by default. 

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. 

­user Re-initialize authentication information by reading /adm/users. 

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

­readonly Reject file system operations that would update the device.  ­readwrite Allow the device to be updated.  ­flashwrite Suppress updates of access times to reduce the number of writes to the device; intended for use on file systems in flash memory, with or without ftl(3).

­Kfswiz reads a kfs image from its standard input and writes a kfs image to its standard output, converting the file system data structures from big-endian to little-endian or vice-versa.  This allows an image to be created by a machine that uses one byte order for use on a machine that uses the other. 

SOURCE

­/appl/cmd/disk/kfscmd.b
­/appl/cmd/disk/kfswiz.b

SEE ALSO

kfs(3), mkfs(8), ata(3)

BUGS

The kfs(3) console output appears on the Inferno console, not kfscmd’s standard output.

Plan 9  —  May 18, 2000

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026