Skip to contentSkip to conversation

Add a document for the padata interface

PATCH In review Jonathan Corbet 2 participants 4 messages May 12, 2010 – May 14, 2010 Documentation

lore
Share & tools
lore

Jonathan Corbet

author maintainer
#0 lore raw

PATCH 1/1 Add a document for the padata interface

Last month I promised to format this information up as a documentation addition; here it is. In the absence of unhappiness, I'll send it Linusward through my docs tree when the merge window opens.

Comments welcome,

jon
---
Add a document describing the padata interface

This originally appeared as http://lwn.net/Articles/382257/.

---
 Documentation/00-INDEX   |    2 +
 Documentation/padata.txt |  107 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 109 insertions(+), 0 deletions(-)
 create mode 100644 Documentation/padata.txt
Documentation/00-INDEX +2 -0
index 06b982a..dd10b51 100644
@@ -250,6 +250,8 @@ numastat.txt
 	- info on how to read Numa policy hit/miss statistics in sysfs.
 oops-tracing.txt
 	- how to decode those nasty internal kernel error dump messages.
+padata.txt
+	- An introduction to the "padata" parallel execution API
 parisc/
 	- directory with info on using Linux on PA-RISC architecture.
 parport.txt
Documentation/padata.txt new file +107 -0

107 lines not on this page · raw message

#1 lore raw

Documentation/padata.txt

Quoted 6 lines · Jonathan Corbet
Documentation/padata.txt new file +6 -0
+
+Each task submitted to padata_do_parallel() will, in turn, be passed to
+exactly one call to the above-mentioned parallel() function, on one CPU, so
+true parallelism is achieved by submitting multiple tasks.  The workqueue
+is used to actually make these calls, so parallel() runs in process context
+and is allowed to sleep.  

We disable the BHs before we call parallel(), so sleeping is not allowed. This is necessary to keep up with the networking softirq if padata is used for doing IPsec.

Everything else reads pretty good.

Thanks,

Steffen

author maintainer
#2 lore raw
Quoted 3 lines · On Fri, 14 May 2010 12:58:59 +0200 Steffen Klassert…

We disable the BHs before we call parallel(), so sleeping is not allowed. This is necessary to keep up with the networking softirq if padata is used for doing IPsec.

Oops...you didn't point that out last time :)

I've updated that one sentence in the attached patch; everything else is the same. Look good?

Thanks,

jon

---
Add a document describing the padata interface

This originally appeared as http://lwn.net/Articles/382257/.

Cc Steffen Klassert <[email protected]>
---
 Documentation/00-INDEX   |    2 +
 Documentation/padata.txt |  107 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 109 insertions(+), 0 deletions(-)
 create mode 100644 Documentation/padata.txt
Documentation/00-INDEX +2 -0
index 06b982a..dd10b51 100644
@@ -250,6 +250,8 @@ numastat.txt
 	- info on how to read Numa policy hit/miss statistics in sysfs.
 oops-tracing.txt
 	- how to decode those nasty internal kernel error dump messages.
+padata.txt
+	- An introduction to the "padata" parallel execution API
 parisc/
 	- directory with info on using Linux on PA-RISC architecture.
 parport.txt
Documentation/padata.txt new file +107 -0

107 lines not on this page · raw message

Signature · 1 line
1.7.0.1
#3 lore raw
Quoted 9 lines · Jonathan Corbet
Quoted 3 lines · On Fri, 14 May 2010 12:58:59 +0200 Steffen Klassert…

We disable the BHs before we call parallel(), so sleeping is not allowed. This is necessary to keep up with the networking softirq if padata is used for doing IPsec.

Oops...you didn't point that out last time :)

Yes, I missed that when I read it last time :)

Quoted 3 lines

I've updated that one sentence in the attached patch; everything else is the same. Look good?

Looks pretty good!

Thanks a lot,

Steffen