1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 2016-2018, Matthew Macy <mmacy@freebsd.org> 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25 * SUCH DAMAGE. 26 * 27 * $FreeBSD$ 28 */ 29 30 #ifndef _LINUXKPI_LINUX_DEBUGFS_H_ 31 #define _LINUXKPI_LINUX_DEBUGFS_H_ 32 33 #include <linux/fs.h> 34 #include <linux/module.h> 35 #include <linux/seq_file.h> 36 #include <linux/types.h> 37 38 MALLOC_DECLARE(M_DFSINT); 39 40 struct debugfs_reg32 { 41 char *name; 42 unsigned long offset; 43 }; 44 45 struct debugfs_regset32 { 46 const struct debugfs_reg32 *regs; 47 int nregs; 48 }; 49 50 struct debugfs_blob_wrapper { 51 void *data; 52 size_t size; 53 }; 54 55 static inline bool 56 debugfs_initialized(void) 57 { 58 59 return (true); 60 } 61 62 struct dentry *debugfs_create_file(const char *name, umode_t mode, 63 struct dentry *parent, void *data, 64 const struct file_operations *fops); 65 66 /* TODO: We currently ignore the `file_size` argument. */ 67 struct dentry *debugfs_create_file_size(const char *name, umode_t mode, 68 struct dentry *parent, void *data, 69 const struct file_operations *fops, 70 loff_t file_size); 71 72 struct dentry *debugfs_create_file_unsafe(const char *name, umode_t mode, 73 struct dentry *parent, void *data, 74 const struct file_operations *fops); 75 76 struct dentry *debugfs_create_mode_unsafe(const char *name, umode_t mode, 77 struct dentry *parent, void *data, 78 const struct file_operations *fops, 79 const struct file_operations *fops_ro, 80 const struct file_operations *fops_wo); 81 82 struct dentry *debugfs_create_dir(const char *name, struct dentry *parent); 83 84 struct dentry *debugfs_create_symlink(const char *name, struct dentry *parent, 85 const char *dest); 86 87 void debugfs_remove(struct dentry *dentry); 88 89 void debugfs_remove_recursive(struct dentry *dentry); 90 91 #define DEFINE_DEBUGFS_ATTRIBUTE(__fops, __get, __set, __fmt) \ 92 DEFINE_SIMPLE_ATTRIBUTE(__fops, __get, __set, __fmt) 93 94 void debugfs_create_bool(const char *name, umode_t mode, struct dentry *parent, 95 bool *value); 96 void debugfs_create_u8(const char *name, umode_t mode, struct dentry *parent, 97 uint8_t *value); 98 void debugfs_create_u16(const char *name, umode_t mode, struct dentry *parent, 99 uint16_t *value); 100 void debugfs_create_u32(const char *name, umode_t mode, struct dentry *parent, 101 uint32_t *value); 102 void debugfs_create_u64(const char *name, umode_t mode, struct dentry *parent, 103 uint64_t *value); 104 void debugfs_create_x8(const char *name, umode_t mode, struct dentry *parent, 105 uint8_t *value); 106 void debugfs_create_x16(const char *name, umode_t mode, struct dentry *parent, 107 uint16_t *value); 108 void debugfs_create_x32(const char *name, umode_t mode, struct dentry *parent, 109 uint32_t *value); 110 void debugfs_create_x64(const char *name, umode_t mode, struct dentry *parent, 111 uint64_t *value); 112 void debugfs_create_ulong(const char *name, umode_t mode, struct dentry *parent, 113 unsigned long *value); 114 void debugfs_create_atomic_t(const char *name, umode_t mode, struct dentry *parent, 115 atomic_t *value); 116 117 struct dentry *debugfs_create_blob(const char *name, umode_t mode, 118 struct dentry *parent, struct debugfs_blob_wrapper *value); 119 120 #endif /* _LINUXKPI_LINUX_DEBUGFS_H_ */ 121