GitLabgitlab-org

cli

main
ply6 git calls44 ms98 KiB5 cachedprotocol v2
91 lines2.6 KiBRaw
1package config
3import (
4 "errors"
5 "os"
6 "path/filepath"
7 "time"
9 "gitlab.com/gitlab-org/cli/internal/dbg"
12const (
13 // lockFilename is the advisory lock file that serializes credential writes
14 // across concurrent glab processes. It sits beside config.yml and is never
15 // itself rewritten, so it is unaffected by renameio's atomic replace of
16 // config.yml.
17 lockFilename = "config.lock"
18 // lockPollInterval is how often a blocked acquire retries the lock.
19 lockPollInterval = 20 * time.Millisecond
22// lockTimeout bounds how long acquireLock waits for another process to release
23// the lock before giving up, so a wedged holder cannot block a command forever.
24// It is a var so tests can shorten it.
25var lockTimeout = 3 * time.Second
27// errLockTimeout signals that the lock could not be acquired within lockTimeout.
28var errLockTimeout = errors.New("timed out waiting for config lock")
30// fileLock is a cross-process advisory lock scoped to a config directory. The OS
31// releases it automatically when the process exits, so a crashed holder never
32// leaves a stale lock behind (no manual staleness detection required).
33type fileLock struct {
34 f *os.File
37// acquireLock takes an exclusive cross-process lock for the config directory,
38// polling up to lockTimeout. An empty dir (in-memory config) returns a nil lock
39// and no error. On timeout it returns errLockTimeout so the caller can decide to
40// proceed unlocked rather than fail.
41func acquireLock(dir string) (*fileLock, error) {
42 if dir == "" {
43 return nil, nil
44 }
45 if err := os.MkdirAll(dir, 0o750); err != nil {
46 return nil, err
47 }
49 f, err := os.OpenFile(filepath.Join(dir, lockFilename), os.O_CREATE|os.O_RDWR, 0o600)
50 if err != nil {
51 return nil, err
52 }
54 deadline := time.Now().Add(lockTimeout)
55 for {
56 locked, err := tryFlock(f)
57 if err != nil {
58 return nil, errors.Join(err, f.Close())
59 }
60 if locked {
61 return &fileLock{f: f}, nil
62 }
63 if time.Now().After(deadline) {
64 return nil, errors.Join(errLockTimeout, f.Close())
65 }
66 time.Sleep(lockPollInterval)
67 }
70// release unlocks and closes the lock file. A nil lock (in-memory config) is a
71// no-op.
72func (l *fileLock) release() {
73 if l == nil || l.f == nil {
74 return
75 }
76 funlock(l.f)
77 _ = l.f.Close()
80// withLock runs fn while holding the config-directory lock. If the lock cannot
81// be acquired within the timeout, fn still runs (unlocked) so a wedged peer
82// never blocks a command; the degraded path is logged for GLAB_DEBUG.
83func withLock(dir string, fn func() error) error {
84 lock, err := acquireLock(dir)
85 if err != nil {
86 dbg.Debugf("config: proceeding without lock for %q: %v", dir, err)
87 return fn()
88 }
89 defer lock.release()
90 return fn()
Diagnostics6 git calls · 44 ms
CallStatusSizeTime044 ms
discover200185 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=185
git.server.agent=git/2.56.g1891de4-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=185
git.pkt.payload.max=35
ls-refs20058 KiB · hit9 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=59849
git.response.cache=HIT
git.response.duration_ms=9
git.protocol.version=2
git.pkt.frames=731
git.pkt.data=730
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=59849
git.pkt.payload.max=143
git.ls_refs.count=730
git.ls_refs.head=refs/heads/main
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=4273
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4273
git.pkt.payload.max=4173
git.sideband.band1.bytes=4173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=11
git.pack.bytes=4173
git.fetch.wide.objects=11
git.fetch.wide.extra_bytes=3930
git.fetch.wide.blobs=0
fetchtree:0 · deepen 1020032 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=32926
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=22
git.pkt.data=20
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=32926
git.pkt.payload.max=32046
git.sideband.band1.bytes=32046
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=80
git.pack.bytes=32046
git.pack.ofs_delta=36
git.pack.ref_delta=0
git.pack.chain.max=2
git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91
git.pack.full=44
Open pack map
fetchtree:02001.4 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=1391
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=e9da9edfdcf44933ee5fa121d411de326220161c
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1391
git.pkt.payload.max=1364
git.sideband.band1.bytes=1364
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1364
git.pack.trailer=bf750bd385ed98d15e1fea1289d3b00caa61d64c
Open pack map
fetch2001.3 KiB · hit31 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=31
git.response.bytes=1285
git.response.cache=HIT
git.response.duration_ms=31
git.fetch.wants=6c52155edc45a638473cbec03e23fe126a7698f6
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1285
git.pkt.payload.max=1258
git.sideband.band1.bytes=1258
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://gitlab.com/gitlab-org/cli
Ref
refs/heads/main
Commit
0dd7574dce9e385c5c30540e6c15657adc6bdce9
cf-ray
a5e1d9cd4b4da151
Request
af192fd5…
Protocol
v2 · sha1
Agent
git/2.56.g1891de4-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format