4 * Copyright (C) 1991, 1992 Linus Torvalds
8 #include <linux/slab.h>
9 #include <linux/interrupt.h>
10 #include <linux/module.h>
11 #include <linux/capability.h>
12 #include <linux/completion.h>
13 #include <linux/personality.h>
14 #include <linux/tty.h>
15 #include <linux/iocontext.h>
16 #include <linux/key.h>
17 #include <linux/security.h>
18 #include <linux/cpu.h>
19 #include <linux/acct.h>
20 #include <linux/tsacct_kern.h>
21 #include <linux/file.h>
22 #include <linux/fdtable.h>
23 #include <linux/binfmts.h>
24 #include <linux/nsproxy.h>
25 #include <linux/pid_namespace.h>
26 #include <linux/ptrace.h>
27 #include <linux/profile.h>
28 #include <linux/mount.h>
29 #include <linux/proc_fs.h>
30 #include <linux/kthread.h>
31 #include <linux/mempolicy.h>
32 #include <linux/taskstats_kern.h>
33 #include <linux/delayacct.h>
34 #include <linux/freezer.h>
35 #include <linux/cgroup.h>
36 #include <linux/syscalls.h>
37 #include <linux/signal.h>
38 #include <linux/posix-timers.h>
39 #include <linux/cn_proc.h>
40 #include <linux/mutex.h>
41 #include <linux/futex.h>
42 #include <linux/pipe_fs_i.h>
43 #include <linux/audit.h> /* for audit_free() */
44 #include <linux/resource.h>
45 #include <linux/blkdev.h>
46 #include <linux/task_io_accounting_ops.h>
47 #include <linux/tracehook.h>
48 #include <linux/fs_struct.h>
49 #include <linux/init_task.h>
50 #include <linux/perf_event.h>
51 #include <trace/events/sched.h>
53 #include <asm/uaccess.h>
54 #include <asm/unistd.h>
55 #include <asm/pgtable.h>
56 #include <asm/mmu_context.h>
57 #include "cred-internals.h"
59 static void exit_mm(struct task_struct
* tsk
);
61 static void __unhash_process(struct task_struct
*p
)
64 detach_pid(p
, PIDTYPE_PID
);
65 if (thread_group_leader(p
)) {
66 detach_pid(p
, PIDTYPE_PGID
);
67 detach_pid(p
, PIDTYPE_SID
);
69 list_del_rcu(&p
->tasks
);
70 __get_cpu_var(process_counts
)--;
72 list_del_rcu(&p
->thread_group
);
73 list_del_init(&p
->sibling
);
77 * This function expects the tasklist_lock write-locked.
79 static void __exit_signal(struct task_struct
*tsk
)
81 struct signal_struct
*sig
= tsk
->signal
;
82 struct sighand_struct
*sighand
;
85 BUG_ON(!atomic_read(&sig
->count
));
87 sighand
= rcu_dereference(tsk
->sighand
);
88 spin_lock(&sighand
->siglock
);
90 posix_cpu_timers_exit(tsk
);
91 if (atomic_dec_and_test(&sig
->count
))
92 posix_cpu_timers_exit_group(tsk
);
95 * If there is any task waiting for the group exit
98 if (sig
->group_exit_task
&& atomic_read(&sig
->count
) == sig
->notify_count
)
99 wake_up_process(sig
->group_exit_task
);
101 if (tsk
== sig
->curr_target
)
102 sig
->curr_target
= next_thread(tsk
);
104 * Accumulate here the counters for all threads but the
105 * group leader as they die, so they can be added into
106 * the process-wide totals when those are taken.
107 * The group leader stays around as a zombie as long
108 * as there are other threads. When it gets reaped,
109 * the exit.c code will add its counts into these totals.
110 * We won't ever get here for the group leader, since it
111 * will have been the last reference on the signal_struct.
113 sig
->utime
= cputime_add(sig
->utime
, task_utime(tsk
));
114 sig
->stime
= cputime_add(sig
->stime
, task_stime(tsk
));
115 sig
->gtime
= cputime_add(sig
->gtime
, task_gtime(tsk
));
116 sig
->min_flt
+= tsk
->min_flt
;
117 sig
->maj_flt
+= tsk
->maj_flt
;
118 sig
->nvcsw
+= tsk
->nvcsw
;
119 sig
->nivcsw
+= tsk
->nivcsw
;
120 sig
->inblock
+= task_io_get_inblock(tsk
);
121 sig
->oublock
+= task_io_get_oublock(tsk
);
122 task_io_accounting_add(&sig
->ioac
, &tsk
->ioac
);
123 sig
->sum_sched_runtime
+= tsk
->se
.sum_exec_runtime
;
124 sig
= NULL
; /* Marker for below. */
127 __unhash_process(tsk
);
130 * Do this under ->siglock, we can race with another thread
131 * doing sigqueue_free() if we have SIGQUEUE_PREALLOC signals.
133 flush_sigqueue(&tsk
->pending
);
137 spin_unlock(&sighand
->siglock
);
139 __cleanup_sighand(sighand
);
140 clear_tsk_thread_flag(tsk
,TIF_SIGPENDING
);
142 flush_sigqueue(&sig
->shared_pending
);
143 taskstats_tgid_free(sig
);
145 * Make sure ->signal can't go away under rq->lock,
146 * see account_group_exec_runtime().
148 task_rq_unlock_wait(tsk
);
149 __cleanup_signal(sig
);
153 static void delayed_put_task_struct(struct rcu_head
*rhp
)
155 struct task_struct
*tsk
= container_of(rhp
, struct task_struct
, rcu
);
157 #ifdef CONFIG_PERF_EVENTS
158 WARN_ON_ONCE(tsk
->perf_event_ctxp
);
160 trace_sched_process_free(tsk
);
161 put_task_struct(tsk
);
165 void release_task(struct task_struct
* p
)
167 struct task_struct
*leader
;
170 tracehook_prepare_release_task(p
);
171 /* don't need to get the RCU readlock here - the process is dead and
172 * can't be modifying its own credentials */
173 atomic_dec(&__task_cred(p
)->user
->processes
);
177 write_lock_irq(&tasklist_lock
);
178 tracehook_finish_release_task(p
);
182 * If we are the last non-leader member of the thread
183 * group, and the leader is zombie, then notify the
184 * group leader's parent process. (if it wants notification.)
187 leader
= p
->group_leader
;
188 if (leader
!= p
&& thread_group_empty(leader
) && leader
->exit_state
== EXIT_ZOMBIE
) {
189 BUG_ON(task_detached(leader
));
190 do_notify_parent(leader
, leader
->exit_signal
);
192 * If we were the last child thread and the leader has
193 * exited already, and the leader's parent ignores SIGCHLD,
194 * then we are the one who should release the leader.
196 * do_notify_parent() will have marked it self-reaping in
199 zap_leader
= task_detached(leader
);
202 * This maintains the invariant that release_task()
203 * only runs on a task in EXIT_DEAD, just for sanity.
206 leader
->exit_state
= EXIT_DEAD
;
209 write_unlock_irq(&tasklist_lock
);
211 call_rcu(&p
->rcu
, delayed_put_task_struct
);
214 if (unlikely(zap_leader
))
219 * This checks not only the pgrp, but falls back on the pid if no
220 * satisfactory pgrp is found. I dunno - gdb doesn't work correctly
223 * The caller must hold rcu lock or the tasklist lock.
225 struct pid
*session_of_pgrp(struct pid
*pgrp
)
227 struct task_struct
*p
;
228 struct pid
*sid
= NULL
;
230 p
= pid_task(pgrp
, PIDTYPE_PGID
);
232 p
= pid_task(pgrp
, PIDTYPE_PID
);
234 sid
= task_session(p
);
240 * Determine if a process group is "orphaned", according to the POSIX
241 * definition in 2.2.2.52. Orphaned process groups are not to be affected
242 * by terminal-generated stop signals. Newly orphaned process groups are
243 * to receive a SIGHUP and a SIGCONT.
245 * "I ask you, have you ever known what it is to be an orphan?"
247 static int will_become_orphaned_pgrp(struct pid
*pgrp
, struct task_struct
*ignored_task
)
249 struct task_struct
*p
;
251 do_each_pid_task(pgrp
, PIDTYPE_PGID
, p
) {
252 if ((p
== ignored_task
) ||
253 (p
->exit_state
&& thread_group_empty(p
)) ||
254 is_global_init(p
->real_parent
))
257 if (task_pgrp(p
->real_parent
) != pgrp
&&
258 task_session(p
->real_parent
) == task_session(p
))
260 } while_each_pid_task(pgrp
, PIDTYPE_PGID
, p
);
265 int is_current_pgrp_orphaned(void)
269 read_lock(&tasklist_lock
);
270 retval
= will_become_orphaned_pgrp(task_pgrp(current
), NULL
);
271 read_unlock(&tasklist_lock
);
276 static int has_stopped_jobs(struct pid
*pgrp
)
279 struct task_struct
*p
;
281 do_each_pid_task(pgrp
, PIDTYPE_PGID
, p
) {
282 if (!task_is_stopped(p
))
286 } while_each_pid_task(pgrp
, PIDTYPE_PGID
, p
);
291 * Check to see if any process groups have become orphaned as
292 * a result of our exiting, and if they have any stopped jobs,
293 * send them a SIGHUP and then a SIGCONT. (POSIX 3.2.2.2)
296 kill_orphaned_pgrp(struct task_struct
*tsk
, struct task_struct
*parent
)
298 struct pid
*pgrp
= task_pgrp(tsk
);
299 struct task_struct
*ignored_task
= tsk
;
302 /* exit: our father is in a different pgrp than
303 * we are and we were the only connection outside.
305 parent
= tsk
->real_parent
;
307 /* reparent: our child is in a different pgrp than
308 * we are, and it was the only connection outside.
312 if (task_pgrp(parent
) != pgrp
&&
313 task_session(parent
) == task_session(tsk
) &&
314 will_become_orphaned_pgrp(pgrp
, ignored_task
) &&
315 has_stopped_jobs(pgrp
)) {
316 __kill_pgrp_info(SIGHUP
, SEND_SIG_PRIV
, pgrp
);
317 __kill_pgrp_info(SIGCONT
, SEND_SIG_PRIV
, pgrp
);
322 * reparent_to_kthreadd - Reparent the calling kernel thread to kthreadd
324 * If a kernel thread is launched as a result of a system call, or if
325 * it ever exits, it should generally reparent itself to kthreadd so it
326 * isn't in the way of other processes and is correctly cleaned up on exit.
328 * The various task state such as scheduling policy and priority may have
329 * been inherited from a user process, so we reset them to sane values here.
331 * NOTE that reparent_to_kthreadd() gives the caller full capabilities.
333 static void reparent_to_kthreadd(void)
335 write_lock_irq(&tasklist_lock
);
337 ptrace_unlink(current
);
338 /* Reparent to init */
339 current
->real_parent
= current
->parent
= kthreadd_task
;
340 list_move_tail(¤t
->sibling
, ¤t
->real_parent
->children
);
342 /* Set the exit signal to SIGCHLD so we signal init on exit */
343 current
->exit_signal
= SIGCHLD
;
345 if (task_nice(current
) < 0)
346 set_user_nice(current
, 0);
350 memcpy(current
->signal
->rlim
, init_task
.signal
->rlim
,
351 sizeof(current
->signal
->rlim
));
353 atomic_inc(&init_cred
.usage
);
354 commit_creds(&init_cred
);
355 write_unlock_irq(&tasklist_lock
);
358 void __set_special_pids(struct pid
*pid
)
360 struct task_struct
*curr
= current
->group_leader
;
362 if (task_session(curr
) != pid
) {
363 change_pid(curr
, PIDTYPE_SID
, pid
);
364 proc_sid_connector(curr
);
367 if (task_pgrp(curr
) != pid
)
368 change_pid(curr
, PIDTYPE_PGID
, pid
);
371 static void set_special_pids(struct pid
*pid
)
373 write_lock_irq(&tasklist_lock
);
374 __set_special_pids(pid
);
375 write_unlock_irq(&tasklist_lock
);
379 * Let kernel threads use this to say that they allow a certain signal.
380 * Must not be used if kthread was cloned with CLONE_SIGHAND.
382 int allow_signal(int sig
)
384 if (!valid_signal(sig
) || sig
< 1)
387 spin_lock_irq(¤t
->sighand
->siglock
);
388 /* This is only needed for daemonize()'ed kthreads */
389 sigdelset(¤t
->blocked
, sig
);
391 * Kernel threads handle their own signals. Let the signal code
392 * know it'll be handled, so that they don't get converted to
393 * SIGKILL or just silently dropped.
395 current
->sighand
->action
[(sig
)-1].sa
.sa_handler
= (void __user
*)2;
397 spin_unlock_irq(¤t
->sighand
->siglock
);
401 EXPORT_SYMBOL(allow_signal
);
403 int disallow_signal(int sig
)
405 if (!valid_signal(sig
) || sig
< 1)
408 spin_lock_irq(¤t
->sighand
->siglock
);
409 current
->sighand
->action
[(sig
)-1].sa
.sa_handler
= SIG_IGN
;
411 spin_unlock_irq(¤t
->sighand
->siglock
);
415 EXPORT_SYMBOL(disallow_signal
);
418 * Put all the gunge required to become a kernel thread without
419 * attached user resources in one place where it belongs.
422 void daemonize(const char *name
, ...)
427 va_start(args
, name
);
428 vsnprintf(current
->comm
, sizeof(current
->comm
), name
, args
);
432 * If we were started as result of loading a module, close all of the
433 * user space pages. We don't need them, and if we didn't close them
434 * they would be locked into memory.
438 * We don't want to have TIF_FREEZE set if the system-wide hibernation
439 * or suspend transition begins right now.
441 current
->flags
|= (PF_NOFREEZE
| PF_KTHREAD
);
443 if (current
->nsproxy
!= &init_nsproxy
) {
444 get_nsproxy(&init_nsproxy
);
445 switch_task_namespaces(current
, &init_nsproxy
);
447 set_special_pids(&init_struct_pid
);
448 proc_clear_tty(current
);
450 /* Block and flush all signals */
451 sigfillset(&blocked
);
452 sigprocmask(SIG_BLOCK
, &blocked
, NULL
);
453 flush_signals(current
);
455 /* Become as one with the init task */
457 daemonize_fs_struct();
459 current
->files
= init_task
.files
;
460 atomic_inc(¤t
->files
->count
);
462 reparent_to_kthreadd();
465 EXPORT_SYMBOL(daemonize
);
467 static void close_files(struct files_struct
* files
)
475 * It is safe to dereference the fd table without RCU or
476 * ->file_lock because this is the last reference to the
479 fdt
= files_fdtable(files
);
483 if (i
>= fdt
->max_fds
)
485 set
= fdt
->open_fds
->fds_bits
[j
++];
488 struct file
* file
= xchg(&fdt
->fd
[i
], NULL
);
490 filp_close(file
, files
);
500 struct files_struct
*get_files_struct(struct task_struct
*task
)
502 struct files_struct
*files
;
507 atomic_inc(&files
->count
);
513 void put_files_struct(struct files_struct
*files
)
517 if (atomic_dec_and_test(&files
->count
)) {
520 * Free the fd and fdset arrays if we expanded them.
521 * If the fdtable was embedded, pass files for freeing
522 * at the end of the RCU grace period. Otherwise,
523 * you can free files immediately.
525 fdt
= files_fdtable(files
);
526 if (fdt
!= &files
->fdtab
)
527 kmem_cache_free(files_cachep
, files
);
532 void reset_files_struct(struct files_struct
*files
)
534 struct task_struct
*tsk
= current
;
535 struct files_struct
*old
;
541 put_files_struct(old
);
544 void exit_files(struct task_struct
*tsk
)
546 struct files_struct
* files
= tsk
->files
;
552 put_files_struct(files
);
556 #ifdef CONFIG_MM_OWNER
558 * Task p is exiting and it owned mm, lets find a new owner for it
561 mm_need_new_owner(struct mm_struct
*mm
, struct task_struct
*p
)
564 * If there are other users of the mm and the owner (us) is exiting
565 * we need to find a new owner to take on the responsibility.
567 if (atomic_read(&mm
->mm_users
) <= 1)
574 void mm_update_next_owner(struct mm_struct
*mm
)
576 struct task_struct
*c
, *g
, *p
= current
;
579 if (!mm_need_new_owner(mm
, p
))
582 read_lock(&tasklist_lock
);
584 * Search in the children
586 list_for_each_entry(c
, &p
->children
, sibling
) {
588 goto assign_new_owner
;
592 * Search in the siblings
594 list_for_each_entry(c
, &p
->real_parent
->children
, sibling
) {
596 goto assign_new_owner
;
600 * Search through everything else. We should not get
603 do_each_thread(g
, c
) {
605 goto assign_new_owner
;
606 } while_each_thread(g
, c
);
608 read_unlock(&tasklist_lock
);
610 * We found no owner yet mm_users > 1: this implies that we are
611 * most likely racing with swapoff (try_to_unuse()) or /proc or
612 * ptrace or page migration (get_task_mm()). Mark owner as NULL.
621 * The task_lock protects c->mm from changing.
622 * We always want mm->owner->mm == mm
626 * Delay read_unlock() till we have the task_lock()
627 * to ensure that c does not slip away underneath us
629 read_unlock(&tasklist_lock
);
639 #endif /* CONFIG_MM_OWNER */
642 * Turn us into a lazy TLB process if we
645 static void exit_mm(struct task_struct
* tsk
)
647 struct mm_struct
*mm
= tsk
->mm
;
648 struct core_state
*core_state
;
654 * Serialize with any possible pending coredump.
655 * We must hold mmap_sem around checking core_state
656 * and clearing tsk->mm. The core-inducing thread
657 * will increment ->nr_threads for each thread in the
658 * group with ->mm != NULL.
660 down_read(&mm
->mmap_sem
);
661 core_state
= mm
->core_state
;
663 struct core_thread self
;
664 up_read(&mm
->mmap_sem
);
667 self
.next
= xchg(&core_state
->dumper
.next
, &self
);
669 * Implies mb(), the result of xchg() must be visible
670 * to core_state->dumper.
672 if (atomic_dec_and_test(&core_state
->nr_threads
))
673 complete(&core_state
->startup
);
676 set_task_state(tsk
, TASK_UNINTERRUPTIBLE
);
677 if (!self
.task
) /* see coredump_finish() */
681 __set_task_state(tsk
, TASK_RUNNING
);
682 down_read(&mm
->mmap_sem
);
684 atomic_inc(&mm
->mm_count
);
685 BUG_ON(mm
!= tsk
->active_mm
);
686 /* more a memory barrier than a real lock */
689 up_read(&mm
->mmap_sem
);
690 enter_lazy_tlb(mm
, current
);
691 /* We don't want this task to be frozen prematurely */
692 clear_freeze_flag(tsk
);
694 mm_update_next_owner(mm
);
699 * When we die, we re-parent all our children.
700 * Try to give them to another thread in our thread
701 * group, and if no such member exists, give it to
702 * the child reaper process (ie "init") in our pid
705 static struct task_struct
*find_new_reaper(struct task_struct
*father
)
707 struct pid_namespace
*pid_ns
= task_active_pid_ns(father
);
708 struct task_struct
*thread
;
711 while_each_thread(father
, thread
) {
712 if (thread
->flags
& PF_EXITING
)
714 if (unlikely(pid_ns
->child_reaper
== father
))
715 pid_ns
->child_reaper
= thread
;
719 if (unlikely(pid_ns
->child_reaper
== father
)) {
720 write_unlock_irq(&tasklist_lock
);
721 if (unlikely(pid_ns
== &init_pid_ns
))
722 panic("Attempted to kill init!");
724 zap_pid_ns_processes(pid_ns
);
725 write_lock_irq(&tasklist_lock
);
727 * We can not clear ->child_reaper or leave it alone.
728 * There may by stealth EXIT_DEAD tasks on ->children,
729 * forget_original_parent() must move them somewhere.
731 pid_ns
->child_reaper
= init_pid_ns
.child_reaper
;
734 return pid_ns
->child_reaper
;
738 * Any that need to be release_task'd are put on the @dead list.
740 static void reparent_thread(struct task_struct
*father
, struct task_struct
*p
,
741 struct list_head
*dead
)
743 if (p
->pdeath_signal
)
744 group_send_sig_info(p
->pdeath_signal
, SEND_SIG_NOINFO
, p
);
746 list_move_tail(&p
->sibling
, &p
->real_parent
->children
);
748 if (task_detached(p
))
751 * If this is a threaded reparent there is no need to
752 * notify anyone anything has happened.
754 if (same_thread_group(p
->real_parent
, father
))
757 /* We don't want people slaying init. */
758 p
->exit_signal
= SIGCHLD
;
760 /* If it has exited notify the new parent about this child's death. */
761 if (!task_ptrace(p
) &&
762 p
->exit_state
== EXIT_ZOMBIE
&& thread_group_empty(p
)) {
763 do_notify_parent(p
, p
->exit_signal
);
764 if (task_detached(p
)) {
765 p
->exit_state
= EXIT_DEAD
;
766 list_move_tail(&p
->sibling
, dead
);
770 kill_orphaned_pgrp(p
, father
);
773 static void forget_original_parent(struct task_struct
*father
)
775 struct task_struct
*p
, *n
, *reaper
;
776 LIST_HEAD(dead_children
);
780 write_lock_irq(&tasklist_lock
);
781 reaper
= find_new_reaper(father
);
783 list_for_each_entry_safe(p
, n
, &father
->children
, sibling
) {
784 p
->real_parent
= reaper
;
785 if (p
->parent
== father
) {
786 BUG_ON(task_ptrace(p
));
787 p
->parent
= p
->real_parent
;
789 reparent_thread(father
, p
, &dead_children
);
791 write_unlock_irq(&tasklist_lock
);
793 BUG_ON(!list_empty(&father
->children
));
795 list_for_each_entry_safe(p
, n
, &dead_children
, sibling
) {
796 list_del_init(&p
->sibling
);
802 * Send signals to all our closest relatives so that they know
803 * to properly mourn us..
805 static void exit_notify(struct task_struct
*tsk
, int group_dead
)
811 * This does two things:
813 * A. Make init inherit all the child processes
814 * B. Check to see if any process groups have become orphaned
815 * as a result of our exiting, and if they have any stopped
816 * jobs, send them a SIGHUP and then a SIGCONT. (POSIX 3.2.2.2)
818 forget_original_parent(tsk
);
819 exit_task_namespaces(tsk
);
821 write_lock_irq(&tasklist_lock
);
823 kill_orphaned_pgrp(tsk
->group_leader
, NULL
);
825 /* Let father know we died
827 * Thread signals are configurable, but you aren't going to use
828 * that to send signals to arbitary processes.
829 * That stops right now.
831 * If the parent exec id doesn't match the exec id we saved
832 * when we started then we know the parent has changed security
835 * If our self_exec id doesn't match our parent_exec_id then
836 * we have changed execution domain as these two values started
837 * the same after a fork.
839 if (tsk
->exit_signal
!= SIGCHLD
&& !task_detached(tsk
) &&
840 (tsk
->parent_exec_id
!= tsk
->real_parent
->self_exec_id
||
841 tsk
->self_exec_id
!= tsk
->parent_exec_id
))
842 tsk
->exit_signal
= SIGCHLD
;
844 signal
= tracehook_notify_death(tsk
, &cookie
, group_dead
);
846 signal
= do_notify_parent(tsk
, signal
);
848 tsk
->exit_state
= signal
== DEATH_REAP
? EXIT_DEAD
: EXIT_ZOMBIE
;
850 /* mt-exec, de_thread() is waiting for us */
851 if (thread_group_leader(tsk
) &&
852 tsk
->signal
->group_exit_task
&&
853 tsk
->signal
->notify_count
< 0)
854 wake_up_process(tsk
->signal
->group_exit_task
);
856 write_unlock_irq(&tasklist_lock
);
858 tracehook_report_death(tsk
, signal
, cookie
, group_dead
);
860 /* If the process is dead, release it - nobody will wait for it */
861 if (signal
== DEATH_REAP
)
865 #ifdef CONFIG_DEBUG_STACK_USAGE
866 static void check_stack_usage(void)
868 static DEFINE_SPINLOCK(low_water_lock
);
869 static int lowest_to_date
= THREAD_SIZE
;
872 free
= stack_not_used(current
);
874 if (free
>= lowest_to_date
)
877 spin_lock(&low_water_lock
);
878 if (free
< lowest_to_date
) {
879 printk(KERN_WARNING
"%s used greatest stack depth: %lu bytes "
881 current
->comm
, free
);
882 lowest_to_date
= free
;
884 spin_unlock(&low_water_lock
);
887 static inline void check_stack_usage(void) {}
890 NORET_TYPE
void do_exit(long code
)
892 struct task_struct
*tsk
= current
;
895 profile_task_exit(tsk
);
897 WARN_ON(atomic_read(&tsk
->fs_excl
));
899 if (unlikely(in_interrupt()))
900 panic("Aiee, killing interrupt handler!");
901 if (unlikely(!tsk
->pid
))
902 panic("Attempted to kill the idle task!");
904 tracehook_report_exit(&code
);
906 validate_creds_for_do_exit(tsk
);
909 * We're taking recursive faults here in do_exit. Safest is to just
910 * leave this task alone and wait for reboot.
912 if (unlikely(tsk
->flags
& PF_EXITING
)) {
914 "Fixing recursive fault but reboot is needed!\n");
916 * We can do this unlocked here. The futex code uses
917 * this flag just to verify whether the pi state
918 * cleanup has been done or not. In the worst case it
919 * loops once more. We pretend that the cleanup was
920 * done as there is no way to return. Either the
921 * OWNER_DIED bit is set by now or we push the blocked
922 * task into the wait for ever nirwana as well.
924 tsk
->flags
|= PF_EXITPIDONE
;
925 set_current_state(TASK_UNINTERRUPTIBLE
);
931 exit_signals(tsk
); /* sets PF_EXITING */
933 * tsk->flags are checked in the futex code to protect against
934 * an exiting task cleaning up the robust pi futexes.
937 spin_unlock_wait(&tsk
->pi_lock
);
939 if (unlikely(in_atomic()))
940 printk(KERN_INFO
"note: %s[%d] exited with preempt_count %d\n",
941 current
->comm
, task_pid_nr(current
),
944 acct_update_integrals(tsk
);
946 group_dead
= atomic_dec_and_test(&tsk
->signal
->live
);
948 hrtimer_cancel(&tsk
->signal
->real_timer
);
949 exit_itimers(tsk
->signal
);
951 setmax_mm_hiwater_rss(&tsk
->signal
->maxrss
, tsk
->mm
);
953 acct_collect(code
, group_dead
);
956 if (unlikely(tsk
->audit_context
))
959 tsk
->exit_code
= code
;
960 taskstats_exit(tsk
, group_dead
);
966 trace_sched_process_exit(tsk
);
975 if (group_dead
&& tsk
->signal
->leader
)
976 disassociate_ctty(1);
978 module_put(task_thread_info(tsk
)->exec_domain
->module
);
980 module_put(tsk
->binfmt
->module
);
982 proc_exit_connector(tsk
);
985 * Flush inherited counters to the parent - before the parent
986 * gets woken up by child-exit notifications.
988 perf_event_exit_task(tsk
);
990 exit_notify(tsk
, group_dead
);
992 mpol_put(tsk
->mempolicy
);
993 tsk
->mempolicy
= NULL
;
996 if (unlikely(!list_empty(&tsk
->pi_state_list
)))
997 exit_pi_state_list(tsk
);
998 if (unlikely(current
->pi_state_cache
))
999 kfree(current
->pi_state_cache
);
1002 * Make sure we are holding no locks:
1004 debug_check_no_locks_held(tsk
);
1006 * We can do this unlocked here. The futex code uses this flag
1007 * just to verify whether the pi state cleanup has been done
1008 * or not. In the worst case it loops once more.
1010 tsk
->flags
|= PF_EXITPIDONE
;
1012 if (tsk
->io_context
)
1015 if (tsk
->splice_pipe
)
1016 __free_pipe_info(tsk
->splice_pipe
);
1018 validate_creds_for_do_exit(tsk
);
1022 /* causes final put_task_struct in finish_task_switch(). */
1023 tsk
->state
= TASK_DEAD
;
1026 /* Avoid "noreturn function does return". */
1028 cpu_relax(); /* For when BUG is null */
1031 EXPORT_SYMBOL_GPL(do_exit
);
1033 NORET_TYPE
void complete_and_exit(struct completion
*comp
, long code
)
1041 EXPORT_SYMBOL(complete_and_exit
);
1043 SYSCALL_DEFINE1(exit
, int, error_code
)
1045 do_exit((error_code
&0xff)<<8);
1049 * Take down every thread in the group. This is called by fatal signals
1050 * as well as by sys_exit_group (below).
1053 do_group_exit(int exit_code
)
1055 struct signal_struct
*sig
= current
->signal
;
1057 BUG_ON(exit_code
& 0x80); /* core dumps don't get here */
1059 if (signal_group_exit(sig
))
1060 exit_code
= sig
->group_exit_code
;
1061 else if (!thread_group_empty(current
)) {
1062 struct sighand_struct
*const sighand
= current
->sighand
;
1063 spin_lock_irq(&sighand
->siglock
);
1064 if (signal_group_exit(sig
))
1065 /* Another thread got here before we took the lock. */
1066 exit_code
= sig
->group_exit_code
;
1068 sig
->group_exit_code
= exit_code
;
1069 sig
->flags
= SIGNAL_GROUP_EXIT
;
1070 zap_other_threads(current
);
1072 spin_unlock_irq(&sighand
->siglock
);
1080 * this kills every thread in the thread group. Note that any externally
1081 * wait4()-ing process will get the correct exit code - even if this
1082 * thread is not the thread group leader.
1084 SYSCALL_DEFINE1(exit_group
, int, error_code
)
1086 do_group_exit((error_code
& 0xff) << 8);
1092 enum pid_type wo_type
;
1096 struct siginfo __user
*wo_info
;
1097 int __user
*wo_stat
;
1098 struct rusage __user
*wo_rusage
;
1103 static struct pid
*task_pid_type(struct task_struct
*task
, enum pid_type type
)
1105 struct pid
*pid
= NULL
;
1106 if (type
== PIDTYPE_PID
)
1107 pid
= task
->pids
[type
].pid
;
1108 else if (type
< PIDTYPE_MAX
)
1109 pid
= task
->group_leader
->pids
[type
].pid
;
1113 static int eligible_child(struct wait_opts
*wo
, struct task_struct
*p
)
1115 if (wo
->wo_type
< PIDTYPE_MAX
) {
1116 if (task_pid_type(p
, wo
->wo_type
) != wo
->wo_pid
)
1120 /* Wait for all children (clone and not) if __WALL is set;
1121 * otherwise, wait for clone children *only* if __WCLONE is
1122 * set; otherwise, wait for non-clone children *only*. (Note:
1123 * A "clone" child here is one that reports to its parent
1124 * using a signal other than SIGCHLD.) */
1125 if (((p
->exit_signal
!= SIGCHLD
) ^ !!(wo
->wo_flags
& __WCLONE
))
1126 && !(wo
->wo_flags
& __WALL
))
1132 static int wait_noreap_copyout(struct wait_opts
*wo
, struct task_struct
*p
,
1133 pid_t pid
, uid_t uid
, int why
, int status
)
1135 struct siginfo __user
*infop
;
1136 int retval
= wo
->wo_rusage
1137 ? getrusage(p
, RUSAGE_BOTH
, wo
->wo_rusage
) : 0;
1140 infop
= wo
->wo_info
;
1142 retval
= put_user(SIGCHLD
, &infop
->si_signo
);
1144 retval
= put_user(0, &infop
->si_errno
);
1146 retval
= put_user((short)why
, &infop
->si_code
);
1148 retval
= put_user(pid
, &infop
->si_pid
);
1150 retval
= put_user(uid
, &infop
->si_uid
);
1152 retval
= put_user(status
, &infop
->si_status
);
1159 * Handle sys_wait4 work for one task in state EXIT_ZOMBIE. We hold
1160 * read_lock(&tasklist_lock) on entry. If we return zero, we still hold
1161 * the lock and this task is uninteresting. If we return nonzero, we have
1162 * released the lock and the system call should return.
1164 static int wait_task_zombie(struct wait_opts
*wo
, struct task_struct
*p
)
1166 unsigned long state
;
1167 int retval
, status
, traced
;
1168 pid_t pid
= task_pid_vnr(p
);
1169 uid_t uid
= __task_cred(p
)->uid
;
1170 struct siginfo __user
*infop
;
1172 if (!likely(wo
->wo_flags
& WEXITED
))
1175 if (unlikely(wo
->wo_flags
& WNOWAIT
)) {
1176 int exit_code
= p
->exit_code
;
1180 read_unlock(&tasklist_lock
);
1181 if ((exit_code
& 0x7f) == 0) {
1183 status
= exit_code
>> 8;
1185 why
= (exit_code
& 0x80) ? CLD_DUMPED
: CLD_KILLED
;
1186 status
= exit_code
& 0x7f;
1188 return wait_noreap_copyout(wo
, p
, pid
, uid
, why
, status
);
1192 * Try to move the task's state to DEAD
1193 * only one thread is allowed to do this:
1195 state
= xchg(&p
->exit_state
, EXIT_DEAD
);
1196 if (state
!= EXIT_ZOMBIE
) {
1197 BUG_ON(state
!= EXIT_DEAD
);
1201 traced
= ptrace_reparented(p
);
1203 * It can be ptraced but not reparented, check
1204 * !task_detached() to filter out sub-threads.
1206 if (likely(!traced
) && likely(!task_detached(p
))) {
1207 struct signal_struct
*psig
;
1208 struct signal_struct
*sig
;
1209 unsigned long maxrss
;
1212 * The resource counters for the group leader are in its
1213 * own task_struct. Those for dead threads in the group
1214 * are in its signal_struct, as are those for the child
1215 * processes it has previously reaped. All these
1216 * accumulate in the parent's signal_struct c* fields.
1218 * We don't bother to take a lock here to protect these
1219 * p->signal fields, because they are only touched by
1220 * __exit_signal, which runs with tasklist_lock
1221 * write-locked anyway, and so is excluded here. We do
1222 * need to protect the access to parent->signal fields,
1223 * as other threads in the parent group can be right
1224 * here reaping other children at the same time.
1226 spin_lock_irq(&p
->real_parent
->sighand
->siglock
);
1227 psig
= p
->real_parent
->signal
;
1230 cputime_add(psig
->cutime
,
1231 cputime_add(p
->utime
,
1232 cputime_add(sig
->utime
,
1235 cputime_add(psig
->cstime
,
1236 cputime_add(p
->stime
,
1237 cputime_add(sig
->stime
,
1240 cputime_add(psig
->cgtime
,
1241 cputime_add(p
->gtime
,
1242 cputime_add(sig
->gtime
,
1245 p
->min_flt
+ sig
->min_flt
+ sig
->cmin_flt
;
1247 p
->maj_flt
+ sig
->maj_flt
+ sig
->cmaj_flt
;
1249 p
->nvcsw
+ sig
->nvcsw
+ sig
->cnvcsw
;
1251 p
->nivcsw
+ sig
->nivcsw
+ sig
->cnivcsw
;
1253 task_io_get_inblock(p
) +
1254 sig
->inblock
+ sig
->cinblock
;
1256 task_io_get_oublock(p
) +
1257 sig
->oublock
+ sig
->coublock
;
1258 maxrss
= max(sig
->maxrss
, sig
->cmaxrss
);
1259 if (psig
->cmaxrss
< maxrss
)
1260 psig
->cmaxrss
= maxrss
;
1261 task_io_accounting_add(&psig
->ioac
, &p
->ioac
);
1262 task_io_accounting_add(&psig
->ioac
, &sig
->ioac
);
1263 spin_unlock_irq(&p
->real_parent
->sighand
->siglock
);
1267 * Now we are sure this task is interesting, and no other
1268 * thread can reap it because we set its state to EXIT_DEAD.
1270 read_unlock(&tasklist_lock
);
1272 retval
= wo
->wo_rusage
1273 ? getrusage(p
, RUSAGE_BOTH
, wo
->wo_rusage
) : 0;
1274 status
= (p
->signal
->flags
& SIGNAL_GROUP_EXIT
)
1275 ? p
->signal
->group_exit_code
: p
->exit_code
;
1276 if (!retval
&& wo
->wo_stat
)
1277 retval
= put_user(status
, wo
->wo_stat
);
1279 infop
= wo
->wo_info
;
1280 if (!retval
&& infop
)
1281 retval
= put_user(SIGCHLD
, &infop
->si_signo
);
1282 if (!retval
&& infop
)
1283 retval
= put_user(0, &infop
->si_errno
);
1284 if (!retval
&& infop
) {
1287 if ((status
& 0x7f) == 0) {
1291 why
= (status
& 0x80) ? CLD_DUMPED
: CLD_KILLED
;
1294 retval
= put_user((short)why
, &infop
->si_code
);
1296 retval
= put_user(status
, &infop
->si_status
);
1298 if (!retval
&& infop
)
1299 retval
= put_user(pid
, &infop
->si_pid
);
1300 if (!retval
&& infop
)
1301 retval
= put_user(uid
, &infop
->si_uid
);
1306 write_lock_irq(&tasklist_lock
);
1307 /* We dropped tasklist, ptracer could die and untrace */
1310 * If this is not a detached task, notify the parent.
1311 * If it's still not detached after that, don't release
1314 if (!task_detached(p
)) {
1315 do_notify_parent(p
, p
->exit_signal
);
1316 if (!task_detached(p
)) {
1317 p
->exit_state
= EXIT_ZOMBIE
;
1321 write_unlock_irq(&tasklist_lock
);
1329 static int *task_stopped_code(struct task_struct
*p
, bool ptrace
)
1332 if (task_is_stopped_or_traced(p
))
1333 return &p
->exit_code
;
1335 if (p
->signal
->flags
& SIGNAL_STOP_STOPPED
)
1336 return &p
->signal
->group_exit_code
;
1342 * Handle sys_wait4 work for one task in state TASK_STOPPED. We hold
1343 * read_lock(&tasklist_lock) on entry. If we return zero, we still hold
1344 * the lock and this task is uninteresting. If we return nonzero, we have
1345 * released the lock and the system call should return.
1347 static int wait_task_stopped(struct wait_opts
*wo
,
1348 int ptrace
, struct task_struct
*p
)
1350 struct siginfo __user
*infop
;
1351 int retval
, exit_code
, *p_code
, why
;
1352 uid_t uid
= 0; /* unneeded, required by compiler */
1356 * Traditionally we see ptrace'd stopped tasks regardless of options.
1358 if (!ptrace
&& !(wo
->wo_flags
& WUNTRACED
))
1362 spin_lock_irq(&p
->sighand
->siglock
);
1364 p_code
= task_stopped_code(p
, ptrace
);
1365 if (unlikely(!p_code
))
1368 exit_code
= *p_code
;
1372 if (!unlikely(wo
->wo_flags
& WNOWAIT
))
1375 /* don't need the RCU readlock here as we're holding a spinlock */
1376 uid
= __task_cred(p
)->uid
;
1378 spin_unlock_irq(&p
->sighand
->siglock
);
1383 * Now we are pretty sure this task is interesting.
1384 * Make sure it doesn't get reaped out from under us while we
1385 * give up the lock and then examine it below. We don't want to
1386 * keep holding onto the tasklist_lock while we call getrusage and
1387 * possibly take page faults for user memory.
1390 pid
= task_pid_vnr(p
);
1391 why
= ptrace
? CLD_TRAPPED
: CLD_STOPPED
;
1392 read_unlock(&tasklist_lock
);
1394 if (unlikely(wo
->wo_flags
& WNOWAIT
))
1395 return wait_noreap_copyout(wo
, p
, pid
, uid
, why
, exit_code
);
1397 retval
= wo
->wo_rusage
1398 ? getrusage(p
, RUSAGE_BOTH
, wo
->wo_rusage
) : 0;
1399 if (!retval
&& wo
->wo_stat
)
1400 retval
= put_user((exit_code
<< 8) | 0x7f, wo
->wo_stat
);
1402 infop
= wo
->wo_info
;
1403 if (!retval
&& infop
)
1404 retval
= put_user(SIGCHLD
, &infop
->si_signo
);
1405 if (!retval
&& infop
)
1406 retval
= put_user(0, &infop
->si_errno
);
1407 if (!retval
&& infop
)
1408 retval
= put_user((short)why
, &infop
->si_code
);
1409 if (!retval
&& infop
)
1410 retval
= put_user(exit_code
, &infop
->si_status
);
1411 if (!retval
&& infop
)
1412 retval
= put_user(pid
, &infop
->si_pid
);
1413 if (!retval
&& infop
)
1414 retval
= put_user(uid
, &infop
->si_uid
);
1424 * Handle do_wait work for one task in a live, non-stopped state.
1425 * read_lock(&tasklist_lock) on entry. If we return zero, we still hold
1426 * the lock and this task is uninteresting. If we return nonzero, we have
1427 * released the lock and the system call should return.
1429 static int wait_task_continued(struct wait_opts
*wo
, struct task_struct
*p
)
1435 if (!unlikely(wo
->wo_flags
& WCONTINUED
))
1438 if (!(p
->signal
->flags
& SIGNAL_STOP_CONTINUED
))
1441 spin_lock_irq(&p
->sighand
->siglock
);
1442 /* Re-check with the lock held. */
1443 if (!(p
->signal
->flags
& SIGNAL_STOP_CONTINUED
)) {
1444 spin_unlock_irq(&p
->sighand
->siglock
);
1447 if (!unlikely(wo
->wo_flags
& WNOWAIT
))
1448 p
->signal
->flags
&= ~SIGNAL_STOP_CONTINUED
;
1449 uid
= __task_cred(p
)->uid
;
1450 spin_unlock_irq(&p
->sighand
->siglock
);
1452 pid
= task_pid_vnr(p
);
1454 read_unlock(&tasklist_lock
);
1457 retval
= wo
->wo_rusage
1458 ? getrusage(p
, RUSAGE_BOTH
, wo
->wo_rusage
) : 0;
1460 if (!retval
&& wo
->wo_stat
)
1461 retval
= put_user(0xffff, wo
->wo_stat
);
1465 retval
= wait_noreap_copyout(wo
, p
, pid
, uid
,
1466 CLD_CONTINUED
, SIGCONT
);
1467 BUG_ON(retval
== 0);
1474 * Consider @p for a wait by @parent.
1476 * -ECHILD should be in ->notask_error before the first call.
1477 * Returns nonzero for a final return, when we have unlocked tasklist_lock.
1478 * Returns zero if the search for a child should continue;
1479 * then ->notask_error is 0 if @p is an eligible child,
1480 * or another error from security_task_wait(), or still -ECHILD.
1482 static int wait_consider_task(struct wait_opts
*wo
, struct task_struct
*parent
,
1483 int ptrace
, struct task_struct
*p
)
1485 int ret
= eligible_child(wo
, p
);
1489 ret
= security_task_wait(p
);
1490 if (unlikely(ret
< 0)) {
1492 * If we have not yet seen any eligible child,
1493 * then let this error code replace -ECHILD.
1494 * A permission error will give the user a clue
1495 * to look for security policy problems, rather
1496 * than for mysterious wait bugs.
1498 if (wo
->notask_error
)
1499 wo
->notask_error
= ret
;
1503 if (likely(!ptrace
) && unlikely(task_ptrace(p
))) {
1505 * This child is hidden by ptrace.
1506 * We aren't allowed to see it now, but eventually we will.
1508 wo
->notask_error
= 0;
1512 if (p
->exit_state
== EXIT_DEAD
)
1516 * We don't reap group leaders with subthreads.
1518 if (p
->exit_state
== EXIT_ZOMBIE
&& !delay_group_leader(p
))
1519 return wait_task_zombie(wo
, p
);
1522 * It's stopped or running now, so it might
1523 * later continue, exit, or stop again.
1525 wo
->notask_error
= 0;
1527 if (task_stopped_code(p
, ptrace
))
1528 return wait_task_stopped(wo
, ptrace
, p
);
1530 return wait_task_continued(wo
, p
);
1534 * Do the work of do_wait() for one thread in the group, @tsk.
1536 * -ECHILD should be in ->notask_error before the first call.
1537 * Returns nonzero for a final return, when we have unlocked tasklist_lock.
1538 * Returns zero if the search for a child should continue; then
1539 * ->notask_error is 0 if there were any eligible children,
1540 * or another error from security_task_wait(), or still -ECHILD.
1542 static int do_wait_thread(struct wait_opts
*wo
, struct task_struct
*tsk
)
1544 struct task_struct
*p
;
1546 list_for_each_entry(p
, &tsk
->children
, sibling
) {
1548 * Do not consider detached threads.
1550 if (!task_detached(p
)) {
1551 int ret
= wait_consider_task(wo
, tsk
, 0, p
);
1560 static int ptrace_do_wait(struct wait_opts
*wo
, struct task_struct
*tsk
)
1562 struct task_struct
*p
;
1564 list_for_each_entry(p
, &tsk
->ptraced
, ptrace_entry
) {
1565 int ret
= wait_consider_task(wo
, tsk
, 1, p
);
1573 void __wake_up_parent(struct task_struct
*p
, struct task_struct
*parent
)
1575 wake_up_interruptible_sync(&parent
->signal
->wait_chldexit
);
1578 static long do_wait(struct wait_opts
*wo
)
1580 DECLARE_WAITQUEUE(wait
, current
);
1581 struct task_struct
*tsk
;
1584 trace_sched_process_wait(wo
->wo_pid
);
1586 add_wait_queue(¤t
->signal
->wait_chldexit
,&wait
);
1589 * If there is nothing that can match our critiera just get out.
1590 * We will clear ->notask_error to zero if we see any child that
1591 * might later match our criteria, even if we are not able to reap
1594 wo
->notask_error
= -ECHILD
;
1595 if ((wo
->wo_type
< PIDTYPE_MAX
) &&
1596 (!wo
->wo_pid
|| hlist_empty(&wo
->wo_pid
->tasks
[wo
->wo_type
])))
1599 set_current_state(TASK_INTERRUPTIBLE
);
1600 read_lock(&tasklist_lock
);
1603 retval
= do_wait_thread(wo
, tsk
);
1607 retval
= ptrace_do_wait(wo
, tsk
);
1611 if (wo
->wo_flags
& __WNOTHREAD
)
1613 } while_each_thread(current
, tsk
);
1614 read_unlock(&tasklist_lock
);
1617 retval
= wo
->notask_error
;
1618 if (!retval
&& !(wo
->wo_flags
& WNOHANG
)) {
1619 retval
= -ERESTARTSYS
;
1620 if (!signal_pending(current
)) {
1626 __set_current_state(TASK_RUNNING
);
1627 remove_wait_queue(¤t
->signal
->wait_chldexit
,&wait
);
1629 struct siginfo __user
*infop
= wo
->wo_info
;
1635 * For a WNOHANG return, clear out all the fields
1636 * we would set so the user can easily tell the
1640 retval
= put_user(0, &infop
->si_signo
);
1642 retval
= put_user(0, &infop
->si_errno
);
1644 retval
= put_user(0, &infop
->si_code
);
1646 retval
= put_user(0, &infop
->si_pid
);
1648 retval
= put_user(0, &infop
->si_uid
);
1650 retval
= put_user(0, &infop
->si_status
);
1656 SYSCALL_DEFINE5(waitid
, int, which
, pid_t
, upid
, struct siginfo __user
*,
1657 infop
, int, options
, struct rusage __user
*, ru
)
1659 struct wait_opts wo
;
1660 struct pid
*pid
= NULL
;
1664 if (options
& ~(WNOHANG
|WNOWAIT
|WEXITED
|WSTOPPED
|WCONTINUED
))
1666 if (!(options
& (WEXITED
|WSTOPPED
|WCONTINUED
)))
1679 type
= PIDTYPE_PGID
;
1687 if (type
< PIDTYPE_MAX
)
1688 pid
= find_get_pid(upid
);
1692 wo
.wo_flags
= options
;
1699 /* avoid REGPARM breakage on x86: */
1700 asmlinkage_protect(5, ret
, which
, upid
, infop
, options
, ru
);
1704 SYSCALL_DEFINE4(wait4
, pid_t
, upid
, int __user
*, stat_addr
,
1705 int, options
, struct rusage __user
*, ru
)
1707 struct wait_opts wo
;
1708 struct pid
*pid
= NULL
;
1712 if (options
& ~(WNOHANG
|WUNTRACED
|WCONTINUED
|
1713 __WNOTHREAD
|__WCLONE
|__WALL
))
1718 else if (upid
< 0) {
1719 type
= PIDTYPE_PGID
;
1720 pid
= find_get_pid(-upid
);
1721 } else if (upid
== 0) {
1722 type
= PIDTYPE_PGID
;
1723 pid
= get_task_pid(current
, PIDTYPE_PGID
);
1724 } else /* upid > 0 */ {
1726 pid
= find_get_pid(upid
);
1731 wo
.wo_flags
= options
| WEXITED
;
1733 wo
.wo_stat
= stat_addr
;
1738 /* avoid REGPARM breakage on x86: */
1739 asmlinkage_protect(4, ret
, upid
, stat_addr
, options
, ru
);
1743 #ifdef __ARCH_WANT_SYS_WAITPID
1746 * sys_waitpid() remains for compatibility. waitpid() should be
1747 * implemented by calling sys_wait4() from libc.a.
1749 SYSCALL_DEFINE3(waitpid
, pid_t
, pid
, int __user
*, stat_addr
, int, options
)
1751 return sys_wait4(pid
, stat_addr
, options
, NULL
);