by Dmitry Torokhov

[permalink] [raw]

Subject: [RFC/PATCH 21/22] W1: implement standard hotplug handler

Ahem.. Kmail just refuses send this on inline... Sorry.

--
Dmitry

Attachments:

(No filename) (67.00 B)
w1-hotplug.patch (2.15 kB)
Download all attachments

On Thu, 2005-04-21 at 02:07 -0500, Dmitry Torokhov wrote:
> Hi,

Hello, Dmitry.

> I happened to take a look into drivers/w1 and found there bunch of thigs
> that IMO should be changed:
>
> - custom-made refcounting is racy

Why do you think so?
Did you find exactly the place which races against something?

> - lifetime rules need to be better enforced

Hmm, I misunderstand you.

> - family framework is insufficient for many advanced w1 devices

No, family framework is just indication which family is used.
Feel free to implement additional methods for various devices
and store them in driver's private areas like ipaq does.

> - custom-made hotplug notification over netlink should be removed in favor
> of standard hotplug notification

It is not hotplug, and your changes broke it completely.
I'm waiting for connector to be included or discarded, so I can move
w1 on top of it's interface or move connector's bits into the w1
subsystem.

> - sysfs attributes have unnecessary prefixes (like w1_master) or not needed
> at all (w1_master_pointer)

Yep, some of them can be suspicious from the first point of view.

> Please consider series of patches below. Unfortunately I do not have any W1
> equipment so it was only compile-tested. Please also note that lifetime and
> locking rules were changed on object-by-object base so mid-series some stuff
> may appear broken but as far as I can see the end result shoudl work pretty
> well.

I can test your changes next week, but I already have too many
objections
to apply the whole patch set.

> w1-whitespace.patch
> Whitespace fixes.
>
> w1-formatting.patch
> Some formatting changes to bring the code in line with CodingStyle
> guidelines.

Both above look ok, although they will not apply after patches
already sent to Greg but not yet in the tree are applied.

> w1-master-attr-group.patch
> Use attribute_group to create master device attributes to guarantee
> proper cleanup in case of failure. Also, hide most of attribute define
> ugliness in macros.

Yep, I like it.

> w1-slave-attr-group.patc
> Add 2 default attributes "family" and "serial" to slave devices, every
> 1-Wire slave has them. Use attribute_group to handle. The rest of slave
> attributes are left as is - will be dealt with later.

Serial number is already there in bus_id, family is there too.
Why do you need separate files?

> w1-lists-cleanup.patch
> List handling cleanup. Most of the list_for_each_safe users don't need
> *_safe variant, *_entry variant is better suited in most places. Also,
> checking retrieved list element for null is a bit pointless...

Yep, it is correct.

> w1-drop-owner.patch
> Drop owner field from w1_master and w1_slave structures. Just having it
> there does not magically fixes lifetime rules.

They do not even pretend, I still do not understand what is "lifetime
rules"?

> w1-bus-ops.patch
> Cleanup bus operations code:
> - have bus operatiions accept w1_master instead of unsigned long and
> drop data field from w1_bus_master so the structure can be statically
> allocated by driver implementing it;
> - rename w1_bus_master to w1_bus_ops to avoid confusion with w1_master;
> - separate master registering and allocation so drivers can setup proper
> link between private data and master and set useable master's name.

I strongly object against such changes.
1. w1 was designed in the way that w1 bus master drivers do not
know about other w1 world. It is very simple and very low-level
abstraction,
that only understands how to do low-level functions. It is not needed
do know about w1_master structure and even about it's existence.
2. All renaming are superfluous, I'm not against it, but completely do
not
understand it's merits.
3. You broke netlink allocation routing - it may fail and it is not
fatal.

> w1-fold-w1-int.patch
> Fold w1_int.c into w1.c - there is no point in artificially separating
> code for master devices between 2 files.

w1_int.c was created to store external interface implementation,
why do you want to move it into w1 core code?
It will only soil the code...

> w1-drop-netlink.patch
> Drop custom-made hotplug over netlink notification from w1 core.
> Standard hotplug mechanism should work just fine (patch will follow).

netlink notification was not created for hotplug.
Also I'm against w1 hotplug support, since hotplug is quite rarely used
in embedded platforms where the majority of w1 devices live.
I mean not to completely forget this idea,
but implement it in the way it will not hurt existing model.

> w1-drop-control-thread.patch
> Drop control thread from w1 core, whatever it does can also be done in
> the context of w1_remove_master_device. Also, pin the module when
> registering new master device to make sure that w1 core is not unloaded
> until last device is gone. This simplifies logic a lot.

Why do you think master can be removed in safe context only?
I have feature requests for both adding/removing and exporting
master devices and slaves to the external world.
Control thread is also the place in which we kick all devices
when we need it, but not only when we need to remove w1 core module.

> w1-move-search-to-io.patch
> Move w1_search function to w1_io.c to be with the rest of IO code.

w1_search() is high-level protocol method, w1_io.c only contains
calls for low-level methods like bite/byte banging, reset, HW search and
so on.

> w1-master-drop-attrs.patch
> Get rid of unneeded master device attributes:
> - 'pointer' and 'attempts' are meaningless for userspace;
> - information provided by 'slaves' and 'slave_count' can be gathered
> from other sysfs bits;
> - w1_slave_found has to be rearranged now that slave_count field is gone.

attempts is usefull for broken lines.
pointer was definitely for debug, it can be removed now.

> w1-master-attr-cleanup.patch
> Clean-up master attribute implementation:
> - drop unnecessary "w1_master" prefix from attribute names;
> - do not acquire master->mutex when accessing attributes;
> - move attribute code "closer" to the rest of master code.

Ok, but slave count and slaves attributes itself requires that mutex.

> w1-master-scan-interval.patch
> More master attributes changes:
> - rename timeout parameter/attribute to scan_interval to better
> reflect its purpose;
> - make scan_timeout be a per-device attribute and allow changing
> it from userspace via sysfs;
> - allow changing max_slave_count it from userspace as well.

I like that change, but why do you ned to change the name?

> w1-master-add-ttl-attr.patch
> Add slave_ttl attribute to w1 masters.

Ok.

> w1-master-cleanup.patch
> Clean-up master device implementation:
> - get rid of separate refcount, rely on driver model to enforce
> lifetime rules;
> - use atomic to generate unique master IDs;
> - drop unused fields.

That patch is very broken.
I completely against it:
1. it breaks process logic - searching can be interrupted and stopped,
thread will exit on signals.
2. Your changes will break master/slave structure exporting.

> w1-slave-cleanup.patch
> Clean-up slave device implementation:
> - get rid of separate refcount, rely on driver model to enforce
> lifetime rules;
> - pin w1 module until slave device is registered with sysfs to make
> sure W1 core stays loaded.
> - drop 'name' attribute as we already have it in bus_id.

The same and even worse.

> w1-family-cleanup.patch
> Clean-up family implementation:
> - get rid of w1_family_ops and template attributes in w1_slave
> structure and have family drivers create necessary attributes
> themselves. There are too many different devices using 1-Wire
> interface and it is impossible to fit them all into single
> attribute model. If interface unification is needed it can be
> done by building cross-bus class hierarchy.
> - rename w1_smem to w1_sernum because devices are called Silicon
> serial numbers, they have address (ID) but don't have memory
> in regular sense.
> - rename w1_therm to w1_thermal.

smem == simple memory id, it is official name AFAIR.
Renames are superfluous, family_ops contains a "must have" operations,
driver writer can easily add it's own if it is needed.

> w1-family-is-driver.patch
> Convert family into proper device-model drivers:
> - embed driver structure into w1_family and register with the
> driver core;
> - do not try to manually bind slaves to familes, leave it to
> the driver core;
> - fold w1_family.c into w1.c

Why do you break it?
They were separated intentionally - it simplifies code review,
it is completely different logical models, family processing
is not hte same as slave.

> w1-device-id.patch
> Support for automatic family drivers loading via hotplug:
> - allow family drivers support list of families;
> - export supported families through MODULE_DEVICE_TABLE.
>
> w1-hotplug.patch
> Implement W1 bus hotplug handler. Slave devices will define
> FID=%02x (family ID) end SN=%024llX environment variables.

I'm against hotplug since it is too embedded world unfriendly :)
Actually it can be added, but as option, but not rely
the whole logic on it.

> w1-module-attrs.patch
> Allow changing w1 module parameters through sysfs, add parameter
> descriptions and document them in Documentation/kernel-parameters.txt
>
> Thanks!

Thank you very much for your changes and ideas,
but as you can see I'm against several of it.
The main reason is why dig into the driver model in a such way?
It will complicate strucutre exporting too much.
Existing locking/refcnt schema is very flexible and allows device
manipulation while it "holds" the reference counter,
and it will not be possible if one just blindly gets/puts module's
refcnt.
Object has reference counter which is incremented and decremented when
object is in use, not the whole module reference counter,
one may remove and add separate objects without knowledge of
what family or bus master driver handles that.
Your changes mix low-level driver logic with w1 core.
You have removed netlink notification and replace it with hotplug,
but it can not be used for systems without shell userspace support.

I will manually apply safe changes after Adrians changes
when Greg ACKs current pending patches.

--
Evgeniy Polyakov

Crash is better than data corruption -- Arthur Grabowski

Attachments:

signature.asc (189.00 B)
This is a digitally signed message part

2005-04-21 14:32:10

by Dmitry Torokhov

[permalink] [raw]

Subject: Re: [RFC/PATCH 0/22] W1: sysfs, lifetime and other fixes

Hi Evgeniy,

On 4/21/05, Evgeniy Polyakov <[email protected]> wrote:
> On Thu, 2005-04-21 at 02:07 -0500, Dmitry Torokhov wrote:
> > Hi,
>
> Hello, Dmitry.
>
> > I happened to take a look into drivers/w1 and found there bunch of thigs
> > that IMO should be changed:
> >
> > - custom-made refcounting is racy
>
> Why do you think so?
> Did you find exactly the place which races against something?
>
> > - lifetime rules need to be better enforced
>
> Hmm, I misunderstand you.
>

Consider thie following:

451 while (atomic_read(&sl->refcnt)) {
452 printk(KERN_INFO "Waiting for %s to become free:
refcnt=%d.\n",
453 sl->name, atomic_read(&sl->refcnt));
454
455 if (msleep_interruptible(1000))
456 flush_signals(current);
457 }
458
459 sysfs_remove_bin_file (&sl->dev.kobj, &sl->attr_bin);
460 device_remove_file(&sl->dev, &sl->attr_name);
461 device_remove_file(&sl->dev, &sl->attr_val);
462 device_unregister(&sl->dev);
463 w1_family_put(sl->family);
.. And caller does kfree(sl);

Now, if application opens slave's sysfs attribute while other thread
exited the loop and is about to remove attributes, then you will kfree
object that is in use and who knows what will happen. This is example
of both refcounting being racey and lifetime rules being violated.

> > - family framework is insufficient for many advanced w1 devices
>
> No, family framework is just indication which family is used.
> Feel free to implement additional methods for various devices
> and store them in driver's private areas like ipaq does.
>

OK, that is what I am aying. But why do you need that attribute with
variable name and a bin attribute that is not really bin but just a
dump for all kind of data (looks like debug one).

> > - custom-made hotplug notification over netlink should be removed in favor
> > of standard hotplug notification
>
> It is not hotplug, and your changes broke it completely.
> I'm waiting for connector to be included or discarded, so I can move
> w1 on top of it's interface or move connector's bits into the w1
> subsystem.
>

You will not be able to cram all 1-wire devices into unified
interface. You will need to build classes on top of it and you might
use connector (I am not sure) bit not on w1 bus level.
...
> > w1-slave-attr-group.patc
> > Add 2 default attributes "family" and "serial" to slave devices, every
> > 1-Wire slave has them. Use attribute_group to handle. The rest of slave
> > attributes are left as is - will be dealt with later.
>
> Serial number is already there in bus_id, family is there too.
> Why do you need separate files?

Yeah, could probably drop them.
...
> > w1-drop-owner.patch
> > Drop owner field from w1_master and w1_slave structures. Just having it
> > there does not magically fixes lifetime rules.
>
> They do not even pretend, I still do not understand what is "lifetime
> rules"?

So there is no point in having them, right?

>
> > w1-bus-ops.patch
> > Cleanup bus operations code:
> > - have bus operatiions accept w1_master instead of unsigned long and
> > drop data field from w1_bus_master so the structure can be statically
> > allocated by driver implementing it;
> > - rename w1_bus_master to w1_bus_ops to avoid confusion with w1_master;
> > - separate master registering and allocation so drivers can setup proper
> > link between private data and master and set useable master's name.
>
> I strongly object against such changes.
> 1. w1 was designed in the way that w1 bus master drivers do not
> know about other w1 world. It is very simple and very low-level
> abstraction,
> that only understands how to do low-level functions. It is not needed
> do know about w1_master structure and even about it's existence.

Well, it does need to know about w1_bus_master structure, which is
pretty much the same. And it allows having static bus_ops allocation
and removes need for casting from unsigned longs...

> 2. All renaming are superfluous, I'm not against it, but completely do
> not
> understand it's merits.

Because now it represents operations only, data field has been
dropped. I my head hurt when I see w1_master and w1_bus_muster
together as 2 separate objects both representing the same piece of
hardware.

> 3. You broke netlink allocation routing - it may fail and it is not
> fatal.

Because it is going away in later patcehs ;)

>
> > w1-fold-w1-int.patch
> > Fold w1_int.c into w1.c - there is no point in artificially separating
> > code for master devices between 2 files.
>
> w1_int.c was created to store external interface implementation,
> why do you want to move it into w1 core code?
> It will only soil the code...

Because I do not understand why code creating master devices is
separate from code creating master device's attributes.

>
> > w1-drop-netlink.patch
> > Drop custom-made hotplug over netlink notification from w1 core.
> > Standard hotplug mechanism should work just fine (patch will follow).
>
> netlink notification was not created for hotplug.
> Also I'm against w1 hotplug support, since hotplug is quite rarely used
> in embedded platforms where the majority of w1 devices live.

kobject_uevent does notification over netlink so I do not understand
why custom approach is better. You don't really need to use script.

> > w1-drop-control-thread.patch
> > Drop control thread from w1 core, whatever it does can also be done in
> > the context of w1_remove_master_device. Also, pin the module when
> > registering new master device to make sure that w1 core is not unloaded
> > until last device is gone. This simplifies logic a lot.
>
> Why do you think master can be removed in safe context only?

Can you show me example where you remove master from an interrupt
context or a tasklet? I doubt you will ever see one.

> I have feature requests for both adding/removing and exporting
> master devices and slaves to the external world.

External as in userspace? It (user thread) can wait just fine...

> Control thread is also the place in which we kick all devices
> when we need it, but not only when we need to remove w1 core module.

Define kicking for me please...

>
> > w1-move-search-to-io.patch
> > Move w1_search function to w1_io.c to be with the rest of IO code.
>
> w1_search() is high-level protocol method, w1_io.c only contains
> calls for low-level methods like bite/byte banging, reset, HW search and
> so on.

Well it does bit banging and completely foreign to the rest of w1
code. It may be high-level operation as fas as 1-wire on-wire protocol
goes, but it surely does not belong with kernel's W1 bus
implementattion code.

> > w1-master-attr-cleanup.patch
> > Clean-up master attribute implementation:
> > - drop unnecessary "w1_master" prefix from attribute names;
> > - do not acquire master->mutex when accessing attributes;
> > - move attribute code "closer" to the rest of master code.
>
> Ok, but slave count and slaves attributes itself requires that mutex.

They are gone. You can scan sysfs to get your slaves and count. Kernel
does not need to do that.

> > w1-master-scan-interval.patch
> > More master attributes changes:
> > - rename timeout parameter/attribute to scan_interval to better
> > reflect its purpose;
> > - make scan_timeout be a per-device attribute and allow changing
> > it from userspace via sysfs;
> > - allow changing max_slave_count it from userspace as well.
>
> I like that change, but why do you ned to change the name?

Because nothing times out (as in error). It defines interval between
scans -> scan_interval.

> > w1-master-cleanup.patch
> > Clean-up master device implementation:
> > - get rid of separate refcount, rely on driver model to enforce
> > lifetime rules;
> > - use atomic to generate unique master IDs;
> > - drop unused fields.
>
> That patch is very broken.
> I completely against it:
> 1. it breaks process logic - searching can be interrupted and stopped,
> thread will exit on signals.

Interrupted/stopped from userspace?

> 2. Your changes will break master/slave structure exporting.

-ENEEDMOREDATA.

>
> > w1-slave-cleanup.patch
> > Clean-up slave device implementation:
> > - get rid of separate refcount, rely on driver model to enforce
> > lifetime rules;
> > - pin w1 module until slave device is registered with sysfs to make
> > sure W1 core stays loaded.
> > - drop 'name' attribute as we already have it in bus_id.
>
> The same and even worse.

You need to fix lifetime rules.

> > w1-family-cleanup.patch
> > Clean-up family implementation:
> > - get rid of w1_family_ops and template attributes in w1_slave
> > structure and have family drivers create necessary attributes
> > themselves. There are too many different devices using 1-Wire
> > interface and it is impossible to fit them all into single
> > attribute model. If interface unification is needed it can be
> > done by building cross-bus class hierarchy.
> > - rename w1_smem to w1_sernum because devices are called Silicon
> > serial numbers, they have address (ID) but don't have memory
> > in regular sense.
> > - rename w1_therm to w1_thermal.
>
> smem == simple memory id, it is official name AFAIR.
> Renames are superfluous, family_ops contains a "must have" operations,
> driver writer can easily add it's own if it is needed.

What is so "must have" about 2 attributes? smem does not need anything
for exampe...

> > w1-family-is-driver.patch
> > Convert family into proper device-model drivers:
> > - embed driver structure into w1_family and register with the
> > driver core;
> > - do not try to manually bind slaves to familes, leave it to
> > the driver core;
> > - fold w1_family.c into w1.c
>
> Why do you break it?
> They were separated intentionally - it simplifies code review,
> it is completely different logical models, family processing
> is not hte same as slave.

Masters, slaves and families are all objects of W1 kernel bus. With
cutting a bunch of fat from family code it does not make sense to keep
them separate anymore.

>
> Thank you very much for your changes and ideas,
> but as you can see I'm against several of it.
> The main reason is why dig into the driver model in a such way?
> It will complicate strucutre exporting too much.

Because it is the standard for implementing devies and drivers in
linux kernel. You need to explain about exporting structure since the
rest of the system seem to be doing just fine.

> Existing locking/refcnt schema is very flexible and allows device
> manipulation while it "holds" the reference counter,

It is also racy and buggy.

> and it will not be possible if one just blindly gets/puts module's
> refcnt.

Only wire.ko is pinned. You are still free to remove family drivers or
master drivers (or killing their objects somehow). It is only core
that is pinned to make sure that release functions are available when
object finally goes away.

> Object has reference counter which is incremented and decremented when
> object is in use, not the whole module reference counter,
> one may remove and add separate objects without knowledge of
> what family or bus master driver handles that.

> Your changes mix low-level driver logic with w1 core.
> You have removed netlink notification and replace it with hotplug,
> but it can not be used for systems without shell userspace support.

kobject_uevent does not requere a sehll account.

Thank you for reviewing the patchset.

--
Dmitry

2005-04-21 16:09:39

by Dmitry Torokhov

[permalink] [raw]

Subject: Re: [RFC/PATCH 0/22] W1: sysfs, lifetime and other fixes

One more thing...

On 4/21/05, Evgeniy Polyakov <[email protected]> wrote:
> On Thu, 2005-04-21 at 02:07 -0500, Dmitry Torokhov wrote:
>
> > w1-master-drop-attrs.patch
> > Get rid of unneeded master device attributes:
> > - 'pointer' and 'attempts' are meaningless for userspace;
> > - information provided by 'slaves' and 'slave_count' can be gathered
> > from other sysfs bits;
> > - w1_slave_found has to be rearranged now that slave_count field is gone.
>
> attempts is usefull for broken lines.

It simply increments with every search i.e. every 10 secondsby default
and does not provide indication of the quality of the wire.

--
Dmitry

2005-04-25 09:10:49

by Evgeniy Polyakov

[permalink] [raw]

Subject: Re: [RFC/PATCH 0/22] W1: sysfs, lifetime and other fixes

On Thu, 2005-04-21 at 09:31 -0500, Dmitry Torokhov wrote:
> Hi Evgeniy,
>
> On 4/21/05, Evgeniy Polyakov <[email protected]> wrote:
> > On Thu, 2005-04-21 at 02:07 -0500, Dmitry Torokhov wrote:
> > > Hi,
> >
> > Hello, Dmitry.
> >
> > > I happened to take a look into drivers/w1 and found there bunch of thigs
> > > that IMO should be changed:
> > >
> > > - custom-made refcounting is racy
> >
> > Why do you think so?
> > Did you find exactly the place which races against something?
> >
> > > - lifetime rules need to be better enforced
> >
> > Hmm, I misunderstand you.
> >
>
> Consider thie following:
>
> 451 while (atomic_read(&sl->refcnt)) {
> 452 printk(KERN_INFO "Waiting for %s to become free:
> refcnt=%d.\n",
> 453 sl->name, atomic_read(&sl->refcnt));
> 454
> 455 if (msleep_interruptible(1000))
> 456 flush_signals(current);
> 457 }
> 458
> 459 sysfs_remove_bin_file (&sl->dev.kobj, &sl->attr_bin);
> 460 device_remove_file(&sl->dev, &sl->attr_name);
> 461 device_remove_file(&sl->dev, &sl->attr_val);
> 462 device_unregister(&sl->dev);
> 463 w1_family_put(sl->family);
> .. And caller does kfree(sl);
>
> Now, if application opens slave's sysfs attribute while other thread
> exited the loop and is about to remove attributes, then you will kfree
> object that is in use and who knows what will happen. This is example
> of both refcounting being racey and lifetime rules being violated.

Yes, I see now.
I will think of it some more...

> > > - family framework is insufficient for many advanced w1 devices
> >
> > No, family framework is just indication which family is used.
> > Feel free to implement additional methods for various devices
> > and store them in driver's private areas like ipaq does.
> >
>
> OK, that is what I am aying. But why do you need that attribute with
> variable name and a bin attribute that is not really bin but just a
> dump for all kind of data (looks like debug one).

bin attribute was created for lm_sensors scripts format - it only caches
read value.
I think there might be only 2 "must have" methods - read and write.
I plan to implement them using connector, so probably they will go away
completely.

> > > - custom-made hotplug notification over netlink should be removed in favor
> > > of standard hotplug notification
> >
> > It is not hotplug, and your changes broke it completely.
> > I'm waiting for connector to be included or discarded, so I can move
> > w1 on top of it's interface or move connector's bits into the w1
> > subsystem.
> >
>
> You will not be able to cram all 1-wire devices into unified
> interface. You will need to build classes on top of it and you might
> use connector (I am not sure) bit not on w1 bus level.
> ...

connector allows to have different objects inside one netlink group,
so it will use it in that way.
I think only two w1 methods must exist - read and write,
and they must follow protocol, defined in family driver.

> > > w1-drop-owner.patch
> > > Drop owner field from w1_master and w1_slave structures. Just having it
> > > there does not magically fixes lifetime rules.
> >
> > They do not even pretend, I still do not understand what is "lifetime
> > rules"?
>
> So there is no point in having them, right?

If I understand you correctly, "lifetime rules" are implemented in a
following way:
when object is created it has 0 refcnt, each access increments it and
must
decrements when access is finished.
According to mix of sysfs vs. current refcnt I see a possibility to
free object in ->relese()/remove() method and that is all, but I need to
investigate it more deeply.

> >
> > > w1-bus-ops.patch
> > > Cleanup bus operations code:
> > > - have bus operatiions accept w1_master instead of unsigned long and
> > > drop data field from w1_bus_master so the structure can be statically
> > > allocated by driver implementing it;
> > > - rename w1_bus_master to w1_bus_ops to avoid confusion with w1_master;
> > > - separate master registering and allocation so drivers can setup proper
> > > link between private data and master and set useable master's name.
> >
> > I strongly object against such changes.
> > 1. w1 was designed in the way that w1 bus master drivers do not
> > know about other w1 world. It is very simple and very low-level
> > abstraction,
> > that only understands how to do low-level functions. It is not needed
> > do know about w1_master structure and even about it's existence.
>
> Well, it does need to know about w1_bus_master structure, which is
> pretty much the same. And it allows having static bus_ops allocation
> and removes need for casting from unsigned longs...

w1_bus_master structure is low-level physical operations.
It _completely_ does not know abou logical links to other
w1 core objects, Why _bus_ driver should know about logical
objects on top of it? That is why they are separate.
Even if they are not too different (and actually they _are_ different)
from your point of view, they differ in abstration model.
Bus master driver - is like NIC driver, it does not know about the rest
of
the network stack, but you want it to have all info about neighbours,
routes
and so on...

> > 2. All renaming are superfluous, I'm not against it, but completely do
> > not
> > understand it's merits.
>
> Because now it represents operations only, data field has been
> dropped. I my head hurt when I see w1_master and w1_bus_muster
> together as 2 separate objects both representing the same piece of
> hardware.

No.

w1_bus_master is low-level driver for physical hardware operations.
w1_master is logical structure which is operated by w1 w1 core stack.
It has it's logical slaves, it has it's own attributes and features,
it _completely_ does not belong to low-level physical layer where you
want to place them both.

> > 3. You broke netlink allocation routing - it may fail and it is not
> > fatal.
>
> Because it is going away in later patcehs ;)

This is wrong - netlink notification is used and will be moved to
connector
interface later.

> >
> > > w1-fold-w1-int.patch
> > > Fold w1_int.c into w1.c - there is no point in artificially separating
> > > code for master devices between 2 files.
> >
> > w1_int.c was created to store external interface implementation,
> > why do you want to move it into w1 core code?
> > It will only soil the code...
>
> Because I do not understand why code creating master devices is
> separate from code creating master device's attributes.

It is better to move all attributes inside code creating master device
so place that attribute creating into w1_int.c

> >
> > > w1-drop-netlink.patch
> > > Drop custom-made hotplug over netlink notification from w1 core.
> > > Standard hotplug mechanism should work just fine (patch will follow).
> >
> > netlink notification was not created for hotplug.
> > Also I'm against w1 hotplug support, since hotplug is quite rarely used
> > in embedded platforms where the majority of w1 devices live.
>
> kobject_uevent does notification over netlink so I do not understand
> why custom approach is better. You don't really need to use script.

kobject is too big for that. It is used exactly for kobject changes.
Custom netlink notifications are created for w1 specific objects
and it's control. You can not control w1 slaves/masters using hotplug.

> > > w1-drop-control-thread.patch
> > > Drop control thread from w1 core, whatever it does can also be done in
> > > the context of w1_remove_master_device. Also, pin the module when
> > > registering new master device to make sure that w1 core is not unloaded
> > > until last device is gone. This simplifies logic a lot.
> >
> > Why do you think master can be removed in safe context only?
>
> Can you show me example where you remove master from an interrupt
> context or a tasklet? I doubt you will ever see one.

As I said I have feature requests for ability to export w1 devices
outside w1 core.
Probably it is due to it's private non-GPL usage, so it is not created,
but it is usefull feature actually and we can not know what will
happen in what context when we export master/slave devices.
w1 slaves can be found on the bus without search method reaction
implemented in it's asic, btw.
And it is _very_ usefull to add/remove slaves using external command but
not using
automatic detection in search methods.

> > I have feature requests for both adding/removing and exporting
> > master devices and slaves to the external world.
>
> External as in userspace? It (user thread) can wait just fine...

Exporting them into other kernel modules.
We do not know in what context that structures will be used there.

> > Control thread is also the place in which we kick all devices
> > when we need it, but not only when we need to remove w1 core module.
>
> Define kicking for me please...

Removing master device using netlink command for exaple.

> >
> > > w1-move-search-to-io.patch
> > > Move w1_search function to w1_io.c to be with the rest of IO code.
> >
> > w1_search() is high-level protocol method, w1_io.c only contains
> > calls for low-level methods like bite/byte banging, reset, HW search and
> > so on.
>
> Well it does bit banging and completely foreign to the rest of w1
> code. It may be high-level operation as fas as 1-wire on-wire protocol
> goes, but it surely does not belong with kernel's W1 bus
> implementattion code.

It does not only low-level operations,
but, well, probably it is better to place it there.

> > > w1-master-attr-cleanup.patch
> > > Clean-up master attribute implementation:
> > > - drop unnecessary "w1_master" prefix from attribute names;
> > > - do not acquire master->mutex when accessing attributes;
> > > - move attribute code "closer" to the rest of master code.
> >
> > Ok, but slave count and slaves attributes itself requires that mutex.
>
> They are gone. You can scan sysfs to get your slaves and count. Kernel
> does not need to do that.

I created that files exactly for reaason to not scan the tree, but only
read one [two] files :)

> > > w1-master-scan-interval.patch
> > > More master attributes changes:
> > > - rename timeout parameter/attribute to scan_interval to better
> > > reflect its purpose;
> > > - make scan_timeout be a per-device attribute and allow changing
> > > it from userspace via sysfs;
> > > - allow changing max_slave_count it from userspace as well.
> >
> > I like that change, but why do you ned to change the name?
>
> Because nothing times out (as in error). It defines interval between
> scans -> scan_interval.

Ok.

> > > w1-master-cleanup.patch
> > > Clean-up master device implementation:
> > > - get rid of separate refcount, rely on driver model to enforce
> > > lifetime rules;
> > > - use atomic to generate unique master IDs;
> > > - drop unused fields.
> >
> > That patch is very broken.
> > I completely against it:
> > 1. it breaks process logic - searching can be interrupted and stopped,
> > thread will exit on signals.
>
> Interrupted/stopped from userspace?

Your loop waits only until interrupt happens - it can be delivered from
anywhere.

> > 2. Your changes will break master/slave structure exporting.
>
> -ENEEDMOREDATA.

I think I described it in a master exporting paragraph, let's drop it
here.

> >
> > > w1-slave-cleanup.patch
> > > Clean-up slave device implementation:
> > > - get rid of separate refcount, rely on driver model to enforce
> > > lifetime rules;
> > > - pin w1 module until slave device is registered with sysfs to make
> > > sure W1 core stays loaded.
> > > - drop 'name' attribute as we already have it in bus_id.
> >
> > The same and even worse.
>
> You need to fix lifetime rules.

You moved all lto device model, while I want to have existing model
due to described actions.
So the right solution is to not break all existing locking, which
is mixed with device driver model, but create preper interoperability
model.
I will think of it some more, I will integrate your ad Adrian Bunk's
cleanups first when current pending patches are pushed.

> > > w1-family-cleanup.patch
> > > Clean-up family implementation:
> > > - get rid of w1_family_ops and template attributes in w1_slave
> > > structure and have family drivers create necessary attributes
> > > themselves. There are too many different devices using 1-Wire
> > > interface and it is impossible to fit them all into single
> > > attribute model. If interface unification is needed it can be
> > > done by building cross-bus class hierarchy.
> > > - rename w1_smem to w1_sernum because devices are called Silicon
> > > serial numbers, they have address (ID) but don't have memory
> > > in regular sense.
> > > - rename w1_therm to w1_thermal.
> >
> > smem == simple memory id, it is official name AFAIR.
> > Renames are superfluous, family_ops contains a "must have" operations,
> > driver writer can easily add it's own if it is needed.
>
> What is so "must have" about 2 attributes? smem does not need anything
> for exampe...

It is not read and read_bin, but read and write.
I have not implemented write methods monthes ago since I did not
have such a hardware, but now I see it was bad decision which
confused people.

> > > w1-family-is-driver.patch
> > > Convert family into proper device-model drivers:
> > > - embed driver structure into w1_family and register with the
> > > driver core;
> > > - do not try to manually bind slaves to familes, leave it to
> > > the driver core;
> > > - fold w1_family.c into w1.c
> >
> > Why do you break it?
> > They were separated intentionally - it simplifies code review,
> > it is completely different logical models, family processing
> > is not hte same as slave.
>
> Masters, slaves and families are all objects of W1 kernel bus. With
> cutting a bunch of fat from family code it does not make sense to keep
> them separate anymore.

What you do is exactly the same that already exist, but using other
model.
No need to dig into device model in a such way.

> > Thank you very much for your changes and ideas,
> > but as you can see I'm against several of it.
> > The main reason is why dig into the driver model in a such way?
> > It will complicate strucutre exporting too much.
>
> Because it is the standard for implementing devies and drivers in
> linux kernel. You need to explain about exporting structure since the
> rest of the system seem to be doing just fine.
>
> > Existing locking/refcnt schema is very flexible and allows device
> > manipulation while it "holds" the reference counter,
>
> It is also racy and buggy.

It is not.
You pointed an error, and it will be fixed after I think about it some
more,
the problem is that device model[which is not the main part of the w1
system]
is interfere to the existing locking schema [which is quite big and
allows very flexible object manipulation], and you suggest to almost
completely
replace one with another.
With such changes how to increment slave's usage counter? module_get
(w1_family)?

> > and it will not be possible if one just blindly gets/puts module's
> > refcnt.
>
> Only wire.ko is pinned. You are still free to remove family drivers or
> master drivers (or killing their objects somehow). It is only core
> that is pinned to make sure that release functions are available when
> object finally goes away.

If we remove slave deivice, we must be sure it's object is freed
when appripriate kobject is released.
The same is with family itself.

No, we need either replace all locking with device driver model,
or properly operate with existing one.
I will investigate it deeply, I'm sure will will find the best
solution.

> > Object has reference counter which is incremented and decremented when
> > object is in use, not the whole module reference counter,
> > one may remove and add separate objects without knowledge of
> > what family or bus master driver handles that.
>
> > Your changes mix low-level driver logic with w1 core.
> > You have removed netlink notification and replace it with hotplug,
> > but it can not be used for systems without shell userspace support.
>
> kobject_uevent does not requere a sehll account.

Exactly as existing netlink notifications, which allows
to bring not only simple predefined actions, but any information you
like.
As you said, we can not fit all existing w1 devices into very confined
limits, so hotplug events which are add/remove can not solve the
whole notification problem.
Simple notification mechanism that was created for w1 is only first
step,
of course it can be replaced with hotplug notification,
but only it, if we want, and I strongly believe we will want, to extend
it a bit we will fail with current hotplug approach.

--
Evgeniy Polyakov

Crash is better than data corruption -- Arthur Grabowski

Attachments:

signature.asc (189.00 B)
This is a digitally signed message part

2005-04-25 09:11:04

On Mon, 2005-04-25 at 15:22 -0500, Dmitry Torokhov wrote:
> On 4/25/05, Evgeniy Polyakov <[email protected]> wrote:
> > While thinking about locking schema
> > with respect to sysfs files I recalled,
> > why I implemented such a logic -
> > now one can _always_ remove _any_ module
> > [corresponding object is removed from accessible
> > pathes and waits untill all exsting users are gone],
> > which is very good - I really like it in networking model,
> > while with whole device driver model
> > if we will read device's file very quickly
> > in several threads we may end up not unloading it at all.
>
> I am sorrry, that is complete bull*. sysfs also allows removing
> modules at an arbitrary time (and usually without annoying "waiting
> for refcount" at that)... You just seem to not understand how driver
> code works, thus the need of inventing your own schema.

Ok, let's try again - now with explanation,
since it looks like you did not even try to understand what I said.
If you will remove objects from ->remove() callback
you may end up with rmmod being stuck.
Explanation: each read still gets reference counter,
while in rmmod path there is a wait until it is zero.
If there are too many simultaneous reads - even
if each will put reference counter at the end, we still can have
non zero refcnt each time we check it in rmmod path.
That is why object must be removed from accessible pathes
first, and only freed in ->remove() callback.

> BTW, I am looking at the connector code ATM and I am just amazed at
> all wied refounting stuff that is going on there. what a single
> actomic_dec_and_test() call without checkng reurn vaue is supposed to
> do again?

It has explicit barrieres, which guarantees that
there will not be atomic operation vs. non atomic
reordering.

--
Evgeniy Polyakov

Crash is better than data corruption -- Arthur Grabowski

Attachments:

signature.asc (189.00 B)
This is a digitally signed message part

2005-04-26 06:50:25

by Dmitry Torokhov

[permalink] [raw]

Subject: Re: [RFC/PATCH 0/22] W1: sysfs, lifetime and other fixes

On Tuesday 26 April 2005 01:43, Evgeniy Polyakov wrote:
> On Mon, 2005-04-25 at 15:22 -0500, Dmitry Torokhov wrote:
> > On 4/25/05, Evgeniy Polyakov <[email protected]> wrote:
> > > While thinking about locking schema
> > > with respect to sysfs files I recalled,
> > > why I implemented such a logic -
> > > now one can _always_ remove _any_ module
> > > [corresponding object is removed from accessible
> > > pathes and waits untill all exsting users are gone],
> > > which is very good - I really like it in networking model,
> > > while with whole device driver model
> > > if we will read device's file very quickly
> > > in several threads we may end up not unloading it at all.
> >
> > I am sorrry, that is complete bull*. sysfs also allows removing
> > modules at an arbitrary time (and usually without annoying "waiting
> > for refcount" at that)... You just seem to not understand how driver
> > code works, thus the need of inventing your own schema.
>
> Ok, let's try again - now with explanation,
> since it looks like you did not even try to understand what I said.
> If you will remove objects from ->remove() callback
> you may end up with rmmod being stuck.
> Explanation: each read still gets reference counter,
> while in rmmod path there is a wait until it is zero.
> If there are too many simultaneous reads - even
> if each will put reference counter at the end, we still can have
> non zero refcnt each time we check it in rmmod path.
> That is why object must be removed from accessible pathes
> first, and only freed in ->remove() callback.

Please try to read the code. device_unregister and kobject_unregister
do not require caller to wait for the last reference to drop, they rely
on availability of release method to clean up the object when last user
is gone. driver_unregister is blocking (like your family code) but
teardown takes no time. If driver is in use (attributes are open) then
module refcount is non-zero and instead of (possibly endless) "waiting for
refcount to drop" message you will get nice -EBUSY.

If you program so that you wait in module_exit for object release - you
get what you deserve.

> > BTW, I am looking at the connector code ATM and I am just amazed at
> > all wied refounting stuff that is going on there. what a single
> > actomic_dec_and_test() call without checkng reurn vaue is supposed to
> > do again?
>
> It has explicit barrieres, which guarantees that
> there will not be atomic operation vs. non atomic
> reordering.

And you can't use explicit barriers - why exactly?

--
Dmitry

2005-04-26 06:59:10

by Greg KH

[permalink] [raw]

Subject: Re: [RFC/PATCH 0/22] W1: sysfs, lifetime and other fixes

On Mon, Apr 25, 2005 at 11:32:14AM -0500, Dmitry Torokhov wrote:
> On 4/25/05, Evgeniy Polyakov <[email protected]> wrote:
> > On Thu, 2005-04-21 at 09:31 -0500, Dmitry Torokhov wrote:
> > >
> > > OK, that is what I am aying. But why do you need that attribute with
> > > variable name and a bin attribute that is not really bin but just a
> > > dump for all kind of data (looks like debug one).
> >
> > bin attribute was created for lm_sensors scripts format - it only caches
> > read value.
> > I think there might be only 2 "must have" methods - read and write.
> > I plan to implement them using connector, so probably they will go away
> > completely.
> ...
> > > You will not be able to cram all 1-wire devices into unified
> > > interface. You will need to build classes on top of it and you might
> > > use connector (I am not sure) bit not on w1 bus level.
> > > ...
> >
> > connector allows to have different objects inside one netlink group,
> > so it will use it in that way.
> > I think only two w1 methods must exist - read and write,
> > and they must follow protocol, defined in family driver.
>
> No, I think there should not be any "must have" methods on w1_bus
> level. What you really need (and this needs to be coordinated with
> other sensors people) is a "sensors" class hierarchy that will define
> classes like "temperature sensor", "fan", "vid", etc. Then your w1
> family drivers, when bound to a slave, will create needed class
> devices. i2c drivers will do the same, and your superio, and I'll be
> able to change i8k driver just for kicks. Then your usespace would not
> care what _bus_ a particular sensor is sittign on and will be
> presented with a unified interface.

Yes, that is the way to go, and is what a number of people are currently
working on implementing.

thanks,

greg k-h

2005-04-26 06:59:48

On Tue, 2005-04-26 at 00:00 -0700, Greg KH wrote:
> On Tue, Apr 26, 2005 at 10:43:36AM +0400, Evgeniy Polyakov wrote:
> > On Mon, 2005-04-25 at 15:22 -0500, Dmitry Torokhov wrote:
> > > On 4/25/05, Evgeniy Polyakov <[email protected]> wrote:
> > > > While thinking about locking schema
> > > > with respect to sysfs files I recalled,
> > > > why I implemented such a logic -
> > > > now one can _always_ remove _any_ module
> > > > [corresponding object is removed from accessible
> > > > pathes and waits untill all exsting users are gone],
> > > > which is very good - I really like it in networking model,
> > > > while with whole device driver model
> > > > if we will read device's file very quickly
> > > > in several threads we may end up not unloading it at all.
> > >
> > > I am sorrry, that is complete bull*. sysfs also allows removing
> > > modules at an arbitrary time (and usually without annoying "waiting
> > > for refcount" at that)... You just seem to not understand how driver
> > > code works, thus the need of inventing your own schema.
> >
> > Ok, let's try again - now with explanation,
> > since it looks like you did not even try to understand what I said.
> > If you will remove objects from ->remove() callback
> > you may end up with rmmod being stuck.
>
> Yes, and that is acceptable. networking implemented their own locking
> method to allow unloading of their drivers in such a manner. No other
> subsystem is going to do that kind of implementation, so Dmitry is
> correct here.

w1 does it too :)
It's locking was lurked in network code.
And it _is_ design note to be able to remove objects in any time.
Ok, I can not say, that it is exactly like networking,
since there is waiting in rmmod path, it is very similar to virtual
devices
like vlan.

> thanks,
>
> greg k-h
--
Evgeniy Polyakov

Crash is better than data corruption -- Arthur Grabowski

Attachments:

signature.asc (189.00 B)
This is a digitally signed message part

2005-04-26 07:13:47

On Tue, 2005-04-26 at 02:16 -0500, Dmitry Torokhov wrote:

> > > > It has explicit barrieres, which guarantees that
> > > > there will not be atomic operation vs. non atomic
> > > > reordering.
> > >
> > > And you can't use explicit barriers - why exactly?
> >
> > I used them - code was following:
> > smp_mb__before_atomic_dec();
> > atomic_dec();
> > smp_mb__after_atomic_dec();
> >
> > I think simple atomic_dec_and_test() or even atomic_dec_and_lock()
> > is better.
>
> This is usually indicates that there some kiond of a problem. Consider
> following fragment:
>
> > +static void cn_queue_wrapper(void *data)
> > +{
> > + struct cn_callback_entry *cbq = (struct cn_callback_entry *)data;
> > +
> > + atomic_inc_and_test(&cbq->cb->refcnt);
> > + cbq->cb->callback(cbq->cb->priv);
> > + atomic_dec_and_test(&cbq->cb->refcnt);
> >
>
> What exactly this refcount protects? Can it be that other code decrements
> refcount and frees the object right when one CPU is entering this function?
> If not that means that cb structure is protected by some other means, so
> why we need to increment refcout here and consider ordering?

It does not needed there. I pointed it to Andrew when we discuss it
couple of weeks ago, but forget to remove.

> Btw, cb refcount can be complelely removed, something like the patch below
> (won't apply cleanly as I have some other stuff).

I will think of it some more, probably you are right,
it looks like flush_workqueue() is sufficient for that.

> --
> Dmitry
>
> drivers/connector/cn_queue.c | 85 +++++++++++--------------------------------
> include/linux/connector.h | 2 -
> 2 files changed, 23 insertions(+), 64 deletions(-)
>
> Index: linux-2.6.11/drivers/connector/cn_queue.c
> ===================================================================
> --- linux-2.6.11.orig/drivers/connector/cn_queue.c
> +++ linux-2.6.11/drivers/connector/cn_queue.c
> @@ -33,49 +33,12 @@
>
> static void cn_queue_wrapper(void *data)
> {
> - struct cn_callback_entry *cbq = (struct cn_callback_entry *)data;
> + struct cn_callback_entry *cbq = data;
>
> - atomic_inc_and_test(&cbq->cb->refcnt);
> cbq->cb->callback(cbq->cb->priv);
> - atomic_dec_and_test(&cbq->cb->refcnt);
> -
> cbq->destruct_data(cbq->ddata);
> }
>
> -static struct cn_callback_entry *cn_queue_alloc_callback_entry(struct cn_callback *cb)
> -{
> - struct cn_callback_entry *cbq;
> -
> - cbq = kmalloc(sizeof(*cbq), GFP_KERNEL);
> - if (!cbq) {
> - printk(KERN_ERR "Failed to create new callback queue.\n");
> - return NULL;
> - }
> -
> - memset(cbq, 0, sizeof(*cbq));
> -
> - cbq->cb = cb;
> -
> - INIT_WORK(&cbq->work, &cn_queue_wrapper, cbq);
> -
> - return cbq;
> -}
> -
> -static void cn_queue_free_callback(struct cn_callback_entry *cbq)
> -{
> - cancel_delayed_work(&cbq->work);
> - flush_workqueue(cbq->pdev->cn_queue);
> -
> - while (atomic_read(&cbq->cb->refcnt)) {
> - printk(KERN_INFO "Waiting for %s to become free: refcnt=%d.\n",
> - cbq->pdev->name, atomic_read(&cbq->cb->refcnt));
> -
> - msleep(1000);
> - }
> -
> - kfree(cbq);
> -}
> -
> int cn_cb_equal(struct cb_id *i1, struct cb_id *i2)
> {
> #if 0
> @@ -90,40 +53,37 @@ int cn_cb_equal(struct cb_id *i1, struct
> int cn_queue_add_callback(struct cn_queue_dev *dev, struct cn_callback *cb)
> {
> struct cn_callback_entry *cbq, *__cbq;
> - int found = 0;
> + int retval = 0;
>
> - cbq = cn_queue_alloc_callback_entry(cb);
> - if (!cbq)
> + cbq = kmalloc(sizeof(*cbq), GFP_KERNEL);
> + if (!cbq) {
> + printk(KERN_ERR "Failed to create new callback queue.\n");
> return -ENOMEM;
> + }
>
> atomic_inc(&dev->refcnt);
> +
> + memset(cbq, 0, sizeof(*cbq));
> + INIT_WORK(&cbq->work, &cn_queue_wrapper, cbq);
> + cbq->cb = cb;
> cbq->pdev = dev;
> + cbq->nls = dev->nls;
> + cbq->seq = 0;
> + cbq->group = cbq->cb->id.idx;
>
> spin_lock_bh(&dev->queue_lock);
> +
> list_for_each_entry(__cbq, &dev->queue_list, callback_entry) {
> if (cn_cb_equal(&__cbq->cb->id, &cb->id)) {
> - found = 1;
> - break;
> + retval = -EEXIST;
> + kfree(cbq);
> + goto out;
> }
> }
> - if (!found) {
> - atomic_set(&cbq->cb->refcnt, 1);
> - list_add_tail(&cbq->callback_entry, &dev->queue_list);
> - }
> + list_add_tail(&cbq->callback_entry, &dev->queue_list);
> + out:
> spin_unlock_bh(&dev->queue_lock);
> -
> - if (found) {
> - atomic_dec(&dev->refcnt);
> - atomic_set(&cbq->cb->refcnt, 0);
> - cn_queue_free_callback(cbq);
> - return -EINVAL;
> - }
> -
> - cbq->nls = dev->nls;
> - cbq->seq = 0;
> - cbq->group = cbq->cb->id.idx;
> -
> - return 0;
> + return retval;
> }
>
> void cn_queue_del_callback(struct cn_queue_dev *dev, struct cb_id *id)
> @@ -142,8 +102,9 @@ void cn_queue_del_callback(struct cn_que
> spin_unlock_bh(&dev->queue_lock);
>
> if (found) {
> - atomic_dec(&cbq->cb->refcnt);
> - cn_queue_free_callback(cbq);
> + cancel_delayed_work(&cbq->work);
> + flush_workqueue(cbq->pdev->cn_queue);
> + kfree(cbq);
> atomic_dec_and_test(&dev->refcnt);
> }
> }
> Index: linux-2.6.11/include/linux/connector.h
> ===================================================================
> --- linux-2.6.11.orig/include/linux/connector.h
> +++ linux-2.6.11/include/linux/connector.h
> @@ -115,8 +115,6 @@ struct cn_callback
> struct cb_id id;
> void (* callback)(void *);
> void *priv;
> -
> - atomic_t refcnt;
> };
>
> struct cn_callback_entry
--
Evgeniy Polyakov

Crash is better than data corruption -- Arthur Grabowski

Attachments:

signature.asc (189.00 B)
This is a digitally signed message part