/*
 * Copyright (c) 2008 Intel Corporation
 * Author: Matthew Wilcox <willy@linux.intel.com>
 *
 * Distributed under the terms of the GNU GPL, version 2
 *
 * Please see kernel/semaphore.c for documentation of these functions
 */
#ifndef __LINUX_SEMAPHORE_H
#define __LINUX_SEMAPHORE_H

#include <linux/list.h>
#include <linux/spinlock.h>

/* Please don't access any members of this structure directly */
struct semaphore {
	raw_spinlock_t		lock;
	unsigned int		count;
	struct list_head	wait_list;
};

#define __SEMAPHORE_INITIALIZER(name, n)				\
{									\
	.lock		= __RAW_SPIN_LOCK_UNLOCKED((name).lock),	\
	.count		= n,						\
	.wait_list	= LIST_HEAD_INIT((name).wait_list),		\
}

#define DEFINE_SEMAPHORE(name)	\
	struct semaphore name = __SEMAPHORE_INITIALIZER(name, 1)

static inline void sema_init(struct semaphore *sem, int val)
{
	static struct lock_class_key __key;
	*sem = (struct semaphore) __SEMAPHORE_INITIALIZER(*sem, val);
	lockdep_init_map(&sem->lock.dep_map, "semaphore->lock", &__key, 0);
}

extern void down(struct semaphore *sem);
extern int __must_check down_interruptible(struct semaphore *sem);
extern int __must_check down_killable(struct semaphore *sem);
extern int __must_check down_trylock(struct semaphore *sem);
extern int __must_check down_timeout(struct semaphore *sem, long jiffies);
extern void up(struct semaphore *sem);

#endif /* __LINUX_SEMAPHORE_H */
-2.6.17.y'>linux-2.6.17.y</option>
<option value='linux-2.6.18.y'>linux-2.6.18.y</option>
<option value='linux-2.6.19.y'>linux-2.6.19.y</option>
<option value='linux-2.6.20.y'>linux-2.6.20.y</option>
<option value='linux-2.6.21.y'>linux-2.6.21.y</option>
<option value='linux-2.6.22.y'>linux-2.6.22.y</option>
<option value='linux-2.6.23.y'>linux-2.6.23.y</option>
<option value='linux-2.6.24.y'>linux-2.6.24.y</option>
<option value='linux-2.6.25.y'>linux-2.6.25.y</option>
<option value='linux-2.6.26.y'>linux-2.6.26.y</option>
<option value='linux-2.6.27.y'>linux-2.6.27.y</option>
<option value='linux-2.6.28.y'>linux-2.6.28.y</option>
<option value='linux-2.6.29.y'>linux-2.6.29.y</option>
<option value='linux-2.6.30.y'>linux-2.6.30.y</option>
<option value='linux-2.6.31.y'>linux-2.6.31.y</option>
<option value='linux-2.6.32.y'>linux-2.6.32.y</option>
<option value='linux-2.6.33.y'>linux-2.6.33.y</option>
<option value='linux-2.6.34.y'>linux-2.6.34.y</option>
<option value='linux-2.6.35.y'>linux-2.6.35.y</option>
<option value='linux-2.6.36.y'>linux-2.6.36.y</option>
<option value='linux-2.6.37.y'>linux-2.6.37.y</option>
<option value='linux-2.6.38.y'>linux-2.6.38.y</option>
<option value='linux-2.6.39.y'>linux-2.6.39.y</option>
<option value='linux-3.0.y'>linux-3.0.y</option>
<option value='linux-3.1.y'>linux-3.1.y</option>
<option value='linux-3.10.y'>linux-3.10.y</option>
<option value='linux-3.11.y'>linux-3.11.y</option>
<option value='linux-3.12.y'>linux-3.12.y</option>
<option value='linux-3.13.y'>linux-3.13.y</option>
<option value='linux-3.14.y'>linux-3.14.y</option>
<option value='linux-3.15.y'>linux-3.15.y</option>
<option value='linux-3.16.y'>linux-3.16.y</option>
<option value='linux-3.17.y'>linux-3.17.y</option>
<option value='linux-3.18.y'>linux-3.18.y</option>
<option value='linux-3.19.y'>linux-3.19.y</option>
<option value='linux-3.2.y'>linux-3.2.y</option>
<option value='linux-3.3.y'>linux-3.3.y</option>
<option value='linux-3.4.y'>linux-3.4.y</option>
<option value='linux-3.5.y'>linux-3.5.y</option>
<option value='linux-3.6.y'>linux-3.6.y</option>
<option value='linux-3.7.y'>linux-3.7.y</option>
<option value='linux-3.8.y'>linux-3.8.y</option>
<option value='linux-3.9.y'>linux-3.9.y</option>
<option value='linux-4.0.y'>linux-4.0.y</option>
<option value='linux-4.1.y'>linux-4.1.y</option>
<option value='linux-4.10.y'>linux-4.10.y</option>
<option value='linux-4.11.y'>linux-4.11.y</option>
<option value='linux-4.12.y'>linux-4.12.y</option>
<option value='linux-4.13.y'>linux-4.13.y</option>
<option value='linux-4.14.y'>linux-4.14.y</option>
<option value='linux-4.15.y'>linux-4.15.y</option>
<option value='linux-4.16.y'>linux-4.16.y</option>
<option value='linux-4.17.y'>linux-4.17.y</option>
<option value='linux-4.18.y'>linux-4.18.y</option>
<option value='linux-4.19.y'>linux-4.19.y</option>
<option value='linux-4.2.y'>linux-4.2.y</option>
<option value='linux-4.20.y'>linux-4.20.y</option>
<option value='linux-4.3.y'>linux-4.3.y</option>
<option value='linux-4.4.y'>linux-4.4.y</option>
<option value='linux-4.5.y'>linux-4.5.y</option>
<option value='linux-4.6.y'>linux-4.6.y</option>
<option value='linux-4.7.y'>linux-4.7.y</option>
<option value='linux-4.8.y'>linux-4.8.y</option>
<option value='linux-4.9.y'>linux-4.9.y</option>
<option value='linux-5.0.y'>linux-5.0.y</option>
<option value='linux-5.1.y'>linux-5.1.y</option>
<option value='linux-5.10.y'>linux-5.10.y</option>
<option value='linux-5.11.y'>linux-5.11.y</option>
<option value='linux-5.12.y'>linux-5.12.y</option>
<option value='linux-5.13.y'>linux-5.13.y</option>
<option value='linux-5.14.y'>linux-5.14.y</option>
<option value='linux-5.15.y'>linux-5.15.y</option>
<option value='linux-5.16.y'>linux-5.16.y</option>
<option value='linux-5.17.y'>linux-5.17.y</option>
<option value='linux-5.18.y'>linux-5.18.y</option>
<option value='linux-5.19.y'>linux-5.19.y</option>
<option value='linux-5.2.y'>linux-5.2.y</option>
<option value='linux-5.3.y'>linux-5.3.y</option>
<option value='linux-5.4.y'>linux-5.4.y</option>
<option value='linux-5.5.y'>linux-5.5.y</option>
<option value='linux-5.6.y'>linux-5.6.y</option>
<option value='linux-5.7.y'>linux-5.7.y</option>
<option value='linux-5.8.y'>linux-5.8.y</option>
<option value='linux-5.9.y'>linux-5.9.y</option>
<option value='linux-6.0.y'>linux-6.0.y</option>
<option value='linux-6.1.y'>linux-6.1.y</option>
<option value='linux-6.10.y'>linux-6.10.y</option>
<option value='linux-6.11.y'>linux-6.11.y</option>
<option value='linux-6.12.y'>linux-6.12.y</option>
<option value='linux-6.13.y'>linux-6.13.y</option>
<option value='linux-6.14.y'>linux-6.14.y</option>
<option value='linux-6.15.y'>linux-6.15.y</option>
<option value='linux-6.16.y'>linux-6.16.y</option>
<option value='linux-6.17.y'>linux-6.17.y</option>
<option value='linux-6.18.y'>linux-6.18.y</option>
<option value='linux-6.19.y'>linux-6.19.y</option>
<option value='linux-6.2.y'>linux-6.2.y</option>
<option value='linux-6.3.y'>linux-6.3.y</option>
<option value='linux-6.4.y'>linux-6.4.y</option>
<option value='linux-6.5.y'>linux-6.5.y</option>
<option value='linux-6.6.y'>linux-6.6.y</option>
<option value='linux-6.7.y'>linux-6.7.y</option>
<option value='linux-6.8.y'>linux-6.8.y</option>
<option value='linux-6.9.y'>linux-6.9.y</option>
<option value='linux-rolling-lts'>linux-rolling-lts</option>
<option value='linux-rolling-stable'>linux-rolling-stable</option>
<option value='master'>master</option>
</select> <input type='submit' value='switch'/></form></td></tr>
<tr><td class='sub'>Hosts the 0x221E linux distro kernel.</td><td class='sub right'>Ubuntu</td></tr></table>
<table class='tabs'><tr><td>
<a href='/distro/kernel/'>summary</a><a href='/distro/kernel/refs/?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a'>refs</a><a class='active' href='/distro/kernel/log/Documentation/w1?showmsg=1'>log</a><a href='/distro/kernel/tree/Documentation/w1?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a'>tree</a><a href='/distro/kernel/commit/Documentation/w1?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a'>commit</a><a href='/distro/kernel/diff/Documentation/w1?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a'>diff</a></td><td class='form'><form class='right' method='get' action='/distro/kernel/log/Documentation/w1'>
<input type='hidden' name='id' value='ed5fce76b5ea40c87b44cafbe4f3222da8ec981a'/><input type='hidden' name='showmsg' value='1'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/distro/kernel/log/?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a&amp;showmsg=1'>root</a>/<a href='/distro/kernel/log/Documentation?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a&amp;showmsg=1'>Documentation</a>/<a href='/distro/kernel/log/Documentation/w1?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a&amp;showmsg=1'>w1</a></div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/distro/kernel/log/Documentation/w1?id=ed5fce76b5ea40c87b44cafbe4f3222da8ec981a'>Collapse</a>)</th><th class='left'>Author</th></tr>
<tr class='logheader'><td><span title='2022-04-05 10:19:42 -0600'>2022-04-05</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=7808c934120e6ffa95c0b11d3e079cb617f195fc'>w1: w1_therm: Document Maxim MAX31850 thermoelement IF.</a></td><td>Markus Reichl</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
w1_therm driver supports now MAX31850, too. Add it to documentation
and fix a small typo.

Signed-off-by: Markus Reichl &lt;m.reichl@fivetechno.de&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-09-16 21:02:09 -0500'>2021-09-16</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=bb667205406c6faa955e0fef6eee879b0d386381'>dt-bindings: w1: update w1-gpio.yaml reference</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Changeset dd2c898bc20b ("dt-bindings: w1: Convert 1-Wire GPIO binding to a schema")
renamed: Documentation/devicetree/bindings/w1/w1-gpio.txt
to: Documentation/devicetree/bindings/w1/w1-gpio.yaml.

Update its cross-reference accordingly.

Fixes: dd2c898bc20b ("dt-bindings: w1: Convert 1-Wire GPIO binding to a schema")
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;
Signed-off-by: Rob Herring &lt;robh@kernel.org&gt;
Link: https://lore.kernel.org/r/0b415b5e05bcf9d593cb421c96996d914528e732.1631785820.git.mchehab+huawei@kernel.org


</td></tr>
<tr class='logheader'><td><span title='2021-05-26 09:11:24 +0200'>2021-05-26</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=83aacfbcbd42eec3882423bbafcb8b3190376ed8'>w1: fix build warning in w1_ds2438.rst</a></td><td>Greg Kroah-Hartman</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
commit c999fbbdcf77 ("w1: ds2438: support for writing to offset
register") added more documentation, but had a one-off line for the
header of a section which caused the build warning:

	Documentation/w1/slaves/w1_ds2438.rst:56: WARNING: Title underline too short.

Resolve this by fixing the underline to be long enough.

Reported-by: Stephen Rothwell &lt;sfr@canb.auug.org.au&gt;
Link: https://lore.kernel.org/r/YKthRzCGan9WEcmP@kroah.com
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-05-21 14:51:33 +0200'>2021-05-21</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=c999fbbdcf778c2ea77f59e26d7448a1ab8fa8a2'>w1: ds2438: support for writing to offset register</a></td><td>Luiz Sampaio</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Added a sysfs entry to support writing to the offset register on page1.
This register is used to calibrate the chip canceling offset errors in the
current ADC. This means that, over time, reading the IAD register will not
return the correct current measurement, it will have an offset. Writing to
the offset register if the two's complement of the current register while
passing zero current to the load will calibrate the measurements. This
change was tested on real hardware and it was able to calibrate the chip
correctly.

Signed-off-by: Luiz Sampaio &lt;sampaio.ime@gmail.com&gt;
Link: https://lore.kernel.org/r/20210519223046.13798-7-sampaio.ime@gmail.com
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-05-21 14:51:33 +0200'>2021-05-21</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=fd6ec5d79507f99639c94f107e8a98550c9e1cf6'>w1: ds2438: adding support for reading page1</a></td><td>Luiz Sampaio</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Added a sysfs entry to support reading the page1 registers. This registers
contain Elapsed Time Meter (ETM) data, which shows for how long the chip is
on, as well as an Offset Register data, which can be used to calibrate the
current measurement of the chip.

Signed-off-by: Luiz Sampaio &lt;sampaio.ime@gmail.com&gt;
Link: https://lore.kernel.org/r/20210519223046.13798-6-sampaio.ime@gmail.com
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-11-12 08:50:13 +0100'>2020-11-12</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=439e8f6f1e5d1ca973da278499078e213dad63bb'>w1: w1_therm: Rename conflicting sysfs attribute 'eeprom' to 'eeprom_cmd'</a></td><td>Ivan Zaentsev</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Duplicate attribute 'eeprom' is defined in:
1) Documentation/ABI/testing/sysfs-driver-w1_therm
2) Documentation/ABI/stable/sysfs-driver-w1_ds28e04

Both drivers define an attribute: /sys/bus/w1/devices/.../eeprom
with conflicting behavior.

Fix by renaming the newer one in w1_therm.c to 'eeprom_cmd'.

Reported-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;
Suggested-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;
Link: https://lore.kernel.org/lkml/20201029152845.6bbb39ce@coco.lan/
Signed-off-by: Ivan Zaentsev &lt;ivan.zaentsev@wirenboard.ru&gt;
Link: https://lore.kernel.org/r/20201112064931.8471-1-ivan.zaentsev@wirenboard.ru
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-10-08 09:47:15 +0200'>2020-10-08</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=78eef5d952610b8a9c94cfee19ab83b64135e189'>docs: w1: w1_therm: Fix broken xref, mistakes, clarify text</a></td><td>Ivan Zaentsev</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
sysfs attribute names are mixed with the same normal text terms.
Use ReST to distinguish.

Fix typos and mistakes.

Reported-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;
Signed-off-by: Ivan Zaentsev &lt;ivan.zaentsev@wirenboard.ru&gt;
Link: https://lore.kernel.org/r/20201008054259.5461-1-ivan.zaentsev@wirenboard.ru
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-10-02 11:49:54 +0200'>2020-10-02</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=9ace0b4dab1c3913810c50948d714afcbd2c767e'>w1: w1_therm: Add support for GXCAS GX20MH01 device.</a></td><td>Ivan Zaentsev</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
GX20MH01 device shares family number 0x28 with DS18B20. The device
is generally compatible with DS18B20. Added are the lowest 2^-5, 2^-6
temperature bits in Config register; R2 bit in Config register
enabling 13 and 14 bit resolutions. It is powered up in 14 bit mode.

Signed-off-by: Ivan Zaentsev &lt;ivan.zaentsev@wirenboard.ru&gt;
Link: https://lore.kernel.org/r/20200904160004.87710-2-ivan.zaentsev@wirenboard.ru
Acked-by: Evgeniy Polyakov &lt;zbr@ioremap.net&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-10-02 11:49:50 +0200'>2020-10-02</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=021da53e65fdd0e1b8492c2670dd075c0ea910fc'>w1: w1_therm: Add sysfs entries to control conversion time and driver features</a></td><td>Ivan Zaentsev</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The conversion time of common DS18B20 clones deviates from
datasheet specs. Allow adjustment and automatic measure of the
conversion time.

Add 'conv_time' sysfs attribute:
  *read*: Current conversion time in milliseconds.
  *write*:
     '0': Set default conversion time.
     '1': Measure and set the conversion time. Make a
          single temperature conversion, poll and measure
          an actual value. Measured value is increased
          by 20% for temperature drift. A new conversion
          time is returned by reading the same attribute.
     other positive value:
        Set the conversion time in milliseconds.

The setting is active until a resolution change. Then it is reset to
default conversion time for a new resolution.

Add 'features' sysfs attribute to control optional driver settings
per device. Bit masks to read/write (logical OR):
  1: Enable check for conversion success. If byte 6 of
     scratchpad memory is 0xC after conversion, and
     temperature reads 85.00 (powerup value) or 127.94
     (insufficient power) - return a conversion error.

  2: Enable poll for conversion completion. Generate read cycles
     after the conversion start and wait for 1's. In parasite
     power mode this feature is not available.

There are some clones of DS18B20 with fixed 12 bit resolution. Make the
driver verify the resolution by reading back the device after resolution
change.

Signed-off-by: Ivan Zaentsev &lt;ivan.zaentsev@wirenboard.ru&gt;
Acked-by: Evgeniy Polyakov &lt;zbr@ioremap.net&gt;
Link: https://lore.kernel.org/r/20200904160004.87710-1-ivan.zaentsev@wirenboard.ru
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-05-15 16:29:00 +0200'>2020-05-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=57c76221d5af648c8355a55c09b050c5d8d38189'>w1_therm: adding bulk read support to trigger multiple conversion on bus</a></td><td>Akira Shimahara</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Adding bulk read support:
Sending a 'trigger' command in the dedicated sysfs entry of bus master
device send a conversion command for all the slaves on the bus. The sysfs
entry is added as soon as at least one device supporting this feature
is detected on the bus.

The behavior of the sysfs reading temperature on the device is as follow:
 * If no bulk read pending, trigger a conversion on the device, wait for
 the conversion to be done, read the temperature in device RAM
 * If a bulk read has been trigger, access directly the device RAM
This behavior is the same on the 2 sysfs entries ('temperature' and
'w1_slave').

Reading the therm_bulk_read sysfs give the status of bulk operations:
 * '-1': conversion in progress on at least 1 sensor
 * '1': conversion complete but at least one sensor has not been read yet
 * '0': no bulk operation. Reading temperature on ecah device will trigger
a conversion

As not all devices support bulk read feature, it has been added in device
family structure.

The attribute is set at master level as soon as a supporting device is
discover. It is removed when the last supported device leave the bus.
The count of supported device is kept with the static counter
bulk_read_device_counter.

A strong pull up is apply on the line if at least one device required it.
The duration of the pull up is the max time required by a device on the
line, which depends on the resolution settings of each device. The strong
pull up could be adjust with the a module parameter.

Updating documentation in Documentation/ABI/testing/sysfs-driver-w1_therm
and Documentation/w1/slaves/w1_therm.rst accordingly.

Signed-off-by: Akira Shimahara &lt;akira215corp@gmail.com&gt;
Link: https://lore.kernel.org/r/20200511203820.411483-1-akira215corp@gmail.com
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-12-30 11:58:02 -0700'>2019-12-30</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=6c23821c19305d9f9e3166492483425845b84f3a'>docs: w1: Fix a typo in omap-hdq.rst</a></td><td>Masanari Iida</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Fix a spelling typo in omap-hdq.rst

Signed-off-by: Masanari Iida &lt;standby24x7@gmail.com&gt;
Link: https://lore.kernel.org/r/20191225165534.9395-1-standby24x7@gmail.com
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-10-18 09:45:56 -0600'>2019-10-18</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=d8fb03e1ea64e78b9d2af677e6614c2d88e842d2'>docs: w1: Fix SPDX-License-Identifier syntax</a></td><td>Jonathan Neuschäfer</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
ReST directives are introduced with two dots.

Signed-off-by: Jonathan Neuschäfer &lt;j.neuschaefer@gmx.net&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-07-31 14:16:17 -0600'>2019-07-31</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=e9bb627561535dd584b43a8c0afe93a67bc6a2c5'>docs: w1: convert to ReST and add to the kAPI group of docs</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The 1wire documentation was written with w1 developers in
mind, so, it makes sense to add it together with the driver-api
set.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-07-15 11:03:02 -0300'>2019-07-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=baa293e9544bea71361950d071579f0e4d5713ed'>docs: driver-api: add a series of orphaned documents</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
There are lots of documents under Documentation/*.txt and a few other
orphan documents elsehwere that belong to the driver-API book.

Move them to their right place.

Reviewed-by: Cornelia Huck &lt;cohuck@redhat.com&gt; # vfio-related parts
Acked-by: Logan Gunthorpe &lt;logang@deltatee.com&gt; # switchtec
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2018-09-09 15:08:58 -0600'>2018-09-09</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=a7ddcea58ae22d85d94eabfdd3de75c3742e376b'>Drop all 00-INDEX files from Documentation/</a></td><td>Henrik Austad</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This is a respin with a wider audience (all that get_maintainer returned)
and I know this spams a *lot* of people. Not sure what would be the correct
way, so my apologies for ruining your inbox.

The 00-INDEX files are supposed to give a summary of all files present
in a directory, but these files are horribly out of date and their
usefulness is brought into question. Often a simple "ls" would reveal
the same information as the filenames are generally quite descriptive as
a short introduction to what the file covers (it should not surprise
anyone what Documentation/sched/sched-design-CFS.txt covers)

A few years back it was mentioned that these files were no longer really
needed, and they have since then grown further out of date, so perhaps
it is time to just throw them out.

A short status yields the following _outdated_ 00-INDEX files, first
counter is files listed in 00-INDEX but missing in the directory, last
is files present but not listed in 00-INDEX.

List of outdated 00-INDEX:
Documentation: (4/10)
Documentation/sysctl: (0/1)
Documentation/timers: (1/0)
Documentation/blockdev: (3/1)
Documentation/w1/slaves: (0/1)
Documentation/locking: (0/1)
Documentation/devicetree: (0/5)
Documentation/power: (1/1)
Documentation/powerpc: (0/5)
Documentation/arm: (1/0)
Documentation/x86: (0/9)
Documentation/x86/x86_64: (1/1)
Documentation/scsi: (4/4)
Documentation/filesystems: (2/9)
Documentation/filesystems/nfs: (0/2)
Documentation/cgroup-v1: (0/2)
Documentation/kbuild: (0/4)
Documentation/spi: (1/0)
Documentation/virtual/kvm: (1/0)
Documentation/scheduler: (0/2)
Documentation/fb: (0/1)
Documentation/block: (0/1)
Documentation/networking: (6/37)
Documentation/vm: (1/3)

Then there are 364 subdirectories in Documentation/ with several files that
are missing 00-INDEX alltogether (and another 120 with a single file and no
00-INDEX).

I don't really have an opinion to whether or not we /should/ have 00-INDEX,
but the above 00-INDEX should either be removed or be kept up to date. If
we should keep the files, I can try to keep them updated, but I rather not
if we just want to delete them anyway.

As a starting point, remove all index-files and references to 00-INDEX and
see where the discussion is going.

Signed-off-by: Henrik Austad &lt;henrik@austad.us&gt;
Acked-by: "Paul E. McKenney" &lt;paulmck@linux.vnet.ibm.com&gt;
Just-do-it-by: Steven Rostedt &lt;rostedt@goodmis.org&gt;
Reviewed-by: Jens Axboe &lt;axboe@kernel.dk&gt;
Acked-by: Paul Moore &lt;paul@paul-moore.com&gt;
Acked-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;
Acked-by: Mark Brown &lt;broonie@kernel.org&gt;
Acked-by: Mike Rapoport &lt;rppt@linux.vnet.ibm.com&gt;
Cc: [Almost everybody else]
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2018-07-07 17:27:13 +0200'>2018-07-07</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=c7e5a5b4f0371dac0888e2be7c59273d8e4c013f'>w1: fix w1_ds2438 documentation</a></td><td>Mariusz Bialonczyk</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The previous documentation was wrongly stating about the order
of magnitude of CONVERT_V result files contents (vad, vdd).
This commit is correcting this.

Reported-by: Adam Stolarczyk &lt;adam@stolarczyk.net.pl&gt;
Signed-off-by: Mariusz Bialonczyk &lt;manio@skyboo.net&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2018-01-31 19:25:25 -0800'>2018-01-31</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=255442c93843f52b6891b21d0b485bf2c97f93c3'>Merge tag 'docs-4.16' of git://git.lwn.net/linux</a></td><td>Linus Torvalds</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Pull documentation updates from Jonathan Corbet:
 "Documentation updates for 4.16.

  New stuff includes refcount_t documentation, errseq documentation,
  kernel-doc support for nested structure definitions, the removal of
  lots of crufty kernel-doc support for unused formats, SPDX tag
  documentation, the beginnings of a manual for subsystem maintainers,
  and lots of fixes and updates.

  As usual, some of the changesets reach outside of Documentation/ to
  effect kerneldoc comment fixes. It also adds the new LICENSES
  directory, of which Thomas promises I do not need to be the
  maintainer"

* tag 'docs-4.16' of git://git.lwn.net/linux: (65 commits)
  linux-next: docs-rst: Fix typos in kfigure.py
  linux-next: DOC: HWPOISON: Fix path to debugfs in hwpoison.txt
  Documentation: Fix misconversion of #if
  docs: add index entry for networking/msg_zerocopy
  Documentation: security/credentials.rst: explain need to sort group_list
  LICENSES: Add MPL-1.1 license
  LICENSES: Add the GPL 1.0 license
  LICENSES: Add Linux syscall note exception
  LICENSES: Add the MIT license
  LICENSES: Add the BSD-3-clause "Clear" license
  LICENSES: Add the BSD 3-clause "New" or "Revised" License
  LICENSES: Add the BSD 2-clause "Simplified" license
  LICENSES: Add the LGPL-2.1 license
  LICENSES: Add the LGPL 2.0 license
  LICENSES: Add the GPL 2.0 license
  Documentation: Add license-rules.rst to describe how to properly identify file licenses
  scripts: kernel_doc: better handle show warnings logic
  fs/*/Kconfig: drop links to 404-compliant http://acl.bestbits.at
  doc: md: Fix a file name to md-fault.c in fault-injection.txt
  errseq: Add to documentation tree
  ...


</td></tr>
<tr class='logheader'><td><span title='2017-12-21 13:39:28 -0700'>2017-12-21</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=d6f44b3bd870ff5946fcd4293b4c07029d8d93c9'>Fixed typo in onewire generic doc</a></td><td>Gergo Huszty</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Onewire devices has 6 byte long unique serial numbers, 1 byte family
code and 1 byte CRC. Linux sysfs presents the device folder in the
form of familyID-deviceID, so CRC is not shown. The consequence is
that the device serial number is always a 12 long hex-string, but
doc says 13 in one place. This is corrected by this change.
Reference: https://en.wikipedia.org/wiki/1-Wire

Signed-off-by: Gergo Huszty &lt;huszty.gergo@digitaltrip.hu&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2017-12-08 15:32:53 +0100'>2017-12-08</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=e0fc62a6552f3d9c21e73cc65844f9aad1892cf7'>w1: w1-gpio: Convert to use GPIO descriptors</a></td><td>Linus Walleij</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The w1 master driver includes a complete open drain emulation
reimplementation among other things.

This converts the driver and all board files using it to use
GPIO descriptors associated with the device to look up the
GPIO wire, as well ass the optional pull-up GPIO line.

When probed from the device tree, the driver will just pick
descriptors and use them right off. For the two board files
in the kernel, we add descriptor lookups so we do not need
to keep any old platform data handling around for the GPIO
lines.

As the platform data is also a state container for this driver,
we augment it to contain the GPIO descriptors.

w1_gpio_write_bit_dir() and w1_gpio_write_bit_val() are gone
since this pair was a reimplementation of open drain emulation
which is now handled by gpiolib.

The special "linux,open-drain" flag is a bit of mishap here:
it has the same semantic as the same flags in I2C: it means
that something in the platform is setting up the line as
open drain behind our back. We handle this the same way as
in I2C.

To drive the pull-up, we need to bypass open drain emulation
in gpiolib for the line, and this is done by driving it high
using gpiod_set_raw_value() which has been augmented to have
the semantic of overriding the open drain emulation.

We also augment the documentation to reflect the way to pass
GPIO descriptors from the machine.

Acked-by: Evgeniy Polyakov &lt;zbr@ioremap.net&gt;
Signed-off-by: Linus Walleij &lt;linus.walleij@linaro.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2017-10-04 10:29:22 +0200'>2017-10-04</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=ebc4768ac4971eab4b570e733e47ac9dfd0e4175'>add w1_ds28e17 driver for the DS28E17 Onewire to I2C master bridge</a></td><td>Jan Kandziora</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This subpatch adds a driver for the DS28E17 Onewire to I2C master bridge.

Signed-off-by: Jan Kandziora &lt;jjj@gmx.de&gt;
Acked-by: Evgeniy Polyakov &lt;zbr@ioremap.net&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2017-03-17 15:10:49 +0900'>2017-03-17</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=6d691550ea0d67a86be351bb78fcd6d28bb60fff'>w1: add documentation for w1_ds2438</a></td><td>Mariusz Bialonczyk</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Signed-off-by: Mariusz Bialonczyk &lt;manio@skyboo.net&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2017-03-17 15:10:49 +0900'>2017-03-17</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/w1?id=a9ee205883a36e3d51dff5b8f3a7c2c1c4fbab57'>w1: add missing DS2413 documentation</a></td><td>Mariusz Bialonczyk</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Signed-off-by: Mariusz Bialonczyk &lt;manio@skyboo.net&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;


</td></tr>