aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2016-01-17 14:55:07 -0500
committerLinus Torvalds <torvalds@linux-foundation.org>2016-01-17 14:55:07 -0500
commite535d74bc50df2357d3253f8f3ca48c66d0d892a (patch)
treefceb1283000fec118000dc02bfe77bea4f512eb4
parentece6267878aed4eadff766112f1079984315d8c8 (diff)
parentec3fc58b1e7a32cc9f552b306f8dbb4454e83798 (diff)
Merge tag 'docs-4.5' of git://git.lwn.net/linux
Pull documentation updates from Jon Corbet: "A relatively boring cycle in the docs tree. There's a few kernel-doc fixes and various document tweaks. One patch reaches out of the documentation subtree to fix a comment in init/do_mounts_rd.c. There didn't seem to be anybody more appropriate to take that one, so I accepted it" * tag 'docs-4.5' of git://git.lwn.net/linux: (29 commits) thermal: add description for integral_cutoff unit Documentation: update libhugetlbfs site url Documentation: Explain pci=conf1,conf2 more verbosely DMA-API: fix confusing sentence in Documentation/DMA-API.txt Documentation: translations: update linux cross reference link Documentation: fix typo in CodingStyle init, Documentation: Remove ramdisk_blocksize mentions Documentation-getdelays: Apply a recommendation from "checkpatch.pl" in main() Documentation: HOWTO: update versions from 3.x to 4.x Documentation: remove outdated references from translations Doc: treewide: Fix grammar "a" to "an" Documentation: cpu-hotplug: Fix sysfs mount instructions can-doc: Add hint about getting timestamps Fix CFQ I/O scheduler parameter name in documentation Documentation: arm: remove dead links from Marvell Berlin docs Documentation: HOWTO: update code cross reference link Doc: Docbook/iio: Fix typo in iio.tmpl DocBook: make index.html generation less verbose by default DocBook: Cleanup: remove an unused $(call) line DocBook: Add a help message for DOCBOOKS env var ...
-rw-r--r--Documentation/CodingStyle2
-rw-r--r--Documentation/DMA-API.txt2
-rw-r--r--Documentation/DocBook/Makefile10
-rw-r--r--Documentation/DocBook/iio.tmpl2
-rw-r--r--Documentation/HOWTO2
-rw-r--r--Documentation/accounting/getdelays.c3
-rw-r--r--Documentation/arm/Marvell/README19
-rw-r--r--Documentation/block/cfq-iosched.txt15
-rw-r--r--Documentation/cpu-hotplug.txt2
-rw-r--r--Documentation/filesystems/proc.txt2
-rw-r--r--Documentation/filesystems/sharedsubtree.txt2
-rw-r--r--Documentation/gpio/consumer.txt2
-rw-r--r--Documentation/gpio/driver.txt6
-rw-r--r--Documentation/gpio/drivers-on-gpio.txt6
-rw-r--r--Documentation/ioctl/botching-up-ioctls.txt6
-rw-r--r--Documentation/ja_JP/HOWTO3
-rw-r--r--Documentation/kernel-docs.txt2
-rw-r--r--Documentation/kernel-parameters.txt17
-rw-r--r--Documentation/ko_KR/HOWTO29
-rw-r--r--Documentation/networking/can.txt9
-rw-r--r--Documentation/stable_kernel_rules.txt2
-rw-r--r--Documentation/thermal/sysfs-api.txt1
-rw-r--r--Documentation/vm/slub.txt2
-rw-r--r--init/do_mounts_rd.c7
-rwxr-xr-xscripts/kernel-doc5
25 files changed, 85 insertions, 73 deletions
diff --git a/Documentation/CodingStyle b/Documentation/CodingStyle
index c06f817b3091..db653774c0b7 100644
--- a/Documentation/CodingStyle
+++ b/Documentation/CodingStyle
@@ -430,7 +430,7 @@ The rationale for using gotos is:
430 return result; 430 return result;
431 } 431 }
432 432
433A common type of bug to be aware of it "one err bugs" which look like this: 433A common type of bug to be aware of is "one err bugs" which look like this:
434 434
435 err: 435 err:
436 kfree(foo->bar); 436 kfree(foo->bar);
diff --git a/Documentation/DMA-API.txt b/Documentation/DMA-API.txt
index 1e98a7e6bccc..45ef3f279c3b 100644
--- a/Documentation/DMA-API.txt
+++ b/Documentation/DMA-API.txt
@@ -236,7 +236,7 @@ are guaranteed also to be cache line boundaries).
236 236
237DMA_TO_DEVICE synchronisation must be done after the last modification 237DMA_TO_DEVICE synchronisation must be done after the last modification
238of the memory region by the software and before it is handed off to 238of the memory region by the software and before it is handed off to
239the driver. Once this primitive is used, memory covered by this 239the device. Once this primitive is used, memory covered by this
240primitive should be treated as read-only by the device. If the device 240primitive should be treated as read-only by the device. If the device
241may write to it at any point, it should be DMA_BIDIRECTIONAL (see 241may write to it at any point, it should be DMA_BIDIRECTIONAL (see
242below). 242below).
diff --git a/Documentation/DocBook/Makefile b/Documentation/DocBook/Makefile
index 91f6d89bb19f..d70f9b68174e 100644
--- a/Documentation/DocBook/Makefile
+++ b/Documentation/DocBook/Makefile
@@ -50,8 +50,7 @@ pdfdocs: $(PDF)
50 50
51HTML := $(sort $(patsubst %.xml, %.html, $(BOOKS))) 51HTML := $(sort $(patsubst %.xml, %.html, $(BOOKS)))
52htmldocs: $(HTML) 52htmldocs: $(HTML)
53 $(call build_main_index) 53 $(call cmd,build_main_index)
54 $(call build_images)
55 $(call install_media_images) 54 $(call install_media_images)
56 55
57MAN := $(patsubst %.xml, %.9, $(BOOKS)) 56MAN := $(patsubst %.xml, %.9, $(BOOKS))
@@ -139,7 +138,8 @@ quiet_cmd_db2pdf = PDF $@
139 138
140index = index.html 139index = index.html
141main_idx = $(obj)/$(index) 140main_idx = $(obj)/$(index)
142build_main_index = rm -rf $(main_idx); \ 141quiet_cmd_build_main_index = HTML $(main_idx)
142 cmd_build_main_index = rm -rf $(main_idx); \
143 echo '<h1>Linux Kernel HTML Documentation</h1>' >> $(main_idx) && \ 143 echo '<h1>Linux Kernel HTML Documentation</h1>' >> $(main_idx) && \
144 echo '<h2>Kernel Version: $(KERNELVERSION)</h2>' >> $(main_idx) && \ 144 echo '<h2>Kernel Version: $(KERNELVERSION)</h2>' >> $(main_idx) && \
145 cat $(HTML) >> $(main_idx) 145 cat $(HTML) >> $(main_idx)
@@ -227,6 +227,10 @@ dochelp:
227 @echo ' mandocs - man pages' 227 @echo ' mandocs - man pages'
228 @echo ' installmandocs - install man pages generated by mandocs' 228 @echo ' installmandocs - install man pages generated by mandocs'
229 @echo ' cleandocs - clean all generated DocBook files' 229 @echo ' cleandocs - clean all generated DocBook files'
230 @echo
231 @echo 'make DOCBOOKS="s1.xml s2.xml" [target] Generate only docs s1.xml s2.xml'
232 @echo ' valid values for DOCBOOKS are: $(DOCBOOKS)'
233
230 234
231### 235###
232# Temporary files left by various tools 236# Temporary files left by various tools
diff --git a/Documentation/DocBook/iio.tmpl b/Documentation/DocBook/iio.tmpl
index 98be322673da..f525bf56d1dd 100644
--- a/Documentation/DocBook/iio.tmpl
+++ b/Documentation/DocBook/iio.tmpl
@@ -458,7 +458,7 @@
458 .scan_type = { 458 .scan_type = {
459 .sign = 's', 459 .sign = 's',
460 .realbits = 12, 460 .realbits = 12,
461 .storgebits = 16, 461 .storagebits = 16,
462 .shift = 4, 462 .shift = 4,
463 .endianness = IIO_LE, 463 .endianness = IIO_LE,
464 }, 464 },
diff --git a/Documentation/HOWTO b/Documentation/HOWTO
index 21152d397b88..d5a699d5a551 100644
--- a/Documentation/HOWTO
+++ b/Documentation/HOWTO
@@ -209,7 +209,7 @@ tools. One such tool that is particularly recommended is the Linux
209Cross-Reference project, which is able to present source code in a 209Cross-Reference project, which is able to present source code in a
210self-referential, indexed webpage format. An excellent up-to-date 210self-referential, indexed webpage format. An excellent up-to-date
211repository of the kernel code may be found at: 211repository of the kernel code may be found at:
212 http://lxr.linux.no/+trees 212 http://lxr.free-electrons.com/
213 213
214 214
215The development process 215The development process
diff --git a/Documentation/accounting/getdelays.c b/Documentation/accounting/getdelays.c
index f40578026a04..7785fb5eb93f 100644
--- a/Documentation/accounting/getdelays.c
+++ b/Documentation/accounting/getdelays.c
@@ -375,7 +375,8 @@ int main(int argc, char *argv[])
375 } 375 }
376 } 376 }
377 377
378 if ((nl_sd = create_nl_socket(NETLINK_GENERIC)) < 0) 378 nl_sd = create_nl_socket(NETLINK_GENERIC);
379 if (nl_sd < 0)
379 err(1, "error creating Netlink socket\n"); 380 err(1, "error creating Netlink socket\n");
380 381
381 382
diff --git a/Documentation/arm/Marvell/README b/Documentation/arm/Marvell/README
index 18a775d10172..ae89b67d8e23 100644
--- a/Documentation/arm/Marvell/README
+++ b/Documentation/arm/Marvell/README
@@ -233,29 +233,30 @@ MMP/MMP2 family (communication processor)
233 Linux kernel mach directory: arch/arm/mach-mmp 233 Linux kernel mach directory: arch/arm/mach-mmp
234 Linux kernel plat directory: arch/arm/plat-pxa 234 Linux kernel plat directory: arch/arm/plat-pxa
235 235
236Berlin family (Digital Entertainment) 236Berlin family (Multimedia Solutions)
237------------------------------------- 237-------------------------------------
238 238
239 Flavors: 239 Flavors:
240 88DE3005, Armada 1500-mini 240 88DE3005, Armada 1500 Mini
241 Design name: BG2CD 241 Design name: BG2CD
242 Core: ARM Cortex-A9, PL310 L2CC 242 Core: ARM Cortex-A9, PL310 L2CC
243 Homepage: http://www.marvell.com/digital-entertainment/armada-1500-mini/ 243 Homepage: http://www.marvell.com/multimedia-solutions/armada-1500-mini/
244 88DE3006, Armada 1500 Mini Plus
245 Design name: BG2CDP
246 Core: Dual Core ARM Cortex-A7
247 Homepage: http://www.marvell.com/multimedia-solutions/armada-1500-mini-plus/
244 88DE3100, Armada 1500 248 88DE3100, Armada 1500
245 Design name: BG2 249 Design name: BG2
246 Core: Marvell PJ4B (ARMv7), Tauros3 L2CC 250 Core: Marvell PJ4B (ARMv7), Tauros3 L2CC
247 Homepage: http://www.marvell.com/digital-entertainment/armada-1500/ 251 Product Brief: http://www.marvell.com/multimedia-solutions/armada-1500/assets/Marvell-ARMADA-1500-Product-Brief.pdf
248 Product Brief: http://www.marvell.com/digital-entertainment/armada-1500/assets/Marvell-ARMADA-1500-Product-Brief.pdf
249 88DE3114, Armada 1500 Pro 252 88DE3114, Armada 1500 Pro
250 Design name: BG2-Q 253 Design name: BG2Q
251 Core: Quad Core ARM Cortex-A9, PL310 L2CC 254 Core: Quad Core ARM Cortex-A9, PL310 L2CC
252 Homepage: http://www.marvell.com/digital-entertainment/armada-1500-pro/
253 Product Brief: http://www.marvell.com/digital-entertainment/armada-1500-pro/assets/Marvell_ARMADA_1500_PRO-01_product_brief.pdf
254 88DE???? 255 88DE????
255 Design name: BG3 256 Design name: BG3
256 Core: ARM Cortex-A15, CA15 integrated L2CC 257 Core: ARM Cortex-A15, CA15 integrated L2CC
257 258
258 Homepage: http://www.marvell.com/digital-entertainment/ 259 Homepage: http://www.marvell.com/multimedia-solutions/
259 Directory: arch/arm/mach-berlin 260 Directory: arch/arm/mach-berlin
260 261
261 Comments: 262 Comments:
diff --git a/Documentation/block/cfq-iosched.txt b/Documentation/block/cfq-iosched.txt
index f3bc72945cbd..1e4f835a659d 100644
--- a/Documentation/block/cfq-iosched.txt
+++ b/Documentation/block/cfq-iosched.txt
@@ -81,14 +81,13 @@ on higher end storage.
81 81
82Default value for this parameter is 8ms. 82Default value for this parameter is 8ms.
83 83
84latency 84low_latency
85------- 85-----------
86This parameter is used to enable/disable the latency mode of the CFQ 86This parameter is used to enable/disable the low latency mode of the CFQ
87scheduler. If latency mode (called low_latency) is enabled, CFQ tries 87scheduler. If enabled, CFQ tries to recompute the slice time for each process
88to recompute the slice time for each process based on the target_latency set 88based on the target_latency set for the system. This favors fairness over
89for the system. This favors fairness over throughput. Disabling low 89throughput. Disabling low latency (setting it to 0) ignores target latency,
90latency (setting it to 0) ignores target latency, allowing each process in the 90allowing each process in the system to get a full time slice.
91system to get a full time slice.
92 91
93By default low latency mode is enabled. 92By default low latency mode is enabled.
94 93
diff --git a/Documentation/cpu-hotplug.txt b/Documentation/cpu-hotplug.txt
index f9ad5e048b11..dd68821c22d4 100644
--- a/Documentation/cpu-hotplug.txt
+++ b/Documentation/cpu-hotplug.txt
@@ -150,7 +150,7 @@ an entry as shown below in the output.
150 150
151If this is not mounted, do the following. 151If this is not mounted, do the following.
152 152
153 #mkdir /sysfs 153 #mkdir /sys
154 #mount -t sysfs sys /sys 154 #mount -t sysfs sys /sys
155 155
156Now you should see entries for all present cpu, the following is an example 156Now you should see entries for all present cpu, the following is an example
diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt
index e95aa1c6eadf..fde9fd06fa98 100644
--- a/Documentation/filesystems/proc.txt
+++ b/Documentation/filesystems/proc.txt
@@ -820,7 +820,7 @@ by migrate-type and finishes with details on how many page blocks of each
820type exist. 820type exist.
821 821
822If min_free_kbytes has been tuned correctly (recommendations made by hugeadm 822If min_free_kbytes has been tuned correctly (recommendations made by hugeadm
823from libhugetlbfs http://sourceforge.net/projects/libhugetlbfs/), one can 823from libhugetlbfs https://github.com/libhugetlbfs/libhugetlbfs/), one can
824make an estimate of the likely number of huge pages that can be allocated 824make an estimate of the likely number of huge pages that can be allocated
825at a given point in time. All the "Movable" blocks should be allocatable 825at a given point in time. All the "Movable" blocks should be allocatable
826unless memory has been mlock()'d. Some of the Reclaimable blocks should 826unless memory has been mlock()'d. Some of the Reclaimable blocks should
diff --git a/Documentation/filesystems/sharedsubtree.txt b/Documentation/filesystems/sharedsubtree.txt
index 32a173dd3158..e3f4c778eb98 100644
--- a/Documentation/filesystems/sharedsubtree.txt
+++ b/Documentation/filesystems/sharedsubtree.txt
@@ -664,7 +664,7 @@ replicas continue to be exactly same.
664 if one rbind mounts a tree within the same subtree 'n' times 664 if one rbind mounts a tree within the same subtree 'n' times
665 the number of mounts created is an exponential function of 'n'. 665 the number of mounts created is an exponential function of 'n'.
666 Having unbindable mount can help prune the unneeded bind 666 Having unbindable mount can help prune the unneeded bind
667 mounts. Here is a example. 667 mounts. Here is an example.
668 668
669 step 1: 669 step 1:
670 let's say the root tree has just two directories with 670 let's say the root tree has just two directories with
diff --git a/Documentation/gpio/consumer.txt b/Documentation/gpio/consumer.txt
index e000502fde20..05676fdacfe3 100644
--- a/Documentation/gpio/consumer.txt
+++ b/Documentation/gpio/consumer.txt
@@ -260,7 +260,7 @@ will be driven low.
260 260
261To summarize: 261To summarize:
262 262
263Function (example) active-low proporty physical line 263Function (example) active-low property physical line
264gpiod_set_raw_value(desc, 0); don't care low 264gpiod_set_raw_value(desc, 0); don't care low
265gpiod_set_raw_value(desc, 1); don't care high 265gpiod_set_raw_value(desc, 1); don't care high
266gpiod_set_value(desc, 0); default (active-high) low 266gpiod_set_value(desc, 0); default (active-high) low
diff --git a/Documentation/gpio/driver.txt b/Documentation/gpio/driver.txt
index 12a61948ec91..bbeec415f406 100644
--- a/Documentation/gpio/driver.txt
+++ b/Documentation/gpio/driver.txt
@@ -113,8 +113,8 @@ GPIO irqchips usually fall in one of two categories:
113 it will be threaded IRQ handler on -RT and hard IRQ handler on non-RT 113 it will be threaded IRQ handler on -RT and hard IRQ handler on non-RT
114 (for example, see [3]). 114 (for example, see [3]).
115 Know W/A: The generic_handle_irq() is expected to be called with IRQ disabled, 115 Know W/A: The generic_handle_irq() is expected to be called with IRQ disabled,
116 so IRQ core will complain if it will be called from IRQ handler wich is forced 116 so IRQ core will complain if it will be called from IRQ handler which is
117 thread. The "fake?" raw lock can be used to W/A this problem: 117 forced thread. The "fake?" raw lock can be used to W/A this problem:
118 118
119 raw_spinlock_t wa_lock; 119 raw_spinlock_t wa_lock;
120 static irqreturn_t omap_gpio_irq_handler(int irq, void *gpiobank) 120 static irqreturn_t omap_gpio_irq_handler(int irq, void *gpiobank)
@@ -224,7 +224,7 @@ Real-Time compliance for GPIO IRQ chips
224--------------------------------------- 224---------------------------------------
225 225
226Any provider of irqchips needs to be carefully tailored to support Real Time 226Any provider of irqchips needs to be carefully tailored to support Real Time
227preemption. It is desireable that all irqchips in the GPIO subsystem keep this 227preemption. It is desirable that all irqchips in the GPIO subsystem keep this
228in mind and does the proper testing to assure they are real time-enabled. 228in mind and does the proper testing to assure they are real time-enabled.
229So, pay attention on above " RT_FULL:" notes, please. 229So, pay attention on above " RT_FULL:" notes, please.
230The following is a checklist to follow when preparing a driver for real 230The following is a checklist to follow when preparing a driver for real
diff --git a/Documentation/gpio/drivers-on-gpio.txt b/Documentation/gpio/drivers-on-gpio.txt
index f6121328630f..14bf95a13bae 100644
--- a/Documentation/gpio/drivers-on-gpio.txt
+++ b/Documentation/gpio/drivers-on-gpio.txt
@@ -54,7 +54,7 @@ hardware descriptions such as device tree or ACPI:
54 drivers for the I2C devices on the bus like any other I2C bus driver. 54 drivers for the I2C devices on the bus like any other I2C bus driver.
55 55
56- spi_gpio: drivers/spi/spi-gpio.c is used to drive an SPI bus (variable number 56- spi_gpio: drivers/spi/spi-gpio.c is used to drive an SPI bus (variable number
57 of wires, atleast SCK and optionally MISO, MOSI and chip select lines) using 57 of wires, at least SCK and optionally MISO, MOSI and chip select lines) using
58 GPIO hammering (bitbang). It will appear as any other SPI bus on the system 58 GPIO hammering (bitbang). It will appear as any other SPI bus on the system
59 and makes it possible to connect drivers for SPI devices on the bus like 59 and makes it possible to connect drivers for SPI devices on the bus like
60 any other SPI bus driver. For example any MMC/SD card can then be connected 60 any other SPI bus driver. For example any MMC/SD card can then be connected
@@ -75,7 +75,7 @@ hardware descriptions such as device tree or ACPI:
75 75
76- gpio-wdt: drivers/watchdog/gpio_wdt.c is used to provide a watchdog timer 76- gpio-wdt: drivers/watchdog/gpio_wdt.c is used to provide a watchdog timer
77 that will periodically "ping" a hardware connected to a GPIO line by toggling 77 that will periodically "ping" a hardware connected to a GPIO line by toggling
78 it from 1-to-0-to-1. If that hardware does not recieve its "ping" 78 it from 1-to-0-to-1. If that hardware does not receive its "ping"
79 periodically, it will reset the system. 79 periodically, it will reset the system.
80 80
81- gpio-nand: drivers/mtd/nand/gpio.c is used to connect a NAND flash chip to 81- gpio-nand: drivers/mtd/nand/gpio.c is used to connect a NAND flash chip to
@@ -91,5 +91,5 @@ usually connected directly to the flash.
91 91
92Use those instead of talking directly to the GPIOs using sysfs; they integrate 92Use those instead of talking directly to the GPIOs using sysfs; they integrate
93with kernel frameworks better than your userspace code could. Needless to say, 93with kernel frameworks better than your userspace code could. Needless to say,
94just using the apropriate kernel drivers will simplify and speed up your 94just using the appropriate kernel drivers will simplify and speed up your
95embedded hacking in particular by providing ready-made components. 95embedded hacking in particular by providing ready-made components.
diff --git a/Documentation/ioctl/botching-up-ioctls.txt b/Documentation/ioctl/botching-up-ioctls.txt
index 45fe78c58019..cc30b14791cb 100644
--- a/Documentation/ioctl/botching-up-ioctls.txt
+++ b/Documentation/ioctl/botching-up-ioctls.txt
@@ -122,7 +122,7 @@ Time, Waiting and Missing it
122---------------------------- 122----------------------------
123 123
124GPUs do most everything asynchronously, so we have a need to time operations and 124GPUs do most everything asynchronously, so we have a need to time operations and
125wait for oustanding ones. This is really tricky business; at the moment none of 125wait for outstanding ones. This is really tricky business; at the moment none of
126the ioctls supported by the drm/i915 get this fully right, which means there's 126the ioctls supported by the drm/i915 get this fully right, which means there's
127still tons more lessons to learn here. 127still tons more lessons to learn here.
128 128
@@ -146,7 +146,7 @@ still tons more lessons to learn here.
146 ioctl restartable relative timeouts tend to be too coarse and can 146 ioctl restartable relative timeouts tend to be too coarse and can
147 indefinitely extend your wait time due to rounding on each restart. 147 indefinitely extend your wait time due to rounding on each restart.
148 Especially if your reference clock is something really slow like the display 148 Especially if your reference clock is something really slow like the display
149 frame counter. With a spec laywer hat on this isn't a bug since timeouts can 149 frame counter. With a spec lawyer hat on this isn't a bug since timeouts can
150 always be extended - but users will surely hate you if their neat animations 150 always be extended - but users will surely hate you if their neat animations
151 starts to stutter due to this. 151 starts to stutter due to this.
152 152
@@ -176,7 +176,7 @@ entails its own little set of pitfalls:
176 176
177 * Ensure that you have sufficient insulation between different clients. By 177 * Ensure that you have sufficient insulation between different clients. By
178 default pick a private per-fd namespace which forces any sharing to be done 178 default pick a private per-fd namespace which forces any sharing to be done
179 explictly. Only go with a more global per-device namespace if the objects 179 explicitly. Only go with a more global per-device namespace if the objects
180 are truly device-unique. One counterexample in the drm modeset interfaces is 180 are truly device-unique. One counterexample in the drm modeset interfaces is
181 that the per-device modeset objects like connectors share a namespace with 181 that the per-device modeset objects like connectors share a namespace with
182 framebuffer objects, which mostly are not shared at all. A separate 182 framebuffer objects, which mostly are not shared at all. A separate
diff --git a/Documentation/ja_JP/HOWTO b/Documentation/ja_JP/HOWTO
index 5a0f2bdc2cf9..8d5465d3fdef 100644
--- a/Documentation/ja_JP/HOWTO
+++ b/Documentation/ja_JP/HOWTO
@@ -245,7 +245,7 @@ Linux カーネルソースツリーの中に含まれる、きれいにし、
245自己参照方式で、索引がついた web 形式で、ソースコードを参照することが 245自己参照方式で、索引がついた web 形式で、ソースコードを参照することが
246できます。この最新の素晴しいカーネルコードのリポジトリは以下で見つかり 246できます。この最新の素晴しいカーネルコードのリポジトリは以下で見つかり
247ます- 247ます-
248 http://lxr.linux.no/+trees 248 http://lxr.free-electrons.com/
249 249
250開発プロセス 250開発プロセス
251----------------------- 251-----------------------
@@ -366,7 +366,6 @@ http://patchwork.kernel.org/ でリストされています。
366に全サブシステムツリーからほぼ毎日プルされてできる特別なテスト用のリ 366に全サブシステムツリーからほぼ毎日プルされてできる特別なテスト用のリ
367ポジトリが存在します- 367ポジトリが存在します-
368 http://git.kernel.org/?p=linux/kernel/git/next/linux-next.git 368 http://git.kernel.org/?p=linux/kernel/git/next/linux-next.git
369 http://linux.f-seidel.de/linux-next/pmwiki/
370 369
371このやり方によって、-next カーネルは次のマージ機会でどんなものがメイン 370このやり方によって、-next カーネルは次のマージ機会でどんなものがメイン
372ラインカーネルにマージされるか、おおまかなの展望を提供します。-next 371ラインカーネルにマージされるか、おおまかなの展望を提供します。-next
diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
index 08913361e054..fe217c1c2f7f 100644
--- a/Documentation/kernel-docs.txt
+++ b/Documentation/kernel-docs.txt
@@ -631,7 +631,7 @@
631 between two versions of a file". 631 between two versions of a file".
632 632
633 * Name: "Cross-Referencing Linux" 633 * Name: "Cross-Referencing Linux"
634 URL: http://lxr.linux.no/source/ 634 URL: http://lxr.free-electrons.com/
635 Keywords: Browsing source code. 635 Keywords: Browsing source code.
636 Description: Another web-based Linux kernel source code browser. 636 Description: Another web-based Linux kernel source code browser.
637 Lots of cross references to variables and functions. You can see 637 Lots of cross references to variables and functions. You can see
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt
index 5a6235ed3663..3ea869d7a31c 100644
--- a/Documentation/kernel-parameters.txt
+++ b/Documentation/kernel-parameters.txt
@@ -2748,10 +2748,16 @@ bytes respectively. Such letter suffixes can also be entirely omitted.
2748 hardware access methods are allowed. Use this 2748 hardware access methods are allowed. Use this
2749 if you experience crashes upon bootup and you 2749 if you experience crashes upon bootup and you
2750 suspect they are caused by the BIOS. 2750 suspect they are caused by the BIOS.
2751 conf1 [X86] Force use of PCI Configuration 2751 conf1 [X86] Force use of PCI Configuration Access
2752 Mechanism 1. 2752 Mechanism 1 (config address in IO port 0xCF8,
2753 conf2 [X86] Force use of PCI Configuration 2753 data in IO port 0xCFC, both 32-bit).
2754 Mechanism 2. 2754 conf2 [X86] Force use of PCI Configuration Access
2755 Mechanism 2 (IO port 0xCF8 is an 8-bit port for
2756 the function, IO port 0xCFA, also 8-bit, sets
2757 bus number. The config space is then accessed
2758 through ports 0xC000-0xCFFF).
2759 See http://wiki.osdev.org/PCI for more info
2760 on the configuration access mechanisms.
2755 noaer [PCIE] If the PCIEAER kernel config parameter is 2761 noaer [PCIE] If the PCIEAER kernel config parameter is
2756 enabled, this kernel boot option can be used to 2762 enabled, this kernel boot option can be used to
2757 disable the use of PCIE advanced error reporting. 2763 disable the use of PCIE advanced error reporting.
@@ -3071,9 +3077,6 @@ bytes respectively. Such letter suffixes can also be entirely omitted.
3071 raid= [HW,RAID] 3077 raid= [HW,RAID]
3072 See Documentation/md.txt. 3078 See Documentation/md.txt.
3073 3079
3074 ramdisk_blocksize= [RAM]
3075 See Documentation/blockdev/ramdisk.txt.
3076
3077 ramdisk_size= [RAM] Sizes of RAM disks in kilobytes 3080 ramdisk_size= [RAM] Sizes of RAM disks in kilobytes
3078 See Documentation/blockdev/ramdisk.txt. 3081 See Documentation/blockdev/ramdisk.txt.
3079 3082
diff --git a/Documentation/ko_KR/HOWTO b/Documentation/ko_KR/HOWTO
index dc2ff8f611e0..1aef53e6cb98 100644
--- a/Documentation/ko_KR/HOWTO
+++ b/Documentation/ko_KR/HOWTO
@@ -213,7 +213,7 @@ Documentation/DocBook/ 디렉토리 내에서 만들어지며 PDF, Postscript, H
213것은 Linux Cross-Reference project이며 그것은 자기 참조 방식이며 213것은 Linux Cross-Reference project이며 그것은 자기 참조 방식이며
214소스코드를 인덱스된 웹 페이지들의 형태로 보여준다. 최신의 멋진 커널 214소스코드를 인덱스된 웹 페이지들의 형태로 보여준다. 최신의 멋진 커널
215코드 저장소는 다음을 통하여 참조할 수 있다. 215코드 저장소는 다음을 통하여 참조할 수 있다.
216 http://lxr.linux.no/+trees 216 http://lxr.free-electrons.com/
217 217
218 218
219개발 프로세스 219개발 프로세스
@@ -222,16 +222,16 @@ Documentation/DocBook/ 디렉토리 내에서 만들어지며 PDF, Postscript, H
222리눅스 커널 개발 프로세스는 현재 몇몇 다른 메인 커널 "브랜치들"과 222리눅스 커널 개발 프로세스는 현재 몇몇 다른 메인 커널 "브랜치들"과
223서브시스템에 특화된 커널 브랜치들로 구성된다. 몇몇 다른 메인 223서브시스템에 특화된 커널 브랜치들로 구성된다. 몇몇 다른 메인
224브랜치들은 다음과 같다. 224브랜치들은 다음과 같다.
225 - main 3.x 커널 트리 225 - main 4.x 커널 트리
226 - 3.x.y - 안정된 커널 트리 226 - 4.x.y - 안정된 커널 트리
227 - 3.x -git 커널 패치들 227 - 4.x -git 커널 패치들
228 - 서브시스템을 위한 커널 트리들과 패치들 228 - 서브시스템을 위한 커널 트리들과 패치들
229 - 3.x - 통합 테스트를 위한 next 커널 트리 229 - 4.x - 통합 테스트를 위한 next 커널 트리
230 230
2313.x 커널 트리 2314.x 커널 트리
232--------------- 232---------------
233 233
2343.x 커널들은 Linux Torvalds가 관리하며 kernel.org의 pub/linux/kernel/v3.x/ 2344.x 커널들은 Linux Torvalds가 관리하며 kernel.org의 pub/linux/kernel/v4.x/
235디렉토리에서 참조될 수 있다.개발 프로세스는 다음과 같다. 235디렉토리에서 참조될 수 있다.개발 프로세스는 다음과 같다.
236 - 새로운 커널이 배포되자마자 2주의 시간이 주어진다. 이 기간동은 236 - 새로운 커널이 배포되자마자 2주의 시간이 주어진다. 이 기간동은
237 메인테이너들은 큰 diff들을 Linus에게 제출할 수 있다. 대개 이 패치들은 237 메인테이너들은 큰 diff들을 Linus에게 제출할 수 있다. 대개 이 패치들은
@@ -262,20 +262,20 @@ Andrew Morton의 글이 있다.
262 버그의 상황에 따라 배포되는 것이지 미리정해 놓은 시간에 따라 262 버그의 상황에 따라 배포되는 것이지 미리정해 놓은 시간에 따라
263 배포되는 것은 아니기 때문이다." 263 배포되는 것은 아니기 때문이다."
264 264
2653.x.y - 안정 커널 트리 2654.x.y - 안정 커널 트리
266------------------------ 266------------------------
267 267
2683 자리 숫자로 이루어진 버젼의 커널들은 -stable 커널들이다. 그것들은 3.x 2683 자리 숫자로 이루어진 버젼의 커널들은 -stable 커널들이다. 그것들은 4.x
269커널에서 발견된 큰 회귀들이나 보안 문제들 중 비교적 작고 중요한 수정들을 269커널에서 발견된 큰 회귀들이나 보안 문제들 중 비교적 작고 중요한 수정들을
270포함한다. 270포함한다.
271 271
272이것은 가장 최근의 안정적인 커널을 원하는 사용자에게 추천되는 브랜치이며, 272이것은 가장 최근의 안정적인 커널을 원하는 사용자에게 추천되는 브랜치이며,
273개발/실험적 버젼을 테스트하는 것을 돕고자 하는 사용자들과는 별로 관련이 없다. 273개발/실험적 버젼을 테스트하는 것을 돕고자 하는 사용자들과는 별로 관련이 없다.
274 274
275어떤 3.x.y 커널도 사용할 수 없다면 그때는 가장 높은 숫자의 3.x 275어떤 4.x.y 커널도 사용할 수 없다면 그때는 가장 높은 숫자의 4.x
276커널이 현재의 안정 커널이다. 276커널이 현재의 안정 커널이다.
277 277
2783.x.y는 "stable" 팀<stable@vger.kernel.org>에 의해 관리되며 거의 매번 격주로 2784.x.y는 "stable" 팀<stable@vger.kernel.org>에 의해 관리되며 거의 매번 격주로
279배포된다. 279배포된다.
280 280
281커널 트리 문서들 내에 Documentation/stable_kernel_rules.txt 파일은 어떤 281커널 트리 문서들 내에 Documentation/stable_kernel_rules.txt 파일은 어떤
@@ -283,7 +283,7 @@ Andrew Morton의 글이 있다.
283진행되는지를 설명한다. 283진행되는지를 설명한다.
284 284
285 285
2863.x -git 패치들 2864.x -git 패치들
287------------------ 287------------------
288git 저장소(그러므로 -git이라는 이름이 붙음)에는 날마다 관리되는 Linus의 288git 저장소(그러므로 -git이라는 이름이 붙음)에는 날마다 관리되는 Linus의
289커널 트리의 snapshot 들이 있다. 이 패치들은 일반적으로 날마다 배포되며 289커널 트리의 snapshot 들이 있다. 이 패치들은 일반적으로 날마다 배포되며
@@ -312,13 +312,12 @@ Linus의 트리의 현재 상태를 나타낸다. 이 패치들은 정상적인
312대부분의 이러한 patchwork 사이트는 http://patchwork.kernel.org/ 또는 312대부분의 이러한 patchwork 사이트는 http://patchwork.kernel.org/ 또는
313http://patchwork.ozlabs.org/ 에 나열되어 있다. 313http://patchwork.ozlabs.org/ 에 나열되어 있다.
314 314
3153.x - 통합 테스트를 위한 next 커널 트리 3154.x - 통합 테스트를 위한 next 커널 트리
316----------------------------------------- 316-----------------------------------------
317서브시스템 트리들의 변경사항들은 mainline 3.x 트리로 들어오기 전에 통합 317서브시스템 트리들의 변경사항들은 mainline 4.x 트리로 들어오기 전에 통합
318테스트를 거쳐야 한다. 이런 목적으로, 모든 서브시스템 트리의 변경사항을 거의 318테스트를 거쳐야 한다. 이런 목적으로, 모든 서브시스템 트리의 변경사항을 거의
319매일 받아가는 특수한 테스트 저장소가 존재한다: 319매일 받아가는 특수한 테스트 저장소가 존재한다:
320 http://git.kernel.org/?p=linux/kernel/git/sfr/linux-next.git 320 http://git.kernel.org/?p=linux/kernel/git/sfr/linux-next.git
321 http://linux.f-seidel.de/linux-next/pmwiki/
322 321
323이런 식으로, -next 커널을 통해 다음 머지 기간에 메인라인 커널에 어떤 변경이 322이런 식으로, -next 커널을 통해 다음 머지 기간에 메인라인 커널에 어떤 변경이
324가해질 것인지 간략히 알 수 있다. 모험심 강한 테스터라면 -next 커널에서 테스트를 323가해질 것인지 간략히 알 수 있다. 모험심 강한 테스터라면 -next 커널에서 테스트를
diff --git a/Documentation/networking/can.txt b/Documentation/networking/can.txt
index 05fd83bb3596..6ab619fcc517 100644
--- a/Documentation/networking/can.txt
+++ b/Documentation/networking/can.txt
@@ -372,6 +372,15 @@ solution for a couple of reasons:
372 nbytes = sendto(s, &frame, sizeof(struct can_frame), 372 nbytes = sendto(s, &frame, sizeof(struct can_frame),
373 0, (struct sockaddr*)&addr, sizeof(addr)); 373 0, (struct sockaddr*)&addr, sizeof(addr));
374 374
375 An accurate timestamp can be obtained with an ioctl(2) call after reading
376 a message from the socket:
377
378 struct timeval tv;
379 ioctl(s, SIOCGSTAMP, &tv);
380
381 The timestamp has a resolution of one microsecond and is set automatically
382 at the reception of a CAN frame.
383
375 Remark about CAN FD (flexible data rate) support: 384 Remark about CAN FD (flexible data rate) support:
376 385
377 Generally the handling of CAN FD is very similar to the formerly described 386 Generally the handling of CAN FD is very similar to the formerly described
diff --git a/Documentation/stable_kernel_rules.txt b/Documentation/stable_kernel_rules.txt
index 3049a612291b..ffd4575ec9f2 100644
--- a/Documentation/stable_kernel_rules.txt
+++ b/Documentation/stable_kernel_rules.txt
@@ -93,7 +93,7 @@ format in the sign-off area:
93Also, some patches may have kernel version prerequisites. This can be 93Also, some patches may have kernel version prerequisites. This can be
94specified in the following format in the sign-off area: 94specified in the following format in the sign-off area:
95 95
96 Cc: <stable@vger.kernel.org> # 3.3.x- 96 Cc: <stable@vger.kernel.org> # 3.3.x-
97 97
98 The tag has the meaning of: 98 The tag has the meaning of:
99 git cherry-pick <this commit> 99 git cherry-pick <this commit>
diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
index 10f062ea6bc2..8c745c8931da 100644
--- a/Documentation/thermal/sysfs-api.txt
+++ b/Documentation/thermal/sysfs-api.txt
@@ -364,6 +364,7 @@ integral_cutoff
364 accumulates error when temperature is above the desired 364 accumulates error when temperature is above the desired
365 temperature trip point. For more information see 365 temperature trip point. For more information see
366 Documentation/thermal/power_allocator.txt 366 Documentation/thermal/power_allocator.txt
367 Unit: millidegree Celsius
367 RW, Optional 368 RW, Optional
368 369
369slope 370slope
diff --git a/Documentation/vm/slub.txt b/Documentation/vm/slub.txt
index 699d8ea5c230..f0d340959319 100644
--- a/Documentation/vm/slub.txt
+++ b/Documentation/vm/slub.txt
@@ -8,7 +8,7 @@ SLUB can enable debugging only for selected slabs in order to avoid
8an impact on overall system performance which may make a bug more 8an impact on overall system performance which may make a bug more
9difficult to find. 9difficult to find.
10 10
11In order to switch debugging on one can add a option "slub_debug" 11In order to switch debugging on one can add an option "slub_debug"
12to the kernel command line. That will enable full debugging for 12to the kernel command line. That will enable full debugging for
13all slabs. 13all slabs.
14 14
diff --git a/init/do_mounts_rd.c b/init/do_mounts_rd.c
index e5d059e8aa11..8a09b32e07d6 100644
--- a/init/do_mounts_rd.c
+++ b/init/do_mounts_rd.c
@@ -216,13 +216,6 @@ int __init rd_load_image(char *from)
216 /* 216 /*
217 * NOTE NOTE: nblocks is not actually blocks but 217 * NOTE NOTE: nblocks is not actually blocks but
218 * the number of kibibytes of data to load into a ramdisk. 218 * the number of kibibytes of data to load into a ramdisk.
219 * So any ramdisk block size that is a multiple of 1KiB should
220 * work when the appropriate ramdisk_blocksize is specified
221 * on the command line.
222 *
223 * The default ramdisk_blocksize is 1KiB and it is generally
224 * silly to use anything else, so make sure to use 1KiB
225 * blocksize while generating ext2fs ramdisk-images.
226 */ 219 */
227 if (sys_ioctl(out_fd, BLKGETSIZE, (unsigned long)&rd_blocks) < 0) 220 if (sys_ioctl(out_fd, BLKGETSIZE, (unsigned long)&rd_blocks) < 0)
228 rd_blocks = 0; 221 rd_blocks = 0;
diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index 638a38e1b419..c37255bb620d 100755
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -1816,6 +1816,8 @@ sub dump_struct($$) {
1816 $members =~ s/__attribute__\s*\(\([a-z,_\*\s\(\)]*\)\)//i; 1816 $members =~ s/__attribute__\s*\(\([a-z,_\*\s\(\)]*\)\)//i;
1817 $members =~ s/__aligned\s*\([^;]*\)//gos; 1817 $members =~ s/__aligned\s*\([^;]*\)//gos;
1818 $members =~ s/\s*CRYPTO_MINALIGN_ATTR//gos; 1818 $members =~ s/\s*CRYPTO_MINALIGN_ATTR//gos;
1819 # replace DECLARE_BITMAP
1820 $members =~ s/DECLARE_BITMAP\s*\(([^,)]+), ([^,)]+)\)/unsigned long $1\[BITS_TO_LONGS($2)\]/gos;
1819 1821
1820 create_parameterlist($members, ';', $file); 1822 create_parameterlist($members, ';', $file);
1821 check_sections($file, $declaration_name, "struct", $sectcheck, $struct_actual, $nested); 1823 check_sections($file, $declaration_name, "struct", $sectcheck, $struct_actual, $nested);
@@ -1844,7 +1846,8 @@ sub dump_enum($$) {
1844 my $file = shift; 1846 my $file = shift;
1845 1847
1846 $x =~ s@/\*.*?\*/@@gos; # strip comments. 1848 $x =~ s@/\*.*?\*/@@gos; # strip comments.
1847 $x =~ s/^#\s*define\s+.*$//; # strip #define macros inside enums 1849 # strip #define macros inside enums
1850 $x =~ s@#\s*((define|ifdef)\s+|endif)[^;]*;@@gos;
1848 1851
1849 if ($x =~ /enum\s+(\w+)\s*{(.*)}/) { 1852 if ($x =~ /enum\s+(\w+)\s*{(.*)}/) {
1850 $declaration_name = $1; 1853 $declaration_name = $1;