From 8466ba397d04f24e97b06f4117e8f0ab2c1e0e48 Mon Sep 17 00:00:00 2001 From: Felix Morgner Date: Sat, 25 Feb 2017 15:24:32 +0100 Subject: cyber: initial release --- include/cyber_file.h | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 include/cyber_file.h (limited to 'include/cyber_file.h') diff --git a/include/cyber_file.h b/include/cyber_file.h new file mode 100644 index 0000000..01ea0c7 --- /dev/null +++ b/include/cyber_file.h @@ -0,0 +1,75 @@ +/* + * cyber - Add CYBER to your system + * Copyright (C) 2017 Felix Morgner + * + * This program is free software; you can redistribute it and/or modify it + * under the terms and conditions of the GNU General Public License, + * version 2, as published by the Free Software Foundation. + * + * This program is distributed in the hope it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along with + * this program. If not, see . + */ + +#ifndef CYBER_FILE_H +#define CYBER_FILE_H + +#include + +/** + * Initialize the CYBER file + * + * @return zero on success, non-zero otherwise + */ +int cyber_file_init(void); + +/** + * Shutdown the CYBER file + */ +void cyber_file_shutdown(void); + +/** + * Handler for CYBER device open events + * + * @param inode The kernel inode associated with the CYBER device + * @param file The kernel file associated with the CYBER device + * @return zero on success, non-zero otherwise + */ +int cyber_file_open(struct inode * inode, struct file * file); + +/** + * Handler for CYBER device read events + * + * @param file The kernel file associated with the CYBER device + * @param buffer The user-space target buffer for all the CYBER + * @param size The size of the user-space buffer + * @param offset The offset into the CYBER + * @return The number of bytes that were read, negative on error + */ +ssize_t cyber_file_read(struct file * file, char * buffer, size_t size, loff_t * offset); + +/** + * Handler for CYBER device write events + * + * @param file The kernel file associated with the CYBER device + * @param buffer The user-space source buffer for all the CYBER + * @param size The size of the user-space buffer + * @param offset The offset into the CYBER + * @param The number of bytes that were written, negative on error + */ +ssize_t cyber_file_write(struct file * file, char const * buffer, size_t size, loff_t * offset); + +/** + * Handler for CYBER device close events + * + * @param inode The kernel inode associated with the CYBER device + * @param file The kernel file associated with the CYBER device + * @param zero on success, non-zero otherwise + */ +int cyber_file_close(struct inode * inode, struct file * file); + +#endif -- cgit v1.2.3