summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man1/varlinkctl.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man1/varlinkctl.1')
-rw-r--r--upstream/debian-unstable/man1/varlinkctl.142
1 files changed, 33 insertions, 9 deletions
diff --git a/upstream/debian-unstable/man1/varlinkctl.1 b/upstream/debian-unstable/man1/varlinkctl.1
index 61b4aa3c..3dd650e7 100644
--- a/upstream/debian-unstable/man1/varlinkctl.1
+++ b/upstream/debian-unstable/man1/varlinkctl.1
@@ -1,5 +1,5 @@
'\" t
-.TH "VARLINKCTL" "1" "" "systemd 255" "varlinkctl"
+.TH "VARLINKCTL" "1" "" "systemd 256~rc3" "varlinkctl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -29,7 +29,7 @@ varlinkctl \- Introspect with and invoke Varlink services
.HP \w'\fBvarlinkctl\fR\ 'u
\fBvarlinkctl\fR [OPTIONS...] introspect \fIADDRESS\fR \fIINTERFACE\fR
.HP \w'\fBvarlinkctl\fR\ 'u
-\fBvarlinkctl\fR [OPTIONS...] call \fIADDRESS\fR \fIMETHOD\fR [\fIPARAMETERS\fR]
+\fBvarlinkctl\fR [OPTIONS...] call \fIADDRESS\fR \fIMETHOD\fR [\fIARGUMENTS\fR]
.HP \w'\fBvarlinkctl\fR\ 'u
\fBvarlinkctl\fR [OPTIONS...] validate\-idl [\fIFILE\fR]
.SH "DESCRIPTION"
@@ -53,7 +53,7 @@ A Varlink service reference starting with the
"unix:"
string, followed by an absolute
\fBAF_UNIX\fR
-path, or by
+socket path, or by
"@"
and an arbitrary string (the latter for referencing sockets in the abstract namespace)\&.
.RE
@@ -70,6 +70,22 @@ A Varlink service reference starting with the
"exec:"
string, followed by an absolute path of a binary to execute\&.
.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+A Varlink service reference starting with the
+"ssh:"
+string, followed by an SSH host specification, followed by
+":", followed by an absolute
+\fBAF_UNIX\fR
+socket path\&. (This requires OpenSSH 9\&.4 or newer on the server side, abstract namespace sockets are not supported\&.)
+.RE
.PP
For convenience these two simpler (redundant) service address syntaxes are also supported:
.sp
@@ -106,21 +122,21 @@ The following commands are understood:
.PP
\fBinfo\fR \fIADDRESS\fR
.RS 4
-Show brief information about the specified service, including vendor name and list of implemented interfaces\&. Expects a service address in the formats described above\&.
+Show brief information about the specified service, including vendor name and list of implemented interfaces\&. Expects a service address in one of the formats described above\&.
.sp
Added in version 255\&.
.RE
.PP
\fBlist\-interfaces\fR \fIADDRESS\fR
.RS 4
-Show list of interfaces implemented by the specified service\&. Expects a service address in the formats described above\&.
+Show list of interfaces implemented by the specified service\&. Expects a service address in one of the formats described above\&.
.sp
Added in version 255\&.
.RE
.PP
\fBintrospect\fR \fIADDRESS\fR \fIINTERFACE\fR
.RS 4
-Show interface definition of the specified interface provided by the specified service\&. Expects a service address in the formats described above and a Varlink interface name\&.
+Show interface definition of the specified interface provided by the specified service\&. Expects a service address in one of the formats described above and a Varlink interface name\&.
.sp
Added in version 255\&.
.RE
@@ -164,6 +180,15 @@ If this mode is enabled output is automatically switched to JSON\-SEQ mode, so t
Added in version 255\&.
.RE
.PP
+\fB\-\-collect\fR
+.RS 4
+This is similar to
+\fB\-\-more\fR
+but collects all responses in a JSON array, and prints it, rather than in JSON_SEQ mode\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
\fB\-\-oneway\fR
.RS 4
When used with
@@ -174,7 +199,7 @@ flag set (the command exits immediately after), which tells the service not to g
Added in version 255\&.
.RE
.PP
-\fB\-\-json=\fR\fIMODE\fR
+\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
Selects the JSON output formatting, one of
"pretty"
@@ -314,8 +339,7 @@ method Extend(
.\}
.SH "SEE ALSO"
.PP
-\fBbusctl\fR(1),
-\m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2
+\fBbusctl\fR(1), \m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2
.SH "NOTES"
.IP " 1." 4
Varlink