linux-kernel - [tip:sched/core] sched/completion: Document when to use wait_for_completion_io

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <tip-a1bd5373357d3edc4b97548747d583c3efa484b3@git.kernel.org>
Date:	Sun, 16 Nov 2014 04:31:57 -0800
From:	tip-bot for Wolfram Sang <tipbot@...or.com>
To:	linux-tip-commits@...r.kernel.org
Cc:	gnomes@...rguk.ukuu.org.uk, wsa@...-dreams.de, mingo@...nel.org,
	tglx@...utronix.de, hpa@...or.com, peterz@...radead.org,
	linux-kernel@...r.kernel.org, torvalds@...ux-foundation.org
Subject: [tip:sched/core] sched/completion:
  Document when to use wait_for_completion_io_*()

Commit-ID:  a1bd5373357d3edc4b97548747d583c3efa484b3
Gitweb:     http://git.kernel.org/tip/a1bd5373357d3edc4b97548747d583c3efa484b3
Author:     Wolfram Sang <wsa@...-dreams.de>
AuthorDate: Tue, 4 Nov 2014 12:01:41 +0100
Committer:  Ingo Molnar <mingo@...nel.org>
CommitDate: Sun, 16 Nov 2014 10:58:54 +0100

sched/completion: Document when to use wait_for_completion_io_*()

As discussed in [1], accounting IO is meant for blkio only. Document that
so driver authors won't use them for device io.

 [1] http://thread.gmane.org/gmane.linux.drivers.i2c/20470

Signed-off-by: Wolfram Sang <wsa@...-dreams.de>
Signed-off-by: Peter Zijlstra (Intel) <peterz@...radead.org>
Cc: One Thousand Gnomes <gnomes@...rguk.ukuu.org.uk>
Cc: Linus Torvalds <torvalds@...ux-foundation.org>
Link: http://lkml.kernel.org/r/1415098901-2768-1-git-send-email-wsa@the-dreams.de
Signed-off-by: Ingo Molnar <mingo@...nel.org>
---
 kernel/sched/completion.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/kernel/sched/completion.c b/kernel/sched/completion.c
index a63f4dc..607f852 100644
--- a/kernel/sched/completion.c
+++ b/kernel/sched/completion.c
@@ -148,7 +148,7 @@ EXPORT_SYMBOL(wait_for_completion_timeout);
  *
  * This waits to be signaled for completion of a specific task. It is NOT
  * interruptible and there is no timeout. The caller is accounted as waiting
- * for IO.
+ * for IO (which traditionally means blkio only).
  */
 void __sched wait_for_completion_io(struct completion *x)
 {
@@ -163,7 +163,8 @@ EXPORT_SYMBOL(wait_for_completion_io);
  *
  * This waits for either a completion of a specific task to be signaled or for a
  * specified timeout to expire. The timeout is in jiffies. It is not
- * interruptible. The caller is accounted as waiting for IO.
+ * interruptible. The caller is accounted as waiting for IO (which traditionally
+ * means blkio only).
  *
  * Return: 0 if timed out, and positive (at least 1, or number of jiffies left
  * till timeout) if completed.
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/