1d26c3321SWeiXiong Liao /* SPDX-License-Identifier: GPL-2.0 */ 2d26c3321SWeiXiong Liao 3d26c3321SWeiXiong Liao #ifndef __PSTORE_ZONE_H_ 4d26c3321SWeiXiong Liao #define __PSTORE_ZONE_H_ 5d26c3321SWeiXiong Liao 6d26c3321SWeiXiong Liao #include <linux/types.h> 7d26c3321SWeiXiong Liao 8d26c3321SWeiXiong Liao typedef ssize_t (*pstore_zone_read_op)(char *, size_t, loff_t); 9d26c3321SWeiXiong Liao typedef ssize_t (*pstore_zone_write_op)(const char *, size_t, loff_t); 10*7dcb7848SWeiXiong Liao typedef ssize_t (*pstore_zone_erase_op)(size_t, loff_t); 11d26c3321SWeiXiong Liao /** 12d26c3321SWeiXiong Liao * struct pstore_zone_info - pstore/zone back-end driver structure 13d26c3321SWeiXiong Liao * 14d26c3321SWeiXiong Liao * @owner: Module which is responsible for this back-end driver. 15d26c3321SWeiXiong Liao * @name: Name of the back-end driver. 16d26c3321SWeiXiong Liao * @total_size: The total size in bytes pstore/zone can use. It must be greater 17d26c3321SWeiXiong Liao * than 4096 and be multiple of 4096. 18d26c3321SWeiXiong Liao * @kmsg_size: The size of oops/panic zone. Zero means disabled, otherwise, 19d26c3321SWeiXiong Liao * it must be multiple of SECTOR_SIZE(512 Bytes). 20d26c3321SWeiXiong Liao * @max_reason: Maximum kmsg dump reason to store. 210dc06826SWeiXiong Liao * @pmsg_size: The size of pmsg zone which is the same as @kmsg_size. 22cc9c4d1bSWeiXiong Liao * @console_size:The size of console zone which is the same as @kmsg_size. 2334327e9fSWeiXiong Liao * @ftrace_size:The size of ftrace zone which is the same as @kmsg_size. 24d26c3321SWeiXiong Liao * @read: The general read operation. Both of the function parameters 25d26c3321SWeiXiong Liao * @size and @offset are relative value to storage. 26d26c3321SWeiXiong Liao * On success, the number of bytes should be returned, others 27335426c6SWeiXiong Liao * mean error. 28335426c6SWeiXiong Liao * @write: The same as @read, but the following error number: 29335426c6SWeiXiong Liao * -EBUSY means try to write again later. 30335426c6SWeiXiong Liao * -ENOMSG means to try next zone. 31*7dcb7848SWeiXiong Liao * @erase: The general erase operation for device with special removing 32*7dcb7848SWeiXiong Liao * job. Both of the function parameters @size and @offset are 33*7dcb7848SWeiXiong Liao * relative value to storage. 34*7dcb7848SWeiXiong Liao * Return 0 on success and others on failure. 35d26c3321SWeiXiong Liao * @panic_write:The write operation only used for panic case. It's optional 36335426c6SWeiXiong Liao * if you do not care panic log. The parameters are relative 37335426c6SWeiXiong Liao * value to storage. 38335426c6SWeiXiong Liao * On success, the number of bytes should be returned, others 39335426c6SWeiXiong Liao * excluding -ENOMSG mean error. -ENOMSG means to try next zone. 40d26c3321SWeiXiong Liao */ 41d26c3321SWeiXiong Liao struct pstore_zone_info { 42d26c3321SWeiXiong Liao struct module *owner; 43d26c3321SWeiXiong Liao const char *name; 44d26c3321SWeiXiong Liao 45d26c3321SWeiXiong Liao unsigned long total_size; 46d26c3321SWeiXiong Liao unsigned long kmsg_size; 47d26c3321SWeiXiong Liao int max_reason; 480dc06826SWeiXiong Liao unsigned long pmsg_size; 49cc9c4d1bSWeiXiong Liao unsigned long console_size; 5034327e9fSWeiXiong Liao unsigned long ftrace_size; 51d26c3321SWeiXiong Liao pstore_zone_read_op read; 52d26c3321SWeiXiong Liao pstore_zone_write_op write; 53*7dcb7848SWeiXiong Liao pstore_zone_erase_op erase; 54d26c3321SWeiXiong Liao pstore_zone_write_op panic_write; 55d26c3321SWeiXiong Liao }; 56d26c3321SWeiXiong Liao 57d26c3321SWeiXiong Liao extern int register_pstore_zone(struct pstore_zone_info *info); 58d26c3321SWeiXiong Liao extern void unregister_pstore_zone(struct pstore_zone_info *info); 59d26c3321SWeiXiong Liao 60d26c3321SWeiXiong Liao #endif 61