Commit a9906a19193db69ad0158f289f839edf8aaf103f
1 parent
a048d3aff8
Exists in
master
and in
7 other branches
tracehook: comment fixes
This fixes some typos and errors in <linux/tracehook.h> comments. No code changes. Signed-off-by: Roland McGrath <roland@redhat.com>
Showing 1 changed file with 12 additions and 11 deletions Side-by-side Diff
include/linux/tracehook.h
| ... | ... | @@ -244,7 +244,7 @@ |
| 244 | 244 | * tracehook_finish_clone - new child created and being attached |
| 245 | 245 | * @child: new child task |
| 246 | 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 | 249 | * This is called immediately after adding @child to its parent's children list. |
| 250 | 250 | * The @trace value is that returned by tracehook_prepare_clone(). |
| 251 | 251 | |
| ... | ... | @@ -259,19 +259,20 @@ |
| 259 | 259 | |
| 260 | 260 | /** |
| 261 | 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 | 263 | * @regs: parent's user register state |
| 264 | 264 | * @clone_flags: flags from parent's system call |
| 265 | 265 | * @pid: new child's PID in the parent's namespace |
| 266 | 266 | * @child: new child task |
| 267 | 267 | * |
| 268 | - * Called after a child is set up, but before it has been started running. | |
| 269 | - * The @trace value is that returned by tracehook_clone_prepare(). | |
| 270 | - * This is not a good place to block, because the child has not started yet. | |
| 271 | - * Suspend the child here if desired, and block in tracehook_clone_complete(). | |
| 272 | - * This must prevent the child from self-reaping if tracehook_clone_complete() | |
| 273 | - * uses the @child pointer; otherwise it might have died and been released by | |
| 274 | - * the time tracehook_report_clone_complete() is called. | |
| 268 | + * Called after a child is set up, but before it has been started | |
| 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 | |
| 271 | + * yet. Suspend the child here if desired, and then block in | |
| 272 | + * tracehook_report_clone_complete(). This must prevent the child from | |
| 273 | + * self-reaping if tracehook_report_clone_complete() uses the @child | |
| 274 | + * pointer; otherwise it might have died and been released by the time | |
| 275 | + * tracehook_report_report_clone_complete() is called. | |
| 275 | 276 | * |
| 276 | 277 | * Called with no locks held, but the child cannot run until this returns. |
| 277 | 278 | */ |
| ... | ... | @@ -290,7 +291,7 @@ |
| 290 | 291 | |
| 291 | 292 | /** |
| 292 | 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 | 295 | * @regs: parent's user register state |
| 295 | 296 | * @clone_flags: flags from parent's system call |
| 296 | 297 | * @pid: new child's PID in the parent's namespace |
| ... | ... | @@ -347,7 +348,7 @@ |
| 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 | 352 | * @task: task in %EXIT_DEAD state |
| 352 | 353 | * |
| 353 | 354 | * This is called in release_task() when @task is being in the middle of |