shithub: riscv

ref: d589632207181a7960607a5938f315422386b9cb
dir: /sys/man/4/hgfs/

View raw version
.TH HGFS 4
.SH NAME
hgfs \- mercurial file system
.SH SYNOPSIS
.B hgfs
[
.B -D
]
[
.B -m
.I mtpt
]
[
.B -s
.I service
]
[
.I dir
]
.SH DESCRIPTION
Mercurial is a distributed version control system. It tracks
and organizes files and keeps a change history of them. The
file revisions are stored as packed deltas in a repository
that can be checked out with the
.I hg 
program.

.I Hgfs
serves a mercurial repository as a read-only filesystem where
each file revision and its metadata is accessible as files.

The repository may be specified by passing the working directory
.I dir
as the final argument. When omitted,
.I hgfs
locates the repository by walking
upwards from the current working directory until the
.B .hg
sub-directory is found. If no
.I mtpt
was specified with
.B -m
,
then hgfs will mount itself on
.B /mnt/hg
(default). When a
.I service
name is given with the
.B -s
flag, the 9p service pipe 
.B /srv/\fIservice\fR
is created and may be mounted from another namespace.
The
.B -D
flag enables 9p debug messages.

The root of the served filesystem contains directories each 
corresponding to a specific changeset revision in the
repository.

Revision directories are named by a revision id which
takes the form [\fId\fB.\fR]\fIh\fR, where
.I d
is the decimal revision number starting from 0 and
.I h
is the hexadecimal hash of the changeset. Both
the revision number
.I d
and the hash
.I h
are able to identify
a revision uniquely; only one of them needs to be given
when walking the root directory. The hexadecimal hash
may be shortened so long as the resulting lookup yields
a unique result. The special name
.B tip
corresponds to the latest revision but does not appear
in the directory listing.

In each revision directory the following files can be found:
.TP
.B rev
contains the revision id of the changeset.
.TP
.B rev1
contains the parent revision id of the changeset.
.TP
.B rev2
If the changeset was a merge, contains the other parent revision id. Otherwise, a zero size file.
.TP
.B log
The
.B log
file contains a list of file names, separated by a newline, that where
affected in this changeset. Files that are listed in the log
but are not accessible in the
.B files
or
.B changes
directories have been deleted in this changeset.
.TP
.B who
committer of the changeset.
.TP
.B why
commit message of the changeset.
.TP
.B files
A directory that contains a snapshot of the tree at the time
the changeset was committed.

To retrieve the \fIn\fRth
past version of a file relative to the changeset,
one can append \fB.\fIn\fR
to the filename. Appending \fB.rev\fIn\fR yields
a file that contains its revision id as text. Note that
appending \fB.rev\fI0\fR or \fB.rev\fR yields the file containing the
revision id of the changeset when the file was last modified
and \fB.\fI0\fR yields the same file as when omitting the appendix.
.TP
.B changes
Same as
.B files,
but contains only the changed files of the changeset.
.SH SOURCE
.B /sys/src/cmd/hgfs
.SH HISTORY
.I Hgfs
first appeared in 9front (June, 2011).