services

func Commands ¶

func Commands(con *client.Client) *cobra.Command

Commands returns a command tree to manage and display services.

func CompleteByID ¶

func CompleteByID(con *client.Client) carapace.Action

CompleteByID completes services by their (short) ID, described by host / number / proto / product / state, and colours each candidate by port state (open green, filtered yellow, else dim).

func CompleteByName ¶ added in v0.3.0

func CompleteByName(con *client.Client) carapace.Action

CompleteByName completes services by a real service attribute — their name (falling back to the short ID for the unnamed ones) — described by product/version/protocol. Unlike CompleteByID, which walks hosts and inserts port UUIDs, this reads the services table directly, so the typed word can be pushed down to the server as a prefix filter (ReadServiceRequest.Prefix) and a Tab against a large store transfers only the candidate rows instead of every host with its ports.

When an agent context is loaded, the read is additionally scoped to that agent's host (ReadServiceRequest.Host) — by far the biggest result-set reducer available here, and the right default: the services worth completing while operating from a host are that host's. The candidates are tagged accordingly so the heading says which set is on screen; with no context loaded it falls back to every service in the database.