forked from mirrors/linux
d69d804845
In the match() callback, the struct device_driver * should not be changed, so change the function callback to be a const *. This is one step of many towards making the driver core safe to have struct device_driver in read-only memory. Because the match() callback is in all busses, all busses are modified to handle this properly. This does entail switching some container_of() calls to container_of_const() to properly handle the constant *. For some busses, like PCI and USB and HV, the const * is cast away in the match callback as those busses do want to modify those structures at this point in time (they have a local lock in the driver structure.) That will have to be changed in the future if they wish to have their struct device * in read-only-memory. Cc: Rafael J. Wysocki <rafael@kernel.org> Reviewed-by: Alex Elder <elder@kernel.org> Acked-by: Sumit Garg <sumit.garg@linaro.org> Link: https://lore.kernel.org/r/2024070136-wrongdoer-busily-01e8@gregkh Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
85 lines
2.3 KiB
C
85 lines
2.3 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/* FSI device & driver interfaces
|
|
*
|
|
* Copyright (C) IBM Corporation 2016
|
|
*/
|
|
|
|
#ifndef LINUX_FSI_H
|
|
#define LINUX_FSI_H
|
|
|
|
#include <linux/device.h>
|
|
|
|
struct fsi_device {
|
|
struct device dev;
|
|
u8 engine_type;
|
|
u8 version;
|
|
u8 unit;
|
|
struct fsi_slave *slave;
|
|
uint32_t addr;
|
|
uint32_t size;
|
|
};
|
|
|
|
extern int fsi_device_read(struct fsi_device *dev, uint32_t addr,
|
|
void *val, size_t size);
|
|
extern int fsi_device_write(struct fsi_device *dev, uint32_t addr,
|
|
const void *val, size_t size);
|
|
extern int fsi_device_peek(struct fsi_device *dev, void *val);
|
|
|
|
struct fsi_device_id {
|
|
u8 engine_type;
|
|
u8 version;
|
|
};
|
|
|
|
#define FSI_VERSION_ANY 0
|
|
|
|
#define FSI_DEVICE(t) \
|
|
.engine_type = (t), .version = FSI_VERSION_ANY,
|
|
|
|
#define FSI_DEVICE_VERSIONED(t, v) \
|
|
.engine_type = (t), .version = (v),
|
|
|
|
struct fsi_driver {
|
|
struct device_driver drv;
|
|
const struct fsi_device_id *id_table;
|
|
};
|
|
|
|
#define to_fsi_dev(devp) container_of(devp, struct fsi_device, dev)
|
|
#define to_fsi_drv(drvp) container_of_const(drvp, struct fsi_driver, drv)
|
|
|
|
extern int fsi_driver_register(struct fsi_driver *fsi_drv);
|
|
extern void fsi_driver_unregister(struct fsi_driver *fsi_drv);
|
|
|
|
/* module_fsi_driver() - Helper macro for drivers that don't do
|
|
* anything special in module init/exit. This eliminates a lot of
|
|
* boilerplate. Each module may only use this macro once, and
|
|
* calling it replaces module_init() and module_exit()
|
|
*/
|
|
#define module_fsi_driver(__fsi_driver) \
|
|
module_driver(__fsi_driver, fsi_driver_register, \
|
|
fsi_driver_unregister)
|
|
|
|
/* direct slave API */
|
|
extern int fsi_slave_claim_range(struct fsi_slave *slave,
|
|
uint32_t addr, uint32_t size);
|
|
extern void fsi_slave_release_range(struct fsi_slave *slave,
|
|
uint32_t addr, uint32_t size);
|
|
extern int fsi_slave_read(struct fsi_slave *slave, uint32_t addr,
|
|
void *val, size_t size);
|
|
extern int fsi_slave_write(struct fsi_slave *slave, uint32_t addr,
|
|
const void *val, size_t size);
|
|
|
|
extern struct bus_type fsi_bus_type;
|
|
extern const struct device_type fsi_cdev_type;
|
|
|
|
enum fsi_dev_type {
|
|
fsi_dev_cfam,
|
|
fsi_dev_sbefifo,
|
|
fsi_dev_scom,
|
|
fsi_dev_occ
|
|
};
|
|
|
|
extern int fsi_get_new_minor(struct fsi_device *fdev, enum fsi_dev_type type,
|
|
dev_t *out_dev, int *out_index);
|
|
extern void fsi_free_minor(dev_t dev);
|
|
|
|
#endif /* LINUX_FSI_H */
|