package posixlock import ( "sync" "time" ) // Manager is the owner filer's in-memory authority for POSIX advisory locks // across inodes. Lock state lives here, not in replicated metadata: it is // transient coordination, so keeping it out of the meta-log avoids churn and // does not pollute what subscribers see (the distributed lock manager holds its // locks the same way). A `Set` per inode key, plus a session index so a dead // mount's locks are reaped in O(locks held) rather than by scanning every inode. // // key is an opaque inode identity supplied by the caller — the file's path, or // "hl:"+hex(HardLinkId) for a hardlinked inode — so all names of one inode share // a Set. The Manager is safe for concurrent use. type Manager struct { mu sync.Mutex byKey map[string]*Set // inode key -> held locks bySid map[uint64]map[string]bool // session -> keys it currently holds locks on lastSeen map[uint64]time.Time // session -> last keepalive; only renewing sessions are leased } func NewManager() *Manager { return &Manager{ byKey: make(map[string]*Set), bySid: make(map[uint64]map[string]bool), lastSeen: make(map[uint64]time.Time), } } // Renew records a keepalive from a session, placing it under lease management. // Only sessions that have renewed are subject to ReapExpired, so a session that // never sends keepalives (e.g. before the mount keepalive exists) is never reaped. func (m *Manager) Renew(sid uint64) { m.mu.Lock() defer m.mu.Unlock() m.lastSeen[sid] = time.Now() } // ReapExpired releases the locks of every leased session whose last keepalive is // older than ttl — a dead or partitioned mount. Sessions that never renewed are // left untouched. Returns the reaped session ids. func (m *Manager) ReapExpired(ttl time.Duration) []uint64 { m.mu.Lock() defer m.mu.Unlock() cutoff := time.Now().Add(-ttl) var reaped []uint64 for sid, seen := range m.lastSeen { if seen.After(cutoff) { continue } for key := range m.bySid[sid] { s := m.byKey[key] if s == nil { continue } s.ReleaseSession(sid) if s.Empty() { delete(m.byKey, key) } } delete(m.bySid, sid) delete(m.lastSeen, sid) reaped = append(reaped, sid) } return reaped } // TryLock grants lk on key, or returns the conflicting lock and false. The set // is created on first use and dropped again when it empties. func (m *Manager) TryLock(key string, lk Range) (Range, bool) { m.mu.Lock() defer m.mu.Unlock() s, ok := m.byKey[key] if !ok { s = &Set{} } if c, granted := s.Acquire(lk); !granted { return c, false } if !ok { m.byKey[key] = s } m.index(lk.Sid, key) return Range{}, true } // Track records a lock the server already granted, without arbitration. A mount // uses it to mirror its own held locks so it can re-assert them to the inode's // current owner filer after an ownership change or owner restart. func (m *Manager) Track(key string, lk Range) { m.mu.Lock() defer m.mu.Unlock() s, ok := m.byKey[key] if !ok { s = &Set{} m.byKey[key] = s } s.Grant(lk) m.index(lk.Sid, key) } // Snapshot returns a copy of the held locks per key. A mount calls it to drive // re-assertion keepalives; the filer never does. func (m *Manager) Snapshot() map[string][]Range { m.mu.Lock() defer m.mu.Unlock() out := make(map[string][]Range, len(m.byKey)) for key, s := range m.byKey { out[key] = append([]Range(nil), s.locks...) } return out } // Reassert rebuilds session sid's locks on key from the client's authoritative // list, renewing the lease. It replaces sid's existing locks on the key, then // re-acquires each asserted lock — arbitrating against other sessions so it never // double-grants. Locks that lost to another session in a migration window are // returned as conflicts. The owner filer calls this on a re-assertion keepalive. func (m *Manager) Reassert(key string, sid uint64, locks []Range) (conflicts []Range) { m.mu.Lock() defer m.mu.Unlock() m.lastSeen[sid] = time.Now() s := m.byKey[key] if s == nil { if len(locks) == 0 { return nil } s = &Set{} m.byKey[key] = s } s.ReleaseSession(sid) for _, lk := range locks { lk.Sid = sid if c, granted := s.Acquire(lk); !granted { conflicts = append(conflicts, c) } } if setHasSession(s, sid) { m.index(sid, key) } else { m.deindex(sid, key) } if s.Empty() { delete(m.byKey, key) } return conflicts } // Unlock releases lk's owner's locks within its namespace over lk's range. func (m *Manager) Unlock(key string, lk Range) { m.mu.Lock() defer m.mu.Unlock() s := m.byKey[key] if s == nil { return } s.Release(lk) m.afterRelease(key, s, lk.Sid) } // GetLk reports the lock that would block proposed on key, if any. func (m *Manager) GetLk(key string, proposed Range) (Range, bool) { m.mu.Lock() defer m.mu.Unlock() s := m.byKey[key] if s == nil { return Range{}, false } return s.Conflict(proposed) } // ReleasePosixOwner drops (sid, owner)'s fcntl locks on key — the flush-time path. func (m *Manager) ReleasePosixOwner(key string, sid, owner uint64) { m.mu.Lock() defer m.mu.Unlock() s := m.byKey[key] if s == nil { return } s.ReleasePosixOwner(sid, owner) m.afterRelease(key, s, sid) } // ReleaseFlockOwner drops (sid, owner)'s flock locks on key — the release-time path. func (m *Manager) ReleaseFlockOwner(key string, sid, owner uint64) { m.mu.Lock() defer m.mu.Unlock() s := m.byKey[key] if s == nil { return } s.ReleaseFlockOwner(sid, owner) m.afterRelease(key, s, sid) } // ReleaseSession drops every lock held by a session across all inodes it touched, // reaping a mount whose lease expired. O(locks held by the session). func (m *Manager) ReleaseSession(sid uint64) { m.mu.Lock() defer m.mu.Unlock() for key := range m.bySid[sid] { s := m.byKey[key] if s == nil { continue } s.ReleaseSession(sid) if s.Empty() { delete(m.byKey, key) } } delete(m.bySid, sid) } // afterRelease prunes the session index when sid no longer holds any lock on key, // and drops the set when it empties. Only sid's presence can have changed, since // a release only removes sid's locks. func (m *Manager) afterRelease(key string, s *Set, sid uint64) { if s.Empty() { delete(m.byKey, key) m.deindex(sid, key) return } if !setHasSession(s, sid) { m.deindex(sid, key) } } func (m *Manager) index(sid uint64, key string) { keys := m.bySid[sid] if keys == nil { keys = make(map[string]bool) m.bySid[sid] = keys } keys[key] = true } func (m *Manager) deindex(sid uint64, key string) { keys := m.bySid[sid] if keys == nil { return } delete(keys, key) if len(keys) == 0 { delete(m.bySid, sid) } } func setHasSession(s *Set, sid uint64) bool { for _, l := range s.Locks() { if l.Sid == sid { return true } } return false }