clientstate.go

// CGo binding for Avahi
//
// Copyright (C) 2024 and up by Alexander Pevzner (pzz@apevzner.com)
// See LICENSE for license terms and conditions
//
// Avahi Client State
//
//go:build linux || freebsd

package avahi

import "fmt"

// #include <avahi-client/client.h>
import "C"

// ClientState represents a [Client] state.
type ClientState int

// ClientState values:
const (
	// Avahi server is being registering host RRs on a network
	ClientStateRegistering ClientState = C.AVAHI_CLIENT_S_REGISTERING

	// Ahavi server is up and running
	ClientStateRunning ClientState = C.AVAHI_CLIENT_S_RUNNING

	// Avahi server was not able to register host RRs due to collision
	// with some another host.
	//
	// Administrator needs to update the host name to avoid the
	// collision.
	ClientStateCollision ClientState = C.AVAHI_CLIENT_S_COLLISION

	// Avahi server failure.
	ClientStateFailure ClientState = C.AVAHI_CLIENT_FAILURE

	// Avahi Client is trying to connect the server.
	ClientStateConnecting ClientState = C.AVAHI_CLIENT_CONNECTING
)

// clientStateNames contains names for known client states.
var clientStateNames = map[ClientState]string{
	ClientStateRegistering: "registering",
	ClientStateRunning:     "running",
	ClientStateCollision:   "collision",
	ClientStateFailure:     "failure",
	ClientStateConnecting:  "connecting",
}

// String returns name of the ClientState.
func (state ClientState) String() string {
	n := clientStateNames[state]
	if n == "" {
		n = fmt.Sprintf("UNKNOWN %d", int(state))
	}
	return n
}