207 lines
3.2 KiB
Text
207 lines
3.2 KiB
Text
.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.
|