Manual Pages for UNIX Operating System command usage for man goto

User Commands                                             exit(1)



NAME
     exit, return, goto - shell built-in functions to enable  the
     execution  of  the  shell  to advance beyond its sequence of
     steps

SYNOPSIS
  sh
     exit [n]


     return [n]


  csh
     exit [( expr )]


     goto label


  ksh
     *exit [n]


     *return [n]


  ksh93
     +exit [n]


     +return [n]


DESCRIPTION
  sh
     exit causes the calling shell or shell script to  exit  with
     the  exit  status  specified  by n. If n is omitted the exit
     status is that of the last command  executed  (an  EOF  also
     causes the shell to exit.)


     return causes a function  to  exit  with  the  return  value
     specified  by  n. If n is omitted, the return status is that
     of the last command executed.

  csh
     exit causes the calling  shell  or  shell  script  to  exit,
     either  with  the  value  of the status variable or with the
     value specified by the expression expr.





SunOS 5.11           Last change: 2 Nov 2007                    1






User Commands                                             exit(1)



     The goto built-in uses a specified label as a search  string
     amongst  commands.  The  shell  rewinds its input as much as
     possible and searches for a line of the form label: possibly
     preceded  by  space  or  tab characters. Execution continues
     after the indicated line. It is an error to jump to a  label
     that  occurs between a while or for built-in command and its
     corresponding end.

  ksh
     exit causes the calling shell or shell script to  exit  with
     the  exit status specified by n. The value is the least sig-
     nificant 8 bits of the specified status.  If  n  is  omitted
     then  the  exit status is that of the last command executed.
     When exit occurs when executing a  trap,  the  last  command
     refers  to  the  command  that  executed before the trap was
     invoked. An end-of-file also causes the shell to exit except
     for  a  shell which has the ignoreeof option (See set below)
     turned on.


     return causes a shell function or '.' script  to  return  to
     the  invoking  script with the return status specified by n.
     The value is the least significant 8 bits of  the  specified
     status.  If  n  is omitted then the return status is that of
     the last command executed. If return is invoked while not in
     a function or a '.' script, then it is the same as an exit.


     On this man page, ksh(1) commands that are preceded  by  one
     or  two * (asterisks) are treated specially in the following
     ways:

         1.   Variable assignment  lists  preceding  the  command
              remain in effect when the command completes.

         2.   I/O  redirections  are  processed  after   variable
              assignments.

         3.   Errors cause a script that contains them to abort.

         4.   Words, following a command preceded by ** that  are
              in   the  format  of  a  variable  assignment,  are
              expanded with the same rules as a variable  assign-
              ment.  This  means  that tilde substitution is per-
              formed after the = sign and word splitting and file
              name generation are not performed.

  ksh93
     exit is shell special built-in that causes  the  shell  that
     invokes  it  to  exit. Before exiting the shell, if the EXIT
     trap is set, it is invoked.




SunOS 5.11           Last change: 2 Nov 2007                    2






User Commands                                             exit(1)



     If n is specified, it is used to set the exit status.


     return is a shell special built-in that causes the  function
     or  dot script that invokes it to exit. If return is invoked
     outside of a function or dot  script  it  is  equivalent  to
     exit.


     If return is invoked inside  a  function  defined  with  the
     function reserved word syntax, then any EXIT trap set within
     the function is invoked in the context of the caller  before
     the function returns.


     If n is specified, it is used to set the exit status.


     On this manual page, ksh93 commands that are preceded by one
     or  two  +  symbols  are  special  built-in commands and are
     treated specially in the following ways:

         1.   Variable assignment  lists  preceding  the  command
              remain in effect when the command completes.

         2.   I/O  redirections  are  processed  after   variable
              assignments.

         3.   Errors cause a script that contains them to abort.

         4.   They are not valid function names.

         5.   Words following a command preceded by ++  that  are
              in the format of a variable assignment are expanded
              with the same rules as a variable assignment.  This
              means  that  tilde  substitution is performed after
              the = sign and field splitting and file  name  gen-
              eration are not performed.

EXIT STATUS
  ksh93
     If n is specified for exit, the exit  status  is  the  least
     significant  eight  bits  of  the value of n. Otherwise, the
     exit status is the exit status of  preceding  command.  When
     invoked  inside a trap, the preceding command means the com-
     mand that invoked the trap.


     If n is specified for return, the exit status is  the  least
     significant  eight  bits  of  the value of n. Otherwise, the
     exit status is the exit status of preceding command.




SunOS 5.11           Last change: 2 Nov 2007                    3






User Commands                                             exit(1)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     break(1), csh(1), ksh(1), ksh93(1), sh(1), attributes(5)








































SunOS 5.11           Last change: 2 Nov 2007                    4