diff options
author | Matthew Heon <mheon@redhat.com> | 2020-02-06 13:19:50 -0500 |
---|---|---|
committer | Matthew Heon <mheon@redhat.com> | 2020-02-06 13:41:57 -0500 |
commit | 41b735af053b85aeacc65e45d068246cad789cd7 (patch) | |
tree | 505c334ba4cda39f63a378e5209df25c41b6c05a /docs/source/markdown/podman-system-service.1.md | |
parent | 62111bceb7dab4fc51760b86f762df3716f296fc (diff) | |
download | podman-41b735af053b85aeacc65e45d068246cad789cd7.tar.gz podman-41b735af053b85aeacc65e45d068246cad789cd7.tar.bz2 podman-41b735af053b85aeacc65e45d068246cad789cd7.zip |
Move podman-service to podman-system-service
Fixes #5108
Signed-off-by: Matthew Heon <mheon@redhat.com>
Diffstat (limited to 'docs/source/markdown/podman-system-service.1.md')
-rw-r--r-- | docs/source/markdown/podman-system-service.1.md | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-system-service.1.md b/docs/source/markdown/podman-system-service.1.md new file mode 100644 index 000000000..a71ce9dc0 --- /dev/null +++ b/docs/source/markdown/podman-system-service.1.md @@ -0,0 +1,47 @@ +% podman-service(1) + +## NAME +podman\-system\-service - Run an API service + +## SYNOPSIS +**podman system service** [*options*] + +## DESCRIPTION +The **podman system service** command creates a listening service that will answer API calls for Podman. You may +optionally provide an endpoint for the API in URI form. For example, *unix://tmp/foobar.sock* or *tcp:localhost:8080*. +If no endpoint is provided, defaults will be used. The default endpoint for a rootfull +service is *unix:/run/podman/podman.sock* and rootless is *unix:/$XDG_RUNTIME_DIR/podman/podman.sock* (for +example *unix:/run/user/1000/podman/podman.sock*) + +## OPTIONS + +**--timeout**, **-t** + +The time until the session expires in _milliseconds_. The default is 1 +second. A value of `0` means no timeout and the session will not expire. + +**--varlink** + +Use the varlink protocol instead of the REST-based protocol. This option will be deprecated in the future. + +**--help**, **-h** + +Print usage statement. + +## EXAMPLES + +Run an API listening for 5 seconds using the default socket. +``` +podman service --timeout 5000 +``` + +Run the podman varlink service with an alternate URI and accept the default timeout. +``` +$ podman service --varlink unix:/tmp/io.podman +``` + +## SEE ALSO +podman(1), podman-varlink(1) + +## HISTORY +January 2020, Originally compiled by Brent Baude<bbaude@redhat.com> |