Pim van Pelt
35643fd774
Rename the web dashboard binary to maglevd-frontend and move it to /usr/sbin (it's a daemon and belongs with maglevd). The systemd unit name stays vpp-maglev-frontend.service since that prefix is the package name. Manpage, README, user-guide, and debian packaging all updated in lockstep; bump to 0.9.1 for the first real release. All frontend env vars are now prefixed MAGLEV_FRONTEND_ so a single /etc/default/vpp-maglev can be shared with maglevd without collisions. Every flag has an env equivalent for Docker use. MAGLEV_FRONTEND_USER and MAGLEV_FRONTEND_PASSWORD still gate the /admin surface. VPPInfoPanel now pulses "API: ↑↓" indicators in the zippy title whenever a vpp-api-send / vpp-api-recv log event arrives on the SSE stream for the scoped maglevd — 250ms blue flash, re-triggerable, with the two arrows tightly kerned via negative letter-spacing.
98 lines
2.4 KiB
Groff
98 lines
2.4 KiB
Groff
.TH MAGLEVC 1 "April 2026" "vpp\-maglev" "User Commands"
|
|
.SH NAME
|
|
maglevc \- Maglev health\-checker CLI client
|
|
.SH SYNOPSIS
|
|
.B maglevc
|
|
[\fB\-server\fR \fIaddr\fR]
|
|
[\fB\-color\fR[=\fIbool\fR]]
|
|
[\fIcommand\fR [\fIargs\fR...]]
|
|
.SH DESCRIPTION
|
|
.B maglevc
|
|
is an interactive CLI client for
|
|
.BR maglevd (8).
|
|
Without arguments it opens a readline shell with tab completion and
|
|
inline help.
|
|
A command may also be passed directly on the command line for one\-shot
|
|
use, which is useful for scripting; in that mode ANSI color is
|
|
disabled by default so the output is script\-safe. Pass
|
|
.B \-color=true
|
|
explicitly if you want color in one\-shot mode.
|
|
.PP
|
|
When the shell starts it prints the build version and connects to the
|
|
.B maglevd
|
|
gRPC server specified by
|
|
.BR \-server .
|
|
All static tokens support tab completion; dynamic names (frontend,
|
|
backend, health\-check names) are completed by querying the server.
|
|
Type
|
|
.B ?
|
|
at any point to list completions without advancing the input.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI \-server " addr"
|
|
Address of the
|
|
.B maglevd
|
|
gRPC server.
|
|
(default:
|
|
.IR localhost:9090 )
|
|
.TP
|
|
.BR \-color [=\fIbool\fR]
|
|
Colorize static field labels in output using ANSI dark blue. The
|
|
default is mode\-aware: enabled (true) in the interactive shell, and
|
|
disabled (false) in one\-shot mode so that output piped into scripts
|
|
or files stays free of escape codes. Pass
|
|
.B \-color=true
|
|
or
|
|
.B \-color=false
|
|
explicitly to override the default for either mode.
|
|
.SH EXAMPLES
|
|
Open the interactive shell (no command on the command line). Tab
|
|
completes the current token; typing
|
|
.B ?
|
|
lists candidates at the cursor.
|
|
.B quit
|
|
or
|
|
.B exit
|
|
(or Ctrl\-D) leaves the shell:
|
|
.PP
|
|
.RS
|
|
.EX
|
|
$ maglevc
|
|
maglevc> show frontends
|
|
\&...
|
|
maglevc> quit
|
|
.EE
|
|
.RE
|
|
.PP
|
|
One\-shot query passed on the command line (color is off by default
|
|
in this mode so the output is script\-safe):
|
|
.PP
|
|
.RS
|
|
.EX
|
|
$ maglevc show frontends
|
|
.EE
|
|
.RE
|
|
.PP
|
|
Query VPP version and connection status, forcing color on:
|
|
.PP
|
|
.RS
|
|
.EX
|
|
$ maglevc \-color=true show vpp info
|
|
.EE
|
|
.RE
|
|
.SH "FULL DOCUMENTATION"
|
|
This manpage documents only the invocation of
|
|
.BR maglevc .
|
|
For the complete command reference — every
|
|
.BR show ", " set ", " sync ", " config ", and " watch
|
|
command, with examples and operational notes — see the user guide at:
|
|
.PP
|
|
.RS
|
|
https://git.ipng.ch/ipng/vpp-maglev/docs/user-guide.md
|
|
.RE
|
|
.SH SEE ALSO
|
|
.BR maglevd (8),
|
|
.BR maglevd\-frontend (8)
|
|
.SH AUTHOR
|
|
Pim van Pelt <pim@ipng.ch>
|