shithub: riscv

ref: a8f8de1cdeec7f9bee287c137b576e0249e8df82
dir: /sys/man/8/hjfs/

View raw version
.TH HJFS 8
.SH NAME
hjfs \- file server maintenance
.SH SYNOPSIS
.PD 0
.PP
.B allow
.PP
.B chatty
.PP
.B create
.I path uid gid perm
.RB [ lad ]
.PP
.B df
.PP
.B disallow
.PP
.B dump
.PP
.B echo
.RB [on | off]
.PP
.B halt
.PP
.B newuser
.I name
.RI [ options ]
.PP
.B users
.PP
.B sync
.PP
.B debug-chdeind
.I file
.RB [offset
.RB value]
.PP
.B debug-deind
.I file
.PP
.B debug-getblk
.I file
.RB [blk | start
.RB end]
.SH DESCRIPTION
The following commands should be written to the console of an
.IR hjfs (4)
file server.
.PP
.I Allow
disables permission checking and allows
changing file ownership (see
.IR chgrp (1)).
This may help in initializing a file system.
Use this with caution.
.PP
.I Chatty
enables chatty 9p.
.PP
.I Create
creates a file on the current file system.
.I Uid
and
.I gid
are names or numbers from
.BR /adm/users .
.I Perm
is the low 9 bits of the permission mode of the file, in octal.
An optional final
.BR l ,
.BR a ,
or
.BR d
creates a locked file, append-only file, or directory.
.PP
.I Df
prints the number of free, used and total blocks/megabytes.
It scans the block table and can be slow on large hard disks.
.PP
.I Disallow
restores permission checking back to normal after a file system
has been initialized.
.PP
.I Dump
immediately starts a dump.
.PP
.I Echo
expects the argument
.I on
or
.I off.
.I  On
causes all executed commands to be printed on the system console.
.I Off
reverses the effects of
.I on.
.PP
.I Halt
exits the program.
.PP
.I Newuser
requires a
.I name
argument.
With no options it adds user
.IR name ,
with group leader
.IR name ,
to
.B /adm/users
and makes the directory
.BI /usr/ name
owned by user and group
.IR name .
The options are
.TF =leaderxx
.TP
.B :
Add a group: add the name to
.B /adm/users
but don't create the directory.
By convention, groups are numbered starting from 10000, users from 0.
.TP
.I newname
Rename existing user
.I name
to
.IR newname .
.TP
.BI = leader
Change the leader of
.I name
to
.IR leader .
If
.I leader
is missing, remove the existing leader.
.TP
.BI + member
Add
.I member
to the member list of
.IR name .
.TP
.BI - member
Remove existing
.I member
from the member list of
.IR name .
.PD
.PP
After a successful
.I newuser
command the file server overwrites
.B /adm/users
to reflect the internal state of the user table.
.PP
.I Users
reads the contents of file 
.B /adm/users
to initialize the file server's internal representation of the
users structure.
.PP
.I Sync
writes dirty blocks in memory to the magnetic disk cache.
.PP
Note: Debug commands operate on internal data
structures; they are inherently dangerous and can cause
file system damage.
.PP
.I Debug-chdeind
changes the value of the byte at the specified
.I offset
in the in-memory directory entry and prints
the old
.I value.
Dangerous if used carelessly.
.PP
.I Debug-deind
requires a
.I file
argument. It prints the directory entry of
.I file.
.PP
.I Debug-getblk
prints the physical blocks of
.I file
corresponding to the logical block
.I blk
or the logical blocks between
.I start
and
.I end. 
.SH EXAMPLES
Check disk usage (output appears on the system console).
.IP
.EX
% echo df >>/srv/hjfs.cmd
.EE
.SH SEE ALSO
.IR hjfs (4)
.SH SOURCE
.B /sys/src/cmd/hjfs
.SH BUGS
.B Debug-chdeind
should perhaps be less crazy and have a portable interface.