Copyright (c) 1993 The Regents of the University of California.
Copyright (c) 1994-1996 Sun Microsystems, Inc.

See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.

RCS: @(#) $Id: exit.n,v 1.3.18.1 2004/10/27 09:35:38 dkf Exp $

.so man.macros S Note: do not modify the .SH NAME line immediately below!
exit - End the application exit ?returnCode? E

Terminate the process, returning returnCode to the system as the exit status. If returnCode isn't specified then it defaults to 0.

Since non-zero exit codes are usually interpreted as error cases by the calling process, the exit command is an important part of signalling that something fatal has gone wrong. This code fragment is useful in scripts to act as a general problem trap: .CS proc main {} { # ... put the real main code in here ... } if {[catch {main} msg]} { puts stderr "unexpected script error: $msg" if {[info exist env(DEBUG)]} { puts stderr "---- BEGIN TRACE ----" puts stderr $errorInfo puts stderr "---- END TRACE ----" } # Reserve code 1 for "expected" error exits... exit 2 } .CE exec(n), tclvars(n) exit, process