Skip to contentSkip to conversation

kexec: device shutdown vs. remove

DISCUSSION Benjamin Herrenschmidt 3 participants 8 messages Jul 23, 2016 – Jul 25, 2016

lore
Share & tools
lore
#0 lore raw

Hi !

This is somewhat of a recurring issue, some of my previous attempts on lkml, I suspect, were just drowned in the noise. Eric, we had a quick discussion about this a while back but I don't think we reached a conclusion.

A bit of context: On OpenPOWER machines, we have a Linux based bootloader, so we rely heavily on kexec to boot distro kernels, and this has been causing us grief, mostly in the device driver space.

Device drivers need to be quiesced before kexec. More specifically the device *hardware* needs that, ie we want DMAs to stop and the device to be put into a state where it can reliably be picked up by the driver in the new kernel.

Today, kexec calls device_shutdown() to achieve that. I argue that this is the wrong thing to do and instead we should do someting that causes the various drivers ->remove() function to be called (whether that implies actually unbinding the driver or not).

I believe we do this for historical reasons, as ->remove() used to depend on CONFIG_HOTPLUG while ->shutdown() was always around but that is no longer the case.

The most visible issue with ->shutdown() that we encouter is that a lot of drivers simply don't implement it.

The *real* issue however is that it's the wrong thing to do anyway. It is a call intended to be called when the machine will be shutdown, as such not only it is very much optional (and rarely implemented), but it can also (and will in some cases) power bits of hardware off which is not what you want to do if a new driver will try to pick up the pieces.

Arguably, the most correct semantic is provided by ->remove() since that corresponds to removing a driver and binding a new one to the device. IE. the same flow as doing rmmod/insmod of a new driver.

In practice, we obseve that a lot more drivers implement ->remove(). A few were "fixed" to have ->shutdown() for kexec stake over time, but in many case it's a duplication of ->remove() (ugh...).

So I would like to discuss this or at least get feedback and an overall agreement. I can provide patches to test fairly soon.

Cheers,
Ben.

#1 lore raw
Quoted 38 lines · Benjamin Herrenschmidt

Hi !

This is somewhat of a recurring issue, some of my previous attempts on lkml, I suspect, were just drowned in the noise. Eric, we had a quick discussion about this a while back but I don't think we reached a conclusion.

A bit of context: On OpenPOWER machines, we have a Linux based bootloader, so we rely heavily on kexec to boot distro kernels, and this has been causing us grief, mostly in the device driver space.

Device drivers need to be quiesced before kexec. More specifically the device *hardware* needs that, ie we want DMAs to stop and the device to be put into a state where it can reliably be picked up by the driver in the new kernel.

Today, kexec calls device_shutdown() to achieve that. I argue that this is the wrong thing to do and instead we should do someting that causes the various drivers ->remove() function to be called (whether that implies actually unbinding the driver or not).

I believe we do this for historical reasons, as ->remove() used to depend on CONFIG_HOTPLUG while ->shutdown() was always around but that is no longer the case.

The most visible issue with ->shutdown() that we encouter is that a lot of drivers simply don't implement it.

The *real* issue however is that it's the wrong thing to do anyway. It is a call intended to be called when the machine will be shutdown, as such not only it is very much optional (and rarely implemented), but it can also (and will in some cases) power bits of hardware off which is not what you want to do if a new driver will try to pick up the pieces.

Arguably, the most correct semantic is provided by ->remove() since that corresponds to removing a driver and binding a new one to the device. IE. the same flow as doing rmmod/insmod of a new driver.

Quoted 7 lines

In practice, we obseve that a lot more drivers implement ->remove(). A few were "fixed" to have ->shutdown() for kexec stake over time, but in many case it's a duplication of ->remove() (ugh...).

So I would like to discuss this or at least get feedback and an overall agreement. I can provide patches to test fairly soon.

I suspect that using (or depending on) the remove function may not be feasible anymore after the recent effort by Paul Gortmaker to make drivers explicitly non-modular if they are only configurable as boolean. In many cases, this involved dropping remove functions.

Guenter

#5 lore raw
In reply to Benjamin Herrenschmidt
Quoted 38 lines · Benjamin Herrenschmidt

Hi !

This is somewhat of a recurring issue, some of my previous attempts on lkml, I suspect, were just drowned in the noise. Eric, we had a quick discussion about this a while back but I don't think we reached a conclusion.

A bit of context: On OpenPOWER machines, we have a Linux based bootloader, so we rely heavily on kexec to boot distro kernels, and this has been causing us grief, mostly in the device driver space.

Device drivers need to be quiesced before kexec. More specifically the device *hardware* needs that, ie we want DMAs to stop and the device to be put into a state where it can reliably be picked up by the driver in the new kernel.

Today, kexec calls device_shutdown() to achieve that. I argue that this is the wrong thing to do and instead we should do someting that causes the various drivers ->remove() function to be called (whether that implies actually unbinding the driver or not).

I believe we do this for historical reasons, as ->remove() used to depend on CONFIG_HOTPLUG while ->shutdown() was always around but that is no longer the case.

The most visible issue with ->shutdown() that we encouter is that a lot of drivers simply don't implement it.

The *real* issue however is that it's the wrong thing to do anyway. It is a call intended to be called when the machine will be shutdown, as such not only it is very much optional (and rarely implemented), but it can also (and will in some cases) power bits of hardware off which is not what you want to do if a new driver will try to pick up the pieces.

Arguably, the most correct semantic is provided by ->remove() since that corresponds to removing a driver and binding a new one to the device. IE. the same flow as doing rmmod/insmod of a new driver.

Quoted 6 lines

In practice, we obseve that a lot more drivers implement ->remove(). A few were "fixed" to have ->shutdown() for kexec stake over time, but in many case it's a duplication of ->remove() (ugh...).

So I would like to discuss this or at least get feedback and an overall agreement. I can provide patches to test fairly soon.

I thought I had given that feedback awhile ago.

To recap. I wanted the reboot path and the kexec path to be the same. (Because arguably they are the same and have the same requirements,
although a lot of firmware toggles the machines reset line in that case making that less true).

People didn't want to have all of the non-hardware specific cleanup people do in the reboot path because it might cause problems with machines. So shutdown was born.

In practice as you have observed the remove code is tested and the shutdown code is not.

In practice we have an emergency reboot path that doesn't do any hardware shutdown. Which probably better fills the original need of a reboot that doesn't spend time cleaning up.

If you are willing to do the work to merge shutdown into remove and simplify the drivers, perform the testing and the other state I am in favor of the change. I think we have had enough time to see if have two methods was maintainable for the driver authors.

Eric

#2 lore raw
In reply to Guenter Roeck
Quoted 4 lines · Guenter Roeck

I suspect that using (or depending on) the remove function may not be feasible anymore after the recent effort by Paul Gortmaker to make drivers explicitly non-modular if they are only configurable as boolean. In many cases, this involved dropping remove functions.

A lot of drivers we care about are modular. But maybe the right approach is to do something like remove() if it exist and shutdown() if it doesn't ? Or a new callback for kexec ? quiesce() ?

Cheers,
Ben.

#6 lore raw
In reply to Eric W. Biederman
Quoted 4 lines · Eric W. Biederman

If you are willing to do the work to merge shutdown into remove and simplify the drivers, perform the testing and the other state I am in favor of the change.  I think we have had enough time to see if have two methods was maintainable for the driver authors.

Well, remove is going away in some drivers at least...

Also shutdown() has two different meaning between kexec and actual machine shutdown...

Should we create a new one instead ? Something like quiesce() ? If absent, look for remove(), if absent too, look for shutdown() ...

Or we continue doing shutdown() for now with a fallback to remove() if shutdown is NULL (this is what I've been toying with internally).

Cheers,
ben.

#7 lore raw
Quoted 8 lines · Benjamin Herrenschmidt
Quoted 4 lines · Eric W. Biederman

If you are willing to do the work to merge shutdown into remove and simplify the drivers, perform the testing and the other state I am in favor of the change.  I think we have had enough time to see if have two methods was maintainable for the driver authors.

Well, remove is going away in some drivers at least...

Quoted 8 lines

Also shutdown() has two different meaning between kexec and actual machine shutdown...

Should we create a new one instead ? Something like quiesce() ? If absent, look for remove(), if absent too, look for shutdown() ...

Or we continue doing shutdown() for now with a fallback to remove() if shutdown is NULL (this is what I've been toying with internally).

A shutdown method that doesn't work for kexec is a poorly tested buggy implementation of shutdown.

I don't driver authors for the confusion but it remains true that shutdown has always been called in the kexec path. So if your shutdown method does not work for kexec it is buggy (by definition).

Eric

#3 lore raw
In reply to Benjamin Herrenschmidt
Quoted 9 lines · Benjamin Herrenschmidt
Quoted 4 lines · Guenter Roeck

I suspect that using (or depending on) the remove function may not be feasible anymore after the recent effort by Paul Gortmaker to make drivers explicitly non-modular if they are only configurable as boolean. In many cases, this involved dropping remove functions.

A lot of drivers we care about are modular. But maybe the right approach is to do something like remove() if it exist and shutdown() if it doesn't ? Or a new callback for kexec ? quiesce() ?

Perhaps remove if shutdown does not exist. What this really takes is someone to care enough to sort through this mess.

Eric

#4 lore raw
Quoted 7 lines · Eric W. Biederman
Quoted 2 lines

A lot of drivers we care about are modular. But maybe the right approach is to do something like remove() if it exist and

shutdown() if

Quoted 1 line

it doesn't ? Or a new callback for kexec ? quiesce() ?

Perhaps remove if shutdown does not exist.  What this really takes is someone to care enough to sort through this mess.

Right, I have a test patch doing just that which I'm about to start testing internally.

Cheers,
Ben.