gio:application-command-line-exit-status (cmdline)

cmdline -- a g:application-command-line instance
status -- an integer with the exit status

Accessor of the exit status of a g:application-command-line instance. The g:application-command-line-exit-status function gets the exit status of cmdline. The (setf g:application-command-line-exit-status) function sets the exit status that will be used when the invoking process exits.

The return value of the "command-line" signal is passed to this function when the handler returns. This is the usual way of setting the exit status.

In the event that you want the remote invocation to continue running and want to decide on the exit status in the future, you can use this call. For the case of a remote invocation, the remote process will typically exit when the last reference is dropped on cmdline. The exit status of the remote process will be equal to the last value that was set with this function.

In the case that the command line invocation is local, the situation is slightly more complicated. If the command line invocation results in the main loop running, that is, because the use-count of the application increased to a non-zero value, then the application is considered to have been 'successful' in a certain sense, and the exit status is always zero. If the application use count is zero, though, the exit status of the local g:application-command-line instance is used.