mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-22 00:40:03 +00:00
![Gustavo A. R. Silva](/assets/img/avatar_default.png)
There is a regular need in the kernel to provide a way to declare having a dynamically sized set of trailing elements in a structure. Kernel code should always use “flexible array members”[1] for these cases. The older style of one-element or zero-length arrays should no longer be used[2]. This code was transformed with the help of Coccinelle: (next-20220214$ spatch --jobs $(getconf _NPROCESSORS_ONLN) --sp-file script.cocci --include-headers --dir . > output.patch) @@ identifier S, member, array; type T1, T2; @@ struct S { ... T1 member; T2 array[ - 0 ]; }; UAPI and wireless changes were intentionally excluded from this patch and will be sent out separately. [1] https://en.wikipedia.org/wiki/Flexible_array_member [2] https://www.kernel.org/doc/html/v5.16/process/deprecated.html#zero-length-and-one-element-arrays Link: https://github.com/KSPP/linux/issues/78 Reviewed-by: Kees Cook <keescook@chromium.org> Signed-off-by: Gustavo A. R. Silva <gustavoars@kernel.org>
85 lines
2.6 KiB
C
85 lines
2.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Greybus Host Device
|
|
*
|
|
* Copyright 2014-2015 Google Inc.
|
|
* Copyright 2014-2015 Linaro Ltd.
|
|
*/
|
|
|
|
#ifndef __HD_H
|
|
#define __HD_H
|
|
|
|
#include <linux/types.h>
|
|
#include <linux/device.h>
|
|
|
|
struct gb_host_device;
|
|
struct gb_message;
|
|
|
|
struct gb_hd_driver {
|
|
size_t hd_priv_size;
|
|
|
|
int (*cport_allocate)(struct gb_host_device *hd, int cport_id,
|
|
unsigned long flags);
|
|
void (*cport_release)(struct gb_host_device *hd, u16 cport_id);
|
|
int (*cport_enable)(struct gb_host_device *hd, u16 cport_id,
|
|
unsigned long flags);
|
|
int (*cport_disable)(struct gb_host_device *hd, u16 cport_id);
|
|
int (*cport_connected)(struct gb_host_device *hd, u16 cport_id);
|
|
int (*cport_flush)(struct gb_host_device *hd, u16 cport_id);
|
|
int (*cport_shutdown)(struct gb_host_device *hd, u16 cport_id,
|
|
u8 phase, unsigned int timeout);
|
|
int (*cport_quiesce)(struct gb_host_device *hd, u16 cport_id,
|
|
size_t peer_space, unsigned int timeout);
|
|
int (*cport_clear)(struct gb_host_device *hd, u16 cport_id);
|
|
|
|
int (*message_send)(struct gb_host_device *hd, u16 dest_cport_id,
|
|
struct gb_message *message, gfp_t gfp_mask);
|
|
void (*message_cancel)(struct gb_message *message);
|
|
int (*latency_tag_enable)(struct gb_host_device *hd, u16 cport_id);
|
|
int (*latency_tag_disable)(struct gb_host_device *hd, u16 cport_id);
|
|
int (*output)(struct gb_host_device *hd, void *req, u16 size, u8 cmd,
|
|
bool async);
|
|
};
|
|
|
|
struct gb_host_device {
|
|
struct device dev;
|
|
int bus_id;
|
|
const struct gb_hd_driver *driver;
|
|
|
|
struct list_head modules;
|
|
struct list_head connections;
|
|
struct ida cport_id_map;
|
|
|
|
/* Number of CPorts supported by the UniPro IP */
|
|
size_t num_cports;
|
|
|
|
/* Host device buffer constraints */
|
|
size_t buffer_size_max;
|
|
|
|
struct gb_svc *svc;
|
|
/* Private data for the host driver */
|
|
unsigned long hd_priv[] __aligned(sizeof(s64));
|
|
};
|
|
#define to_gb_host_device(d) container_of(d, struct gb_host_device, dev)
|
|
|
|
int gb_hd_cport_reserve(struct gb_host_device *hd, u16 cport_id);
|
|
void gb_hd_cport_release_reserved(struct gb_host_device *hd, u16 cport_id);
|
|
int gb_hd_cport_allocate(struct gb_host_device *hd, int cport_id,
|
|
unsigned long flags);
|
|
void gb_hd_cport_release(struct gb_host_device *hd, u16 cport_id);
|
|
|
|
struct gb_host_device *gb_hd_create(struct gb_hd_driver *driver,
|
|
struct device *parent,
|
|
size_t buffer_size_max,
|
|
size_t num_cports);
|
|
int gb_hd_add(struct gb_host_device *hd);
|
|
void gb_hd_del(struct gb_host_device *hd);
|
|
void gb_hd_shutdown(struct gb_host_device *hd);
|
|
void gb_hd_put(struct gb_host_device *hd);
|
|
int gb_hd_output(struct gb_host_device *hd, void *req, u16 size, u8 cmd,
|
|
bool in_irq);
|
|
|
|
int gb_hd_init(void);
|
|
void gb_hd_exit(void);
|
|
|
|
#endif /* __HD_H */
|