≡ Menu

What are the exit statuses of ssh command?

What are the exit statuses of ssh command on a Linux or Unix like system when you run ‘ssh host command‘?

SSH client is a program for logging into a remote machine and for executing commands on a remote machine. By default in Linux/UNIX if particular command/shell script is executed, it return two type of values which is used to see whether command or shell script executed is successful or not. This value is know as Exit Status of shell command or script.

The session terminates when the command or shell on the remote machine exits and all X11 and TCP/IP connections have been closed. The exit status of the remote program is returned as the exit status of ssh. You can use bash shell $? Variable to print exit status of shell. For example:
user@localhost: $ ssh user@somewhere.com

user@somewhere.com: $  exit
user@localhost: $ echo $?

In short,

  1. ssh exits with the exit status of the remote command which can be find with echo $? command.
  2. Or value 255 is return, if an error occurred while processing request via ssh session
Share this tutorial on:

Your support makes a big difference:
I have a small favor to ask. More people are reading the nixCraft. Many of you block advertising which is your right, and advertising revenues are not sufficient to cover my operating costs. So you can see why I need to ask for your help. The nixCraft, takes a lot of my time and hard work to produce. If you use nixCraft, who likes it, helps me with donations:
Become a Supporter →    Make a contribution via Paypal/Bitcoin →   

Don't Miss Any Linux and Unix Tips

Get nixCraft in your inbox. It's free:

{ 4 comments… add one }
  • Rusty January 30, 2009, 5:21 pm

    Very well, but what ARE the exit stati of the ssh command?
    e.g, 0 if succesful? Or, 1?

  • wyrmmage July 16, 2009, 12:02 am

    Seeing as this is the top hit for googling “ssh return status”, I thought I’d go ahead and add that

    The remote command may also terminate violently due to a signal.
    Such a condition can be indicated by the following message. A zero
    ‘exit_status’ usually means that the command terminated successfully.
    uint32 recipient channel
    string “exit-signal”
    boolean FALSE
    string signal name (without the “SIG” prefix)
    boolean core dumped
    string error message in ISO-10646 UTF-8 encoding
    string language tag [RFC3066]

    So you don’t *always* get the return status of your program.

    Good post, though….it answered my question :)

  • Whatever September 16, 2011, 12:02 pm

    My SSH version returns 0 for okay, and 255 if connection failed.

  • josh June 15, 2012, 9:23 am

    if you looking for a way to return failure from a remote bash script, try:

    kill $$

    this causes bash to kill itself ($$ evaluates to bash’s pid) and ssh to return 255.

Security: Are you a robot or human?

Leave a Comment

You can use these HTML tags and attributes: <strong> <em> <pre> <code> <a href="" title="">

   Tagged with: