util

Documentation

Index

• Constants
• func AssertValid(verify types.Verification, data []byte) error
• func CreateDeviceAlias(path string) (string, error)
• func DeviceAlias(path string) string
• func FilesystemLabel(device string) (string, error)
• func FilesystemType(device string) (string, error)
• func FilesystemUUID(device string) (string, error)
• func GetHasher(verify types.Verification) (hash.Hash, error)
• func MkdirForFile(path string) error
• func NetworkdUnitsPath() string
• func SystemdDropinsPath(unitName string) string
• func SystemdUnitsPath() string
• type FetchOp
  • func FileFromNetworkdUnit(unit types.Networkdunit) (*FetchOp, error)
  • func FileFromSystemdUnit(unit types.Unit) (*FetchOp, error)
  • func FileFromUnitDropin(unit types.Unit, dropin types.Dropin) (*FetchOp, error)
• type Util
  • func (u Util) AuthorizeSSHKeys(c types.PasswdUser) error
  • func (u Util) CheckIfUserExists(c types.PasswdUser) (bool, error)
  • func (u Util) CreateGroup(g types.PasswdGroup) error
  • func (u Util) DisableUnit(unit types.Unit) error
  • func (u Util) EnableUnit(unit types.Unit) error
  • func (u Util) EnsureUser(c types.PasswdUser) error
  • func (u Util) GetUserGroupID(l *log.Logger, user types.NodeUser, group types.NodeGroup) (*int, *int)
  • func (u Util) JoinPath(path ...string) string
  • func (u Util) MaskUnit(unit types.Unit) error
  • func (u Util) PerformFetch(f *FetchOp) error
  • func (u Util) PrepareFetch(l *log.Logger, f types.File) *FetchOp
  • func (u Util) SetPasswordHash(c types.PasswdUser) error
  • func (u Util) WriteLink(s types.Link) error

Constants

const (
	DefaultDirectoryPermissions os.FileMode = 0755
	DefaultFilePermissions      os.FileMode = 0644
)

const (
	DefaultPresetPermissions os.FileMode = 0644
)

Functions

func AssertValid

func AssertValid(verify types.Verification, data []byte) error

func CreateDeviceAlias

func CreateDeviceAlias(path string) (string, error)

CreateDeviceAlias creates a device alias for the supplied path. On success the canonicalized path used as the alias target is returned.

func DeviceAlias

func DeviceAlias(path string) string

DeviceAlias returns the aliased form of the supplied path. Note device paths in ignition are always absolute.

func FilesystemLabel

func FilesystemLabel(device string) (string, error)

func FilesystemType

func FilesystemType(device string) (string, error)

func FilesystemUUID

func FilesystemUUID(device string) (string, error)

func GetHasher

func GetHasher(verify types.Verification) (hash.Hash, error)

func MkdirForFile

func MkdirForFile(path string) error

MkdirForFile helper creates the directory components of path.

func NetworkdUnitsPath

func NetworkdUnitsPath() string

func SystemdDropinsPath

func SystemdDropinsPath(unitName string) string

func SystemdUnitsPath

func SystemdUnitsPath() string

Types

type FetchOp

type FetchOp struct {
	Hash         hash.Hash
	Path         string
	Mode         os.FileMode
	Uid          int
	Gid          int
	Url          url.URL
	FetchOptions resource.FetchOptions
}

func FileFromNetworkdUnit

func FileFromNetworkdUnit(unit types.Networkdunit) (*FetchOp, error)

func FileFromSystemdUnit

func FileFromSystemdUnit(unit types.Unit) (*FetchOp, error)

func FileFromUnitDropin

func FileFromUnitDropin(unit types.Unit, dropin types.Dropin) (*FetchOp, error)

type Util

type Util struct {
	DestDir string // directory prefix to use in applying fs paths.
	Fetcher resource.Fetcher
	*log.Logger
}

Util encapsulates logging and destdir indirection for the util methods.

func (Util) AuthorizeSSHKeys

func (u Util) AuthorizeSSHKeys(c types.PasswdUser) error

Add the provided SSH public keys to the user's authorized keys.

func (Util) CheckIfUserExists

func (u Util) CheckIfUserExists(c types.PasswdUser) (bool, error)

func (Util) CreateGroup

func (u Util) CreateGroup(g types.PasswdGroup) error

CreateGroup creates the group as described.

func (Util) DisableUnit

func (u Util) DisableUnit(unit types.Unit) error

func (Util) EnableUnit

func (u Util) EnableUnit(unit types.Unit) error

func (Util) EnsureUser

func (u Util) EnsureUser(c types.PasswdUser) error

EnsureUser ensures that the user exists as described. If the user does not yet exist, they will be created, otherwise the existing user will be modified.

func (Util) GetUserGroupID

func (u Util) GetUserGroupID(l *log.Logger, user types.NodeUser, group types.NodeGroup) (*int, *int)

func (Util) JoinPath

func (u Util) JoinPath(path ...string) string

JoinPath returns a path into the context ala filepath.Join(d, args)

func (Util) MaskUnit

func (u Util) MaskUnit(unit types.Unit) error

func (Util) PerformFetch

func (u Util) PerformFetch(f *FetchOp) error

PerformFetch performs a fetch operation generated by PrepareFetch, retrieving the file and writing it to disk. Any encountered errors are returned.

func (Util) PrepareFetch

func (u Util) PrepareFetch(l *log.Logger, f types.File) *FetchOp

PrepareFetch converts a given logger, http client, and types.File into a FetchOp. This includes operations such as parsing the source URL, generating a hasher, and performing user/group name lookups. If an error is encountered, the issue will be logged and nil will be returned.

func (Util) SetPasswordHash

func (u Util) SetPasswordHash(c types.PasswdUser) error

SetPasswordHash sets the password hash of the specified user.

func (Util) WriteLink

func (u Util) WriteLink(s types.Link) error