shithub: riscv

ref: a4c1f3cc18df6fddd548f4df9f209695c4eb7263
dir: /sys/man/4/gitfs/

View raw version
.TH GITFS 4
.SH NAME
git/fs \- git file server

.SH SYNOPSIS

git/fs
[
.B -d
]
[
.B -m
.I mtpt
]

.SH DESCRIPTION

.PP
Git/fs serves a file system interface to a git repository in the
current directory.
This file system provides a read-only view into the repository contents.
By default, it is mounted on
.B $repo/.git/fs.
It does not cache mutable data, so any changes to the git repository will immediately be reflected in git/fs.

.PP
Git/fs serves a few levels of hierarchy.
The top level contains the following files and directories:

.TP
.B branch
Exposes branches. Branches are aliases for commit objects.

.TP
.B object
Exposes all objects in the git repository.
Objects may be commits, trees, or blobs.

.TP
.B HEAD
This is an alias for the current commit.

.PP
Commits are also represented as small hierarchies. They contain
the following files:

.TP
.B author
This is the author of the commit.
The contents of this file are free-form text, but conventionally
they take the form
.B Full Name <[email protected]>

.TP
.B hash
The commit id of the current branch

.TP
.B msg
The full text of the commit message.

.TP
.B parent
The list of parent commit ids of the current commit.
One parent is listed per line.

.TP
.B tree
A directory containing the tree associated with the
commit.
The timestamp of the files contained within this
hierarchy are the same as the date of the commit.

.PP
Trees are presented as directory listings, and blobs
as files.
The repository controls the user permissions.
The group and world permissions are derived by masking
the user permissions with the permissions of the
.I .git
directory.
The user and group presented is the same as the user and
group of the
.I .git
directory.

.SH FILES
.TP
.B .git
The git repository being expected.
.TP
.B .git/HEAD
A reference to the current HEAD.
Used to populate
.B $repo/.git/fs/HEAD
.TP
.git/config
The per-repository configuation for git tools.
.TP
.B $home/lib/git/config
The global configuration for git tools.

.SH SOURCE
.TP
.B /sys/src/cmd/git/fs.c

.SH "SEE ALSO"
.IR git (1)

.SH BUGS
Symlinks are only partially supported.
They will be followed when reading, but a commit that
modifies a symlink is an error.

.PP
For efficiency, git/fs only loads repo permissions at startup

.PP
There is no way to inspect the raw objects.
Inspecting raw objects would be useful for debugging.