Skip to content

pomme sessions

Manage durable guest terminal sessions.

pomme sessions SUBCOMMAND

List terminal sessions.

pomme sessions list [NAME] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.

This command also accepts the common flags.

Inspect a terminal session.

pomme sessions inspect [NAME] --session ID [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.
Flag Description
--session ID Terminal session ID, as printed by pomme sessions list.

This command also accepts the common flags.

Attach to a terminal session.

pomme sessions attach [NAME] --session ID [--takeover] [--from-start] [--from-offset FROM_OFFSET] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.
Flag Description
--session ID Terminal session ID, as printed by pomme sessions list.
--takeover Replace the current attachment.
--from-start Replay the transcript from byte offset zero.
--from-offset FROM_OFFSET Replay from this exact transcript byte offset.

This command also accepts the common flags.

Read terminal session transcript bytes.

pomme sessions logs [NAME] --session ID [--from-offset FROM_OFFSET] [--follow] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.
Flag Description
--session ID Terminal session ID, as printed by pomme sessions list.
--from-offset FROM_OFFSET Starting transcript byte offset. Default: 0.
--follow Continue until the session exits or is lost.

This command also accepts the common flags.

Terminate a terminal session.

pomme sessions terminate [NAME] --session ID [--force] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.
Flag Description
--session ID Terminal session ID, as printed by pomme sessions list.
-f, --force Send SIGKILL instead of SIGHUP.

This command also accepts the common flags.

Delete an exited or lost terminal session.

pomme sessions delete [NAME] --session ID [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Argument Description
NAME VM name. Uses POMME_VM_NAME when omitted.
Flag Description
--session ID Terminal session ID, as printed by pomme sessions list.

This command also accepts the common flags.


Generated from the help text of pomme 0.1.0 (2cde15f-dirty).