remove fossil manpages
This commit is contained in:
cinap_lenrek
parent
80df5b317d
commit
d9862e4ad3
2 changed files with 0 additions and 1686 deletions
506
sys/man/4/fossil
506
sys/man/4/fossil
|
|
@ -1,506 +0,0 @@
|
|||
.TH FOSSIL 4
|
||||
.SH NAME
|
||||
fossil, flchk, flfmt \- archival file server
|
||||
.SH SYNOPSIS
|
||||
.B fossil/fossil
|
||||
[
|
||||
.B -Dt
|
||||
]
|
||||
[
|
||||
.B -c
|
||||
.I cmd
|
||||
]...
|
||||
[
|
||||
.B -f
|
||||
.I file
|
||||
]
|
||||
[
|
||||
.B -m
|
||||
.I free-memory%
|
||||
]
|
||||
.PP
|
||||
.B fossil/flchk
|
||||
[
|
||||
.B -f
|
||||
]
|
||||
[
|
||||
.B -c
|
||||
.I ncache
|
||||
]
|
||||
[
|
||||
.B -h
|
||||
.I host
|
||||
]
|
||||
.I file
|
||||
.PP
|
||||
.B fossil/flfmt
|
||||
[
|
||||
.B -y
|
||||
]
|
||||
[
|
||||
.B -b
|
||||
.I blocksize
|
||||
]
|
||||
[
|
||||
.B -h
|
||||
.I host
|
||||
]
|
||||
[
|
||||
.B -l
|
||||
.I label
|
||||
]
|
||||
[
|
||||
.B -v
|
||||
.I score
|
||||
]
|
||||
.I file
|
||||
.PP
|
||||
.B fossil/conf
|
||||
[
|
||||
.B -w
|
||||
]
|
||||
.I file
|
||||
[
|
||||
.I config
|
||||
]
|
||||
.PP
|
||||
.B fossil/last
|
||||
.I file
|
||||
.SH DESCRIPTION
|
||||
.I Fossil
|
||||
is the main file system for Plan 9.
|
||||
Unlike the Plan 9 file servers of old,
|
||||
.I fossil
|
||||
is a collection of user-space programs that run on a standard Plan 9 kernel.
|
||||
The name of the main fossil file server at Murray Hill is
|
||||
.BR pie .
|
||||
The Plan 9 distribution file server,
|
||||
.BR sources ,
|
||||
is also a fossil server.
|
||||
.PP
|
||||
.I Fossil
|
||||
is structured as a magnetic disk write buffer
|
||||
optionally backed by a Venti server for archival storage.
|
||||
It serves the Plan 9 protocol via TCP.
|
||||
A
|
||||
.I fossil
|
||||
file server conventionally presents
|
||||
three trees in the root directory of each file system:
|
||||
.BR active ,
|
||||
.BR archive ,
|
||||
and
|
||||
.BR snapshot .
|
||||
.B /active
|
||||
is the root of a conventional file system
|
||||
whose blocks are stored in a disk file.
|
||||
In a typical configuration, the file server periodically
|
||||
marks the entire file system copy-on-write, effectively
|
||||
taking a snapshot of the file system at that moment.
|
||||
This snapshot is made available in a name
|
||||
created from the date and time of the snapshot:
|
||||
.BI /snapshot/ yyyy / mmdd / hhmm \fR,
|
||||
where
|
||||
.I yyyy
|
||||
is the full year,
|
||||
.I mm
|
||||
is the month number,
|
||||
.I dd
|
||||
is the day number,
|
||||
.I hh
|
||||
is the hour,
|
||||
and
|
||||
.I mm
|
||||
is the minute.
|
||||
The snapshots in
|
||||
.B /snapshot
|
||||
are ephemeral: eventually they are deleted
|
||||
to reclaim the disk space they occupy.
|
||||
Long-lasting snapshots stored on a Venti server
|
||||
are kept in
|
||||
.B /archive
|
||||
and also named from the date (though not the time) of the snapshot:
|
||||
.BI /archive/ yyyy / mmdds \fR,
|
||||
where
|
||||
.IR yyyy ,
|
||||
.IR mm ,
|
||||
and
|
||||
.I dd
|
||||
are year, month, and day as before,
|
||||
and
|
||||
.I s
|
||||
is a sequence number if more than one
|
||||
archival snapshot is done in a day.
|
||||
For the first snapshot,
|
||||
.I s
|
||||
is null.
|
||||
For the subsequent snapshots,
|
||||
.I s
|
||||
is
|
||||
.BR .1 ,
|
||||
.BR .2 ,
|
||||
.BR .3 ,
|
||||
etc.
|
||||
The root of the main file system that is frozen
|
||||
for the first archival snapshot of December 15, 2002
|
||||
will be named
|
||||
.BR /archive/2002/1215/ .
|
||||
.PP
|
||||
The attach name used in
|
||||
.I mount
|
||||
(see
|
||||
.IR bind (1),
|
||||
.IR bind (2)
|
||||
and
|
||||
.IR attach (5))
|
||||
selects a file system to be served
|
||||
and optionally a subtree,
|
||||
in the format
|
||||
.IB fs \fR[\fB/ dir \fR].
|
||||
An empty attach name selects
|
||||
.BR main/active .
|
||||
.PP
|
||||
.I Fossil
|
||||
normally requires all users except
|
||||
.L none
|
||||
to provide authentication tickets on each
|
||||
.IR attach (5).
|
||||
To keep just anyone from connecting,
|
||||
.L none
|
||||
is only allowed to attach after another user
|
||||
has successfully attached on the same
|
||||
connection.
|
||||
The other user effectively acts as a chaperone
|
||||
for
|
||||
.LR none .
|
||||
Authentication can be disabled using the
|
||||
.B -A
|
||||
flag to
|
||||
.B open
|
||||
or
|
||||
.B srv
|
||||
(see
|
||||
.IR fossilcons (8)).
|
||||
.PP
|
||||
The groups called
|
||||
.B noworld
|
||||
and
|
||||
.B write
|
||||
are special on the file server.
|
||||
Any user belonging to
|
||||
.B noworld
|
||||
has attenuated access privileges.
|
||||
Specifically, when checking such a user's access to files,
|
||||
the file's permission bits are first ANDed
|
||||
with 0770 for normal files and 0771 for directories.
|
||||
The effect is to deny world access permissions to
|
||||
.B noworld
|
||||
users, except when walking into directories.
|
||||
If the
|
||||
.B write
|
||||
group exists, then the file system appears read-only
|
||||
to users not in the group.
|
||||
This is used to make the Plan 9 distribution file server
|
||||
.RI ( sources.cs.bell-labs.com )
|
||||
readable by the world but writable only to the developers.
|
||||
.PP
|
||||
.I Fossil
|
||||
starts a new instance of the fossil file server.
|
||||
It is configured mainly through console commands,
|
||||
documented in
|
||||
.IR fossilcons (8).
|
||||
.PP
|
||||
The options are:
|
||||
.TP
|
||||
.B -D
|
||||
Toggle the debugging flag, which is initially off.
|
||||
When the flag is set, information about authentication
|
||||
and all protocol messages are written to standard error.
|
||||
.TP
|
||||
.B -t
|
||||
Start a file server console on
|
||||
.BR /dev/cons .
|
||||
If this option is given,
|
||||
.I fossil
|
||||
does not fork itself into the background.
|
||||
.TP
|
||||
.BI -c " cmd
|
||||
Execute the console command
|
||||
.IR cmd .
|
||||
This option may be repeated to give multiple
|
||||
commands.
|
||||
Typically the only commands given on the
|
||||
command line are
|
||||
.RB `` . \fIfile \fR,''
|
||||
which executes a file containing commands,
|
||||
and
|
||||
.RB `` "srv -p" \fIcons \fR,''
|
||||
which starts a file server console on
|
||||
.BI /srv/ cons \fR.
|
||||
See
|
||||
.IR fossilcons (8)
|
||||
for more information.
|
||||
.TP
|
||||
.BI -f " file
|
||||
Read and execute console commands stored in the Fossil disk
|
||||
.IR file .
|
||||
.I Conf
|
||||
.RI ( q.v. )
|
||||
reads and writes the command set stored in the disk.
|
||||
.TP
|
||||
.B -m
|
||||
Allocate
|
||||
.I free-memory%
|
||||
percent of the available free RAM for buffers.
|
||||
This overrides all other memory sizing parameters,
|
||||
notably the
|
||||
.B -c
|
||||
option to
|
||||
.BR open .
|
||||
.PD
|
||||
.PP
|
||||
.I Flchk
|
||||
checks the fossil file system stored in
|
||||
.I file
|
||||
for inconsistencies.
|
||||
.I Flchk
|
||||
is deprecated in favor of the console
|
||||
.B check
|
||||
command (see
|
||||
.IR fossilcons (8)).
|
||||
.I Flchk
|
||||
prints
|
||||
.I fossil
|
||||
console commands that may be
|
||||
executed to take care of
|
||||
bad pointers
|
||||
.RB ( clrp ),
|
||||
bad entries
|
||||
.RB ( clre ),
|
||||
bad directory entries
|
||||
.RB ( clri ),
|
||||
unreachable blocks
|
||||
.RB ( bfree ).
|
||||
Console commands are interspersed with
|
||||
more detailed commentary on the file system.
|
||||
The commands are distinguished by being prefixed with
|
||||
sharp signs.
|
||||
Note that all proposed fixes are rather drastic: offending
|
||||
pieces of file system are simply chopped off.
|
||||
.PP
|
||||
.I Flchk
|
||||
does
|
||||
.I not
|
||||
modify the file system, so it is safe to
|
||||
run concurrently with
|
||||
.IR fossil ,
|
||||
though in this case
|
||||
the list of unreachable
|
||||
blocks and any inconsistencies involving the active file system
|
||||
should be taken with a grain of salt.
|
||||
.PP
|
||||
The options are:
|
||||
.TP
|
||||
.B -f
|
||||
Fast mode.
|
||||
By default,
|
||||
.I flchk
|
||||
checks the entire file system image for consistency,
|
||||
which includes all the archives to Venti
|
||||
and can take a very long time.
|
||||
In fast mode,
|
||||
.I flchk
|
||||
avoids walking in Venti blocks
|
||||
whenever possible.
|
||||
.TP
|
||||
.BI -c " ncache
|
||||
Keep a cache of
|
||||
.I ncache
|
||||
(by default, 1000)
|
||||
file system blocks in memory during the check.
|
||||
.TP
|
||||
.BI -h " host
|
||||
Use
|
||||
.I host
|
||||
as the Venti server.
|
||||
.PD
|
||||
.PP
|
||||
.I Flfmt
|
||||
prepares
|
||||
.I file
|
||||
as a new fossil file system.
|
||||
The file system is initialized with three empty directories
|
||||
.BR active ,
|
||||
.BR archive ,
|
||||
and
|
||||
.BR snapshot ,
|
||||
as described above.
|
||||
The options are:
|
||||
.TP
|
||||
.B -y
|
||||
Yes mode.
|
||||
By default,
|
||||
.I flfmt
|
||||
will prompt for confirmation before formatting
|
||||
a file that already contains a fossil file system,
|
||||
and before formatting a file that is not served
|
||||
directly by a kernel device.
|
||||
If the
|
||||
.B -y
|
||||
flag is given, no such checks are made.
|
||||
.TP
|
||||
.BI -b " blocksize
|
||||
Set the file system block size (by default, 8192).
|
||||
.TP
|
||||
.BI -h " host
|
||||
Use
|
||||
.I host
|
||||
as the Venti server.
|
||||
.TP
|
||||
.BI -l " label
|
||||
Set the textual label on the file system to
|
||||
.IR label .
|
||||
The label is only a comment.
|
||||
.TP
|
||||
.BI -v " score
|
||||
Initialize the file system using the vac file
|
||||
system stored on Venti at
|
||||
.IR score .
|
||||
The score should have been generated by
|
||||
.I fossil
|
||||
rather than by
|
||||
.IR vac (1),
|
||||
so that the appropriate snapshot metadata is present.
|
||||
.PD
|
||||
.PP
|
||||
.I Conf
|
||||
reads or writes the configuration branded on the Fossil disk
|
||||
.IR file .
|
||||
By default, it reads the configuration from the disk and prints it to
|
||||
standard output.
|
||||
If the
|
||||
.B -w
|
||||
flag is given,
|
||||
.I conf
|
||||
reads a new configuration from
|
||||
.I config
|
||||
(or else from standard input)
|
||||
and writes it to the disk.
|
||||
Inside the configuration file, the argument
|
||||
.L *
|
||||
may be used to stand in for the name of the disk holding the configuration.
|
||||
The Plan 9 kernel boot process runs
|
||||
.RB `` fossil
|
||||
.B -f
|
||||
.IR disk ''
|
||||
to start a Fossil file server.
|
||||
The disk is just a convenient place to store configuration
|
||||
information.
|
||||
.PP
|
||||
.I Last
|
||||
prints the vac score that resulted after the most recent archival snapshot
|
||||
of the fossil in
|
||||
.I file.
|
||||
.SH EXAMPLES
|
||||
.PP
|
||||
Place the root of the archive file system on
|
||||
.B /n/dump
|
||||
and show the modified times of the MIPS C compiler
|
||||
over all dumps in December 2002:
|
||||
.IP
|
||||
.EX
|
||||
9fs dump
|
||||
ls -l /n/dump/2002/12*/mips/bin/vc
|
||||
.EE
|
||||
.PP
|
||||
To get only one line of output for each version of the compiler:
|
||||
.IP
|
||||
.EX
|
||||
ls -lp /n/dump/2002/12*/mips/bin/vc | uniq
|
||||
.EE
|
||||
.ne 14
|
||||
.PP
|
||||
Initialize a new file system, start the server with permission
|
||||
checking turned off, create a users file, and mount the server:
|
||||
.IP
|
||||
.EX
|
||||
fossil/flfmt /dev/sdC0/fossil
|
||||
fossil/conf -w /dev/sdC0/fossil <<EOF
|
||||
fsys main config /dev/sdC0/fossil
|
||||
fsys main open -AWP
|
||||
fsys main
|
||||
create /active/adm adm sys d775
|
||||
create /active/adm/users adm sys 664
|
||||
users -w
|
||||
srv -p fscons
|
||||
srv fossil
|
||||
EOF
|
||||
fossil/fossil -f /dev/sdC0/fossil
|
||||
mount /srv/fossil /n/fossil
|
||||
.EE
|
||||
.LP
|
||||
See the discussion of the
|
||||
.B users
|
||||
and
|
||||
.B uname
|
||||
commands in
|
||||
.IR fossilcons (8)
|
||||
for more about the user table.
|
||||
.ne 3
|
||||
.PP
|
||||
Perhaps because the disk has been corrupted or replaced,
|
||||
format a new file system using the last archive score printed
|
||||
on the console:
|
||||
.IP
|
||||
.EX
|
||||
fossil/flfmt -v b9b3...5559 /dev/sdC0/fossil
|
||||
.EE
|
||||
.LP
|
||||
Note that while
|
||||
.B /snapshot
|
||||
will be lost,
|
||||
.B /active
|
||||
and
|
||||
.B /archive
|
||||
will be restored to their contents at the time of the
|
||||
last archival snapshot.
|
||||
.ne 3
|
||||
.PP
|
||||
Blindly accept the changes prescribed by
|
||||
.I flchk
|
||||
(not recommended):
|
||||
.IP
|
||||
.EX
|
||||
fossil/flchk /dev/sdC0/fossil | sed -n 's/^# //p' >>/srv/fscons
|
||||
.EE
|
||||
.LP
|
||||
A better strategy is to vet the output,
|
||||
filter out any suggestions you're not comfortable with,
|
||||
and then use the
|
||||
.I sed
|
||||
command to prepare the script.
|
||||
.SH SOURCE
|
||||
.B /sys/src/cmd/fossil
|
||||
.SH SEE ALSO
|
||||
.IR yesterday (1),
|
||||
.IR fs (3),
|
||||
.IR fs (4),
|
||||
.IR srv (4),
|
||||
.IR fossilcons (8),
|
||||
.IR venti (8)
|
||||
.SH BUGS
|
||||
It is possible that the disk format (but not the Venti format)
|
||||
will change in the future, to make the disk a full cache
|
||||
rather than just a write buffer.
|
||||
Changing to the new format will require reformatting
|
||||
the disk as in the example above,
|
||||
but note that this will preserve most of the file system
|
||||
(all but
|
||||
.BR /snapshot )
|
||||
with little effort.
|
||||
.PP
|
||||
The
|
||||
.B -m
|
||||
option currently assumes a block size of 8K bytes,
|
||||
and a single file system per
|
||||
.I fossil
|
||||
instance.
|
||||
1180
sys/man/8/fossilcons
1180
sys/man/8/fossilcons
File diff suppressed because it is too large
Load diff
Loading…
Reference in a new issue