share/man/man1/disown.1

   1 '\" te
   2 .\" Copyright (c) 1982-2007 AT&T Knowledge Ventures
   3 .\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt
   4 .\" Portions Copyright (c) 2007, Sun Microsystems, Inc.
   5 .TH DISOWN 1 "Apr 18, 2007"
   6 .SH NAME
   7 disown \- ksh93 built-in function to disassociate a job with the current shell
   8 .SH SYNOPSIS
   9 .LP
  10 .nf
  11 \fBdisown\fR [\fIjob ...\fR]
  12 .fi
  13
  14 .SH DESCRIPTION
  15 .sp
  16 .LP
  17 The \fBksh93\fR \fBdisown\fR command prevents the current shell from sending a
  18 \fBHUP\fR signal to each of the specified jobs when the current shell
  19 terminates a login session.
  20 .sp
  21 .LP
  22 If \fIjob\fR is omitted, \fBdisown\fR sends the \fBHUP\fR signal to the most
  23 recently started or stopped background job.
  24 .SH OPERANDS
  25 .sp
  26 .LP
  27 The following operands are supported:
  28 .sp
  29 .ne 2
  30 .na
  31 \fB\fIjob\fR\fR
  32 .ad
  33 .RS 7n
  34 Specifies the job or jobs on which disown operates.
  35 .sp
  36 Specify \fIjob\fR as one of the following:
  37 .sp
  38 .ne 2
  39 .na
  40 \fB\fInumber\fR\fR
  41 .ad
  42 .RS 12n
  43 Refers to a process ID.
  44 .RE
  45
  46 .sp
  47 .ne 2
  48 .na
  49 \fB\fB-\fR\fInumber\fR\fR
  50 .ad
  51 .RS 12n
  52 Refers to a process group ID.
  53 .RE
  54
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB%\fR\fInumber\fR\fR
  59 .ad
  60 .RS 12n
  61 Refers to a job number.
  62 .RE
  63
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fB%\fR\fIstring\fR\fR
  68 .ad
  69 .RS 12n
  70 Refers to a job whose name begins with \fIstring\fR.
  71 .RE
  72
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB%?\fR\fIstring\fR\fR
  77 .ad
  78 .RS 12n
  79 Refers to a job whose name contains \fIstring\fR.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB%+\fR or \fB%%\fR\fR
  86 .ad
  87 .RS 12n
  88 Refers to the current job.
  89 .RE
  90
  91 .sp
  92 .ne 2
  93 .na
  94 \fB\fB%-\fR\fR
  95 .ad
  96 .RS 12n
  97 Refers to the previous job.
  98 .RE
  99
 100 .RE
 101
 102 .SH EXIT STATUS
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fB0\fR\fR
 107 .ad
 108 .RS 6n
 109 Successful completion.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fB>0\fR\fR
 116 .ad
 117 .RS 6n
 118 One or more specified jobs does not exist.
 119 .RE
 120
 121 .SH EXAMPLES
 122 .LP
 123 \fBExample 1 \fRDisowning a Job
 124 .sp
 125 .LP
 126 The following example disowns job 1:
 127
 128 .sp
 129 .in +2
 130 .nf
 131 example% disown %1
 132 .fi
 133 .in -2
 134 .sp
 135
 136 .SH AUTHORS
 137 .sp
 138 .LP
 139 David Korn, \fBdgk@research.att.com\fR
 140 .SH ATTRIBUTES
 141 .sp
 142 .LP
 143 See \fBattributes\fR(5) for descriptions of the following attributes:
 144 .sp
 145
 146 .sp
 147 .TS
 148 box;
 149 c | c
 150 l | l .
 151 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 152 _
 153 Interface Stability     Uncommitted
 154 .TE
 155
 156 .SH SEE ALSO
 157 .sp
 158 .LP
 159 \fBbg\fR(1), \fBjobs\fR(1), \fBksh93\fR(1), \fBwait\fR(1), \fBattributes\fR(5)