main de06cbd

limits.md RawHistoryFolder

Limits

A pack truncated in place can crash the process

Packs and indexes are memory-mapped. If another process shrinks a mapped file, reading the missing part raises SIGBUS, which Go cannot recover from.

Git never does this: it replaces packs by renaming a new file over them. It takes an external tool that edits packs in place, or a failing disk. Not handled.

Without mmap, packs are read into memory

Linux, macOS and the BSDs map packs. On Windows and other systems, the whole .pack and .idx are read into memory when opened, so memory grows with the repository. Not handled.

Revision names

Resolve follows git rev-parse for plain names:

  • a tag wins over a branch of the same name;
  • a full 40-digit id is never read as a ref.

Use ResolveRef for a full ref name, and ResolveCommitPrefix for an abbreviation that must be a commit.

source
1# Limits
2
3## A pack truncated in place can crash the process
4
5Packs and indexes are memory-mapped. If another process shrinks a mapped file, reading the missing part raises SIGBUS, which Go cannot recover from.
6
7Git never does this: it replaces packs by renaming a new file over them. It takes an external tool that edits packs in place, or a failing disk. Not handled.
8
9## Without mmap, packs are read into memory
10
11Linux, macOS and the BSDs map packs. On Windows and other systems, the whole `.pack` and `.idx` are read into memory when opened, so memory grows with the repository. Not handled.
12
13## Revision names
14
15`Resolve` follows `git rev-parse` for plain names:
16
17- a tag wins over a branch of the same name;
18- a full 40-digit id is never read as a ref.
19
20Use `ResolveRef` for a full ref name, and `ResolveCommitPrefix` for an abbreviation that must be a commit.

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 2

↑↓ moveenter openesc close