OS Manuals

/usr/bin/varlinkctl

The systemd System and Service Manager

From systemd 262.2-r1 (os), captured 2026-11-05 by running varlinkctl --help (exit 0). permalink

> varlinkctl [OPTION…] COMMAND …

Introspect Varlink Services.

Commands:
  info ADDRESS                      Show service information
  list-interfaces ADDRESS           List interfaces implemented by service
  introspect ADDRESS [INTERFACE…]   Show interface definition
  list-methods ADDRESS [INTERFACE…] List methods implemented by services or specific interfaces
  call ADDRESS METHOD [PARAMS]      Invoke method
  validate-idl [FILE]               Validate interface description
  list-registry                     Show list of services in the service registry
  list-sockets                      List listening Varlink entrypoint sockets
  serve METHOD CMDLINE…             Serve a command via varlink protocol upgrade
  help                              Show this help

Options:
  -h --help                         Show this help
     --version                      Show package version
     --no-ask-password              Do not prompt for password
     --no-pager                     Do not start a pager
     --system                       Enumerate system registry
     --user                         Enumerate user registry
     --more                         Request multiple responses
     --collect                      Collect multiple responses in a JSON array
     --oneway                       Do not request response
     --json=FORMAT                  Generate JSON output (pretty, short, or off)
  -j                                Equivalent to --json=pretty (on TTY) or --json=short (otherwise)
  -q --quiet                        Do not output method reply
     --graceful=ERROR               Treat specified Varlink error as success
     --timeout=SECS                 Maximum time to wait for method call completion
  -E                                Short for --more --timeout=infinity
     --upgrade                      Request protocol upgrade (connection becomes raw bidirectional
                                    pipe on stdin/stdout after reply)
     --exec                         Invoke method and pass response and fds to command
     --push-fd=FD                   Pass the specified fd along with method call

With --exec, specify the command to invoke:
  varlinkctl --exec call ADDRESS METHOD PARAMS -- CMDLINE…

See the varlinkctl(1) man page for details.
Options (18)
OptionDescriptionSource
-h --helpShow this helphelp
--versionShow package versionhelp
--no-ask-passwordDo not prompt for passwordhelp
--no-pagerDo not start a pagerhelp
--systemEnumerate system registryhelp
--userEnumerate user registryhelp
--moreRequest multiple responseshelp
--collectCollect multiple responses in a JSON arrayhelp
--onewayDo not request responsehelp
--json FORMATGenerate JSON output (pretty, short, or off)help
-jEquivalent to --json=pretty (on TTY) or --json=short (otherwise)help
-q --quietDo not output method replyhelp
--graceful ERRORTreat specified Varlink error as successhelp
--timeout SECSMaximum time to wait for method call completionhelp
-EShort for --more --timeout=infinityhelp
--upgradeRequest protocol upgrade (connection becomes raw bidirectional pipe on stdin/stdout after reply)help
--execInvoke method and pass response and fds to commandhelp
--push-fd FDPass the specified fd along with method callhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.