Loading CREDITS +1 −1 Original line number Original line Diff line number Diff line Loading @@ -1097,7 +1097,7 @@ S: 80050-430 - Curitiba - Paran S: Brazil S: Brazil N: Kumar Gala N: Kumar Gala E: kumar.gala@freescale.com E: galak@kernel.crashing.org D: Embedded PowerPC 6xx/7xx/74xx/82xx/83xx/85xx support D: Embedded PowerPC 6xx/7xx/74xx/82xx/83xx/85xx support S: Austin, Texas 78729 S: Austin, Texas 78729 S: USA S: USA Loading Documentation/DocBook/Makefile +33 −15 Original line number Original line Diff line number Diff line Loading @@ -20,6 +20,12 @@ DOCBOOKS := wanbook.xml z8530book.xml mcabook.xml videobook.xml \ # +--> DIR=file (htmldocs) # +--> DIR=file (htmldocs) # +--> man/ (mandocs) # +--> man/ (mandocs) # for PDF and PS output you can choose between xmlto and docbook-utils tools PDF_METHOD = $(prefer-db2x) PS_METHOD = $(prefer-db2x) ### ### # The targets that may be used. # The targets that may be used. .PHONY: xmldocs sgmldocs psdocs pdfdocs htmldocs mandocs installmandocs .PHONY: xmldocs sgmldocs psdocs pdfdocs htmldocs mandocs installmandocs Loading Loading @@ -93,27 +99,39 @@ C-procfs-example = procfs_example.xml C-procfs-example2 = $(addprefix $(obj)/,$(C-procfs-example)) C-procfs-example2 = $(addprefix $(obj)/,$(C-procfs-example)) $(obj)/procfs-guide.xml: $(C-procfs-example2) $(obj)/procfs-guide.xml: $(C-procfs-example2) ### notfoundtemplate = echo "*** You have to install docbook-utils or xmlto ***"; \ # Rules to generate postscript, PDF and HTML exit 1 # db2html creates a directory. Generate a html file used for timestamp db2xtemplate = db2TYPE -o $(dir $@) $< xmltotemplate = xmlto TYPE $(XMLTOFLAGS) -o $(dir $@) $< # determine which methods are available ifeq ($(shell which db2ps >/dev/null 2>&1 && echo found),found) use-db2x = db2x prefer-db2x = db2x else use-db2x = notfound prefer-db2x = $(use-xmlto) endif ifeq ($(shell which xmlto >/dev/null 2>&1 && echo found),found) use-xmlto = xmlto prefer-xmlto = xmlto else use-xmlto = notfound prefer-xmlto = $(use-db2x) endif quiet_cmd_db2ps = XMLTO $@ # the commands, generated from the chosen template cmd_db2ps = xmlto ps $(XMLTOFLAGS) -o $(dir $@) $< quiet_cmd_db2ps = PS $@ cmd_db2ps = $(subst TYPE,ps, $($(PS_METHOD)template)) %.ps : %.xml %.ps : %.xml @(which xmlto > /dev/null 2>&1) || \ (echo "*** You need to install xmlto ***"; \ exit 1) $(call cmd,db2ps) $(call cmd,db2ps) quiet_cmd_db2pdf = XMLTO $@ quiet_cmd_db2pdf = PDF $@ cmd_db2pdf = xmlto pdf $(XMLTOFLAGS) -o $(dir $@) $< cmd_db2pdf = $(subst TYPE,pdf, $($(PDF_METHOD)template)) %.pdf : %.xml %.pdf : %.xml @(which xmlto > /dev/null 2>&1) || \ (echo "*** You need to install xmlto ***"; \ exit 1) $(call cmd,db2pdf) $(call cmd,db2pdf) quiet_cmd_db2html = XMLTO $@ quiet_cmd_db2html = HTML $@ cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \ cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \ echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/index.html"> \ echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/index.html"> \ Goto $(patsubst %.html,%,$(notdir $@))</a><p>' > $@ Goto $(patsubst %.html,%,$(notdir $@))</a><p>' > $@ Loading @@ -127,7 +145,7 @@ quiet_cmd_db2html = XMLTO $@ @if [ ! -z "$(PNG-$(basename $(notdir $@)))" ]; then \ @if [ ! -z "$(PNG-$(basename $(notdir $@)))" ]; then \ cp $(PNG-$(basename $(notdir $@))) $(patsubst %.html,%,$@); fi cp $(PNG-$(basename $(notdir $@))) $(patsubst %.html,%,$@); fi quiet_cmd_db2man = XMLTO $@ quiet_cmd_db2man = MAN $@ cmd_db2man = if grep -q refentry $<; then xmlto man $(XMLTOFLAGS) -o $(obj)/man $< ; gzip -f $(obj)/man/*.9; fi cmd_db2man = if grep -q refentry $<; then xmlto man $(XMLTOFLAGS) -o $(obj)/man $< ; gzip -f $(obj)/man/*.9; fi %.9 : %.xml %.9 : %.xml @(which xmlto > /dev/null 2>&1) || \ @(which xmlto > /dev/null 2>&1) || \ Loading Documentation/DocBook/kernel-api.tmpl +2 −4 Original line number Original line Diff line number Diff line Loading @@ -68,9 +68,7 @@ X!Iinclude/linux/kobject.h <sect1><title>Kernel utility functions</title> <sect1><title>Kernel utility functions</title> !Iinclude/linux/kernel.h !Iinclude/linux/kernel.h <!-- This needs to clean up to make kernel-doc happy !Ekernel/printk.c X!Ekernel/printk.c --> !Ekernel/panic.c !Ekernel/panic.c !Ekernel/sys.c !Ekernel/sys.c !Ekernel/rcupdate.c !Ekernel/rcupdate.c Loading Loading @@ -388,7 +386,7 @@ X!Edrivers/pnp/system.c <chapter id="blkdev"> <chapter id="blkdev"> <title>Block Devices</title> <title>Block Devices</title> !Edrivers/block/ll_rw_blk.c !Eblock/ll_rw_blk.c </chapter> </chapter> <chapter id="miscdev"> <chapter id="miscdev"> Loading Documentation/DocBook/stylesheet.xsl +1 −0 Original line number Original line Diff line number Diff line Loading @@ -3,4 +3,5 @@ <param name="chunk.quietly">1</param> <param name="chunk.quietly">1</param> <param name="funcsynopsis.style">ansi</param> <param name="funcsynopsis.style">ansi</param> <param name="funcsynopsis.tabular.threshold">80</param> <param name="funcsynopsis.tabular.threshold">80</param> <!-- <param name="paper.type">A4</param> --> </stylesheet> </stylesheet> Documentation/atomic_ops.txt +27 −0 Original line number Original line Diff line number Diff line Loading @@ -115,6 +115,33 @@ boolean is return which indicates whether the resulting counter value is negative. It requires explicit memory barrier semantics around the is negative. It requires explicit memory barrier semantics around the operation. operation. Then: int atomic_cmpxchg(atomic_t *v, int old, int new); This performs an atomic compare exchange operation on the atomic value v, with the given old and new values. Like all atomic_xxx operations, atomic_cmpxchg will only satisfy its atomicity semantics as long as all other accesses of *v are performed through atomic_xxx operations. atomic_cmpxchg requires explicit memory barriers around the operation. The semantics for atomic_cmpxchg are the same as those defined for 'cas' below. Finally: int atomic_add_unless(atomic_t *v, int a, int u); If the atomic value v is not equal to u, this function adds a to v, and returns non zero. If v is equal to u then it returns zero. This is done as an atomic operation. atomic_add_unless requires explicit memory barriers around the operation. atomic_inc_not_zero, equivalent to atomic_add_unless(v, 1, 0) If a caller requires memory barrier semantics around an atomic_t If a caller requires memory barrier semantics around an atomic_t operation which does not return a value, a set of interfaces are operation which does not return a value, a set of interfaces are defined which accomplish this: defined which accomplish this: Loading Loading
CREDITS +1 −1 Original line number Original line Diff line number Diff line Loading @@ -1097,7 +1097,7 @@ S: 80050-430 - Curitiba - Paran S: Brazil S: Brazil N: Kumar Gala N: Kumar Gala E: kumar.gala@freescale.com E: galak@kernel.crashing.org D: Embedded PowerPC 6xx/7xx/74xx/82xx/83xx/85xx support D: Embedded PowerPC 6xx/7xx/74xx/82xx/83xx/85xx support S: Austin, Texas 78729 S: Austin, Texas 78729 S: USA S: USA Loading
Documentation/DocBook/Makefile +33 −15 Original line number Original line Diff line number Diff line Loading @@ -20,6 +20,12 @@ DOCBOOKS := wanbook.xml z8530book.xml mcabook.xml videobook.xml \ # +--> DIR=file (htmldocs) # +--> DIR=file (htmldocs) # +--> man/ (mandocs) # +--> man/ (mandocs) # for PDF and PS output you can choose between xmlto and docbook-utils tools PDF_METHOD = $(prefer-db2x) PS_METHOD = $(prefer-db2x) ### ### # The targets that may be used. # The targets that may be used. .PHONY: xmldocs sgmldocs psdocs pdfdocs htmldocs mandocs installmandocs .PHONY: xmldocs sgmldocs psdocs pdfdocs htmldocs mandocs installmandocs Loading Loading @@ -93,27 +99,39 @@ C-procfs-example = procfs_example.xml C-procfs-example2 = $(addprefix $(obj)/,$(C-procfs-example)) C-procfs-example2 = $(addprefix $(obj)/,$(C-procfs-example)) $(obj)/procfs-guide.xml: $(C-procfs-example2) $(obj)/procfs-guide.xml: $(C-procfs-example2) ### notfoundtemplate = echo "*** You have to install docbook-utils or xmlto ***"; \ # Rules to generate postscript, PDF and HTML exit 1 # db2html creates a directory. Generate a html file used for timestamp db2xtemplate = db2TYPE -o $(dir $@) $< xmltotemplate = xmlto TYPE $(XMLTOFLAGS) -o $(dir $@) $< # determine which methods are available ifeq ($(shell which db2ps >/dev/null 2>&1 && echo found),found) use-db2x = db2x prefer-db2x = db2x else use-db2x = notfound prefer-db2x = $(use-xmlto) endif ifeq ($(shell which xmlto >/dev/null 2>&1 && echo found),found) use-xmlto = xmlto prefer-xmlto = xmlto else use-xmlto = notfound prefer-xmlto = $(use-db2x) endif quiet_cmd_db2ps = XMLTO $@ # the commands, generated from the chosen template cmd_db2ps = xmlto ps $(XMLTOFLAGS) -o $(dir $@) $< quiet_cmd_db2ps = PS $@ cmd_db2ps = $(subst TYPE,ps, $($(PS_METHOD)template)) %.ps : %.xml %.ps : %.xml @(which xmlto > /dev/null 2>&1) || \ (echo "*** You need to install xmlto ***"; \ exit 1) $(call cmd,db2ps) $(call cmd,db2ps) quiet_cmd_db2pdf = XMLTO $@ quiet_cmd_db2pdf = PDF $@ cmd_db2pdf = xmlto pdf $(XMLTOFLAGS) -o $(dir $@) $< cmd_db2pdf = $(subst TYPE,pdf, $($(PDF_METHOD)template)) %.pdf : %.xml %.pdf : %.xml @(which xmlto > /dev/null 2>&1) || \ (echo "*** You need to install xmlto ***"; \ exit 1) $(call cmd,db2pdf) $(call cmd,db2pdf) quiet_cmd_db2html = XMLTO $@ quiet_cmd_db2html = HTML $@ cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \ cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \ echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/index.html"> \ echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/index.html"> \ Goto $(patsubst %.html,%,$(notdir $@))</a><p>' > $@ Goto $(patsubst %.html,%,$(notdir $@))</a><p>' > $@ Loading @@ -127,7 +145,7 @@ quiet_cmd_db2html = XMLTO $@ @if [ ! -z "$(PNG-$(basename $(notdir $@)))" ]; then \ @if [ ! -z "$(PNG-$(basename $(notdir $@)))" ]; then \ cp $(PNG-$(basename $(notdir $@))) $(patsubst %.html,%,$@); fi cp $(PNG-$(basename $(notdir $@))) $(patsubst %.html,%,$@); fi quiet_cmd_db2man = XMLTO $@ quiet_cmd_db2man = MAN $@ cmd_db2man = if grep -q refentry $<; then xmlto man $(XMLTOFLAGS) -o $(obj)/man $< ; gzip -f $(obj)/man/*.9; fi cmd_db2man = if grep -q refentry $<; then xmlto man $(XMLTOFLAGS) -o $(obj)/man $< ; gzip -f $(obj)/man/*.9; fi %.9 : %.xml %.9 : %.xml @(which xmlto > /dev/null 2>&1) || \ @(which xmlto > /dev/null 2>&1) || \ Loading
Documentation/DocBook/kernel-api.tmpl +2 −4 Original line number Original line Diff line number Diff line Loading @@ -68,9 +68,7 @@ X!Iinclude/linux/kobject.h <sect1><title>Kernel utility functions</title> <sect1><title>Kernel utility functions</title> !Iinclude/linux/kernel.h !Iinclude/linux/kernel.h <!-- This needs to clean up to make kernel-doc happy !Ekernel/printk.c X!Ekernel/printk.c --> !Ekernel/panic.c !Ekernel/panic.c !Ekernel/sys.c !Ekernel/sys.c !Ekernel/rcupdate.c !Ekernel/rcupdate.c Loading Loading @@ -388,7 +386,7 @@ X!Edrivers/pnp/system.c <chapter id="blkdev"> <chapter id="blkdev"> <title>Block Devices</title> <title>Block Devices</title> !Edrivers/block/ll_rw_blk.c !Eblock/ll_rw_blk.c </chapter> </chapter> <chapter id="miscdev"> <chapter id="miscdev"> Loading
Documentation/DocBook/stylesheet.xsl +1 −0 Original line number Original line Diff line number Diff line Loading @@ -3,4 +3,5 @@ <param name="chunk.quietly">1</param> <param name="chunk.quietly">1</param> <param name="funcsynopsis.style">ansi</param> <param name="funcsynopsis.style">ansi</param> <param name="funcsynopsis.tabular.threshold">80</param> <param name="funcsynopsis.tabular.threshold">80</param> <!-- <param name="paper.type">A4</param> --> </stylesheet> </stylesheet>
Documentation/atomic_ops.txt +27 −0 Original line number Original line Diff line number Diff line Loading @@ -115,6 +115,33 @@ boolean is return which indicates whether the resulting counter value is negative. It requires explicit memory barrier semantics around the is negative. It requires explicit memory barrier semantics around the operation. operation. Then: int atomic_cmpxchg(atomic_t *v, int old, int new); This performs an atomic compare exchange operation on the atomic value v, with the given old and new values. Like all atomic_xxx operations, atomic_cmpxchg will only satisfy its atomicity semantics as long as all other accesses of *v are performed through atomic_xxx operations. atomic_cmpxchg requires explicit memory barriers around the operation. The semantics for atomic_cmpxchg are the same as those defined for 'cas' below. Finally: int atomic_add_unless(atomic_t *v, int a, int u); If the atomic value v is not equal to u, this function adds a to v, and returns non zero. If v is equal to u then it returns zero. This is done as an atomic operation. atomic_add_unless requires explicit memory barriers around the operation. atomic_inc_not_zero, equivalent to atomic_add_unless(v, 1, 0) If a caller requires memory barrier semantics around an atomic_t If a caller requires memory barrier semantics around an atomic_t operation which does not return a value, a set of interfaces are operation which does not return a value, a set of interfaces are defined which accomplish this: defined which accomplish this: Loading