tftp

type File interface {
	io.ReaderAt
	Size() int64
}

type FileSystem interface {
	Open(path string) (File, error)
}

type ImageResolver interface {
	ResolveImage(path string) (Resolved, error)
}

type Resolved struct {
	Image string
	Path  string
}

type Server struct {
	FS FileSystem

	// AllowIP filters clients; nil allows everyone.
	AllowIP func(netip.Addr) bool

	// PortMin and PortMax bound the transfer sockets' local ports.
	// Zero means ephemeral.
	PortMin, PortMax int

	// RetryInterval is the DATA retransmit interval (default 1s).
	RetryInterval time.Duration

	// Retries is how many times a DATA block is resent before the
	// transfer is abandoned (default 5).
	Retries int

	// FinalRetries and FinalTimeout govern only the last DATA block of a
	// transfer (default 1 retry, 300ms). SGI PROMs reopen a file to seek
	// within it and routinely stop listening once they have what they
	// need, without ACKing the last block sent; the ordinary mid-transfer
	// retry budget (Retries x RetryInterval) exists for real packet loss,
	// not for that expected silence, so the last block gets a cheaper
	// policy to avoid paying it on every reopen.
	FinalRetries int
	FinalTimeout time.Duration

	// Logger, when set, receives leveled log output: DEBUG for every
	// datagram and per-block DATA/ACK detail, INFO for each transfer
	// started or finished, WARN for a request refused or a transfer a
	// client stopped acking, ERROR for this side failing to read or
	// send. A nil Logger is silent.
	Logger *logging.Logger

	// Recorder, when set, receives a tftp_transfer_end record for each
	// completed or abandoned transfer. A nil Recorder is a no-op.
	Recorder *capture.Recorder

	// ClientName, when set, maps a client IP to its configured alias for
	// the recorded transfer. Nil, or a miss, records the IP.
	ClientName func(netip.Addr) string
	// contains filtered or unexported fields
}