KFSCMD(8)                                               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 com-
          mands are multiple words and should be quoted to appear as a
          single argument to sh(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.

          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 pre-
                    sent, `a' creates an append only file, `d' creates
                    a directory, and `l' creates a file that is

     Page 1                       Plan 9            (printed 11/18/24)

     KFSCMD(8)                                               KFSCMD(8)

                    exclusive-use.

          sync      write to disk all of the dirty blocks in the mem-
                    ory cache.

          user      Re-initialize authentication information by read-
                    ing /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 sys-
          tem 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
          ata(3), kfs(3), mkfs(8)

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

     Page 2                       Plan 9            (printed 11/18/24)