diff options
| author | Linus Torvalds <torvalds@linux-foundation.org> | 2008-07-26 23:29:39 -0400 |
|---|---|---|
| committer | Linus Torvalds <torvalds@linux-foundation.org> | 2008-07-26 23:29:39 -0400 |
| commit | eaf0ba5ef69538b6913525294a3a0fcb0e0992e0 (patch) | |
| tree | 2c67cfa8fcc8f971bcf660b83654c9e6b807ff3d /include | |
| parent | 732730d48dc777f6577a6e0fece42b860324998e (diff) | |
| parent | a9906a19193db69ad0158f289f839edf8aaf103f (diff) | |
Merge branch 'tracehook' of git://git.kernel.org/pub/scm/linux/kernel/git/frob/linux-2.6-utrace
* 'tracehook' of git://git.kernel.org/pub/scm/linux/kernel/git/frob/linux-2.6-utrace:
tracehook: comment fixes
Diffstat (limited to 'include')
| -rw-r--r-- | include/linux/tracehook.h | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/include/linux/tracehook.h b/include/linux/tracehook.h index 589f429619c9..b1875582c1a1 100644 --- a/include/linux/tracehook.h +++ b/include/linux/tracehook.h | |||
| @@ -244,7 +244,7 @@ static inline int tracehook_prepare_clone(unsigned clone_flags) | |||
| 244 | * tracehook_finish_clone - new child created and being attached | 244 | * tracehook_finish_clone - new child created and being attached |
| 245 | * @child: new child task | 245 | * @child: new child task |
| 246 | * @clone_flags: %CLONE_* flags from clone/fork/vfork system call | 246 | * @clone_flags: %CLONE_* flags from clone/fork/vfork system call |
| 247 | * @trace: return value from tracehook_clone_prepare() | 247 | * @trace: return value from tracehook_prepare_clone() |
| 248 | * | 248 | * |
| 249 | * This is called immediately after adding @child to its parent's children list. | 249 | * This is called immediately after adding @child to its parent's children list. |
| 250 | * The @trace value is that returned by tracehook_prepare_clone(). | 250 | * The @trace value is that returned by tracehook_prepare_clone(). |
| @@ -259,19 +259,20 @@ static inline void tracehook_finish_clone(struct task_struct *child, | |||
| 259 | 259 | ||
| 260 | /** | 260 | /** |
| 261 | * tracehook_report_clone - in parent, new child is about to start running | 261 | * tracehook_report_clone - in parent, new child is about to start running |
| 262 | * @trace: return value from tracehook_clone_prepare() | 262 | * @trace: return value from tracehook_prepare_clone() |
| 263 | * @regs: parent's user register state | 263 | * @regs: parent's user register state |
| 264 | * @clone_flags: flags from parent's system call | 264 | * @clone_flags: flags from parent's system call |
| 265 | * @pid: new child's PID in the parent's namespace | 265 | * @pid: new child's PID in the parent's namespace |
| 266 | * @child: new child task | 266 | * @child: new child task |
| 267 | * | 267 | * |
| 268 | * Called after a child is set up, but before it has been started running. | 268 | * Called after a child is set up, but before it has been started |
| 269 | * The @trace value is that returned by tracehook_clone_prepare(). | 269 | * running. @trace is the value returned by tracehook_prepare_clone(). |
| 270 | * This is not a good place to block, because the child has not started yet. | 270 | * This is not a good place to block, because the child has not started |
| 271 | * Suspend the child here if desired, and block in tracehook_clone_complete(). | 271 | * yet. Suspend the child here if desired, and then block in |
| 272 | * This must prevent the child from self-reaping if tracehook_clone_complete() | 272 | * tracehook_report_clone_complete(). This must prevent the child from |
| 273 | * uses the @child pointer; otherwise it might have died and been released by | 273 | * self-reaping if tracehook_report_clone_complete() uses the @child |
| 274 | * the time tracehook_report_clone_complete() is called. | 274 | * pointer; otherwise it might have died and been released by the time |
| 275 | * tracehook_report_report_clone_complete() is called. | ||
| 275 | * | 276 | * |
| 276 | * Called with no locks held, but the child cannot run until this returns. | 277 | * Called with no locks held, but the child cannot run until this returns. |
| 277 | */ | 278 | */ |
| @@ -290,7 +291,7 @@ static inline void tracehook_report_clone(int trace, struct pt_regs *regs, | |||
| 290 | 291 | ||
| 291 | /** | 292 | /** |
| 292 | * tracehook_report_clone_complete - new child is running | 293 | * tracehook_report_clone_complete - new child is running |
| 293 | * @trace: return value from tracehook_clone_prepare() | 294 | * @trace: return value from tracehook_prepare_clone() |
| 294 | * @regs: parent's user register state | 295 | * @regs: parent's user register state |
| 295 | * @clone_flags: flags from parent's system call | 296 | * @clone_flags: flags from parent's system call |
| 296 | * @pid: new child's PID in the parent's namespace | 297 | * @pid: new child's PID in the parent's namespace |
| @@ -347,7 +348,7 @@ static inline void tracehook_prepare_release_task(struct task_struct *task) | |||
| 347 | } | 348 | } |
| 348 | 349 | ||
| 349 | /** | 350 | /** |
| 350 | * tracehook_finish_release_task - task is being reaped, clean up tracing | 351 | * tracehook_finish_release_task - final tracing clean-up |
| 351 | * @task: task in %EXIT_DEAD state | 352 | * @task: task in %EXIT_DEAD state |
| 352 | * | 353 | * |
| 353 | * This is called in release_task() when @task is being in the middle of | 354 | * This is called in release_task() when @task is being in the middle of |
