utils

Documentation

Overview

Copyright 2025 steadybit GmbH. All rights reserved.

Index

• func LocateExecutable(name, envVar string) string
• func ReadCpusAllowedCount(fname string) (int, error)
• func RootCommandContext(ctx context.Context, name string, arg ...string) *exec.Cmd
• func ShortenUUID(uuid uuid.UUID) string
• type BackgroundState
  • func RunCommandInBackground(cmd *exec.Cmd, logger zerolog.Logger) (*BackgroundState, error)
  • func (r *BackgroundState) Exited() (bool, error)
  • func (r *BackgroundState) Wait()
• type KeyMutex
  • func NewHashedKeyMutex(n int) KeyMutex

Functions

func LocateExecutable

func LocateExecutable(name, envVar string) string

func ReadCpusAllowedCount

func ReadCpusAllowedCount(fname string) (int, error)

func RootCommandContext

func RootCommandContext(ctx context.Context, name string, arg ...string) *exec.Cmd

func ShortenUUID

func ShortenUUID(uuid uuid.UUID) string

Types

type BackgroundState

type BackgroundState struct {
	// contains filtered or unexported fields
}

func RunCommandInBackground

func RunCommandInBackground(cmd *exec.Cmd, logger zerolog.Logger) (*BackgroundState, error)

func (*BackgroundState) Exited

func (r *BackgroundState) Exited() (bool, error)

func (*BackgroundState) Wait

func (r *BackgroundState) Wait()

type KeyMutex

type KeyMutex interface {
	// Acquires a lock associated with the specified ID, creates the lock if one doesn't already exist.
	LockKey(id string)

	// Releases the lock associated with the specified ID.
	// Returns an error if the specified ID doesn't exist.
	UnlockKey(id string) error
}

KeyMutex is a thread-safe interface for acquiring locks on arbitrary strings.

func NewHashedKeyMutex

func NewHashedKeyMutex(n int) KeyMutex

NewHashedKeyMutex returns a new instance of KeyMutex which hashes arbitrary keys to a fixed set of locks. `n` specifies number of locks, if n <= 0, we use number of cpus. Note that because it uses fixed set of locks, different keys may share same lock, so it's possible to wait on same lock.