Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
podman-machine-ssh(1)	     General Commands Manual	   podman-machine-ssh(1)

NAME
     podman-machine-ssh - SSH into a virtual machine

SYNOPSIS
     podman machine ssh [options] [name] [command [arg ...]]

DESCRIPTION
     SSH  into a Podman-managed virtual machine and optionally execute a command
     on the virtual machine. Unless using the default virtual machine, the first
     argument must be the virtual machine name. The optional command to  execute
     can then follow. If no command is provided, an interactive session with the
     virtual machine is established.

     The  exit	code  from  ssh  command  is forwarded to the podman machine ssh
     caller, see Exit Codes <#Exit-Codes>.

     The default machine name is podman-machine-default. If a  machine	name  is
     not  specified  as  an  argument, then podman-machine-default will be SSH'd
     into.

     Rootless only.

OPTIONS
   --help
     Print usage statement.

   --username=name
     Username to use when SSH-ing into the VM.

Exit Codes
     The exit code from podman machine ssh gives information about why the  com-
     mand  failed.   When podman machine ssh commands exit with a non-zero code,
     the exit codes follow the chroot standard, see below:

     125 The error is with podman itself

     $ podman machine ssh --foo; echo $?
     Error: unknown flag: --foo
     125

     126 Executing a contained command and the command cannot be invoked

     $ podman machine ssh /etc; echo $?
     Error: fork/exec /etc: permission denied
     126

     127 Executing a contained command and the command cannot be found

     $ podman machine ssh foo; echo $?
     Error: fork/exec /usr/bin/bogus: no such file or directory
     127

     Exit code contained command exit code

     $ podman machine ssh /bin/sh -c 'exit 3'; echo $?
     3

EXAMPLES
     To get an interactive session with the default Podman machine:

     SSH into the default Podman machine.

     $ podman machine ssh

     Run command inside the default Podman machine via ssh.

     $ podman machine ssh myvm

     Run command inside the specified Podman machine via ssh.

     $ podman machine ssh myvm rpm -q podman

SEE ALSO
     podman(1), podman-machine(1)

HISTORY
     March   2021,   Originally   compiled   by   Ashley   Cui	 acui@redhat.com
     <mailto:acui@redhat.com>

							   podman-machine-ssh(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-machine-ssh&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help