fdtable.h

Go to the documentation of this file.

/*
 * Copyright (c) 2018 Linaro Limited
 *
 * SPDX-License-Identifier: Apache-2.0
 */
#ifndef ZEPHYR_INCLUDE_SYS_FDTABLE_H_
#define ZEPHYR_INCLUDE_SYS_FDTABLE_H_
 
#include <stdarg.h>
#include <sys/types.h>
/* FIXME: For native_posix ssize_t, off_t. */
#include <zephyr/fs/fs.h>
#include <zephyr/sys/mutex.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct fd_op_vtable {
        ssize_t (*read)(void *obj, void *buf, size_t sz);
        ssize_t (*write)(void *obj, const void *buf, size_t sz);
        int (*close)(void *obj);
        int (*ioctl)(void *obj, unsigned int request, va_list args);
};
 
int z_reserve_fd(void);
 
void z_finalize_fd(int fd, void *obj, const struct fd_op_vtable *vtable);
 
int z_alloc_fd(void *obj, const struct fd_op_vtable *vtable);
 
void z_free_fd(int fd);
 
void *z_get_fd_obj(int fd, const struct fd_op_vtable *vtable, int err);
 
void *z_get_fd_obj_and_vtable(int fd, const struct fd_op_vtable **vtable,
                              struct k_mutex **lock);
 
bool z_get_obj_lock_and_cond(void *obj, const struct fd_op_vtable *vtable, struct k_mutex **lock,
                             struct k_condvar **cond);
 
static inline int z_fdtable_call_ioctl(const struct fd_op_vtable *vtable, void *obj,
                                       unsigned long request, ...)
{
        va_list args;
        int res;
 
        va_start(args, request);
        res = vtable->ioctl(obj, request, args);
        va_end(args);
 
        return res;
}
 
enum {
        /* Codes below 0x100 are reserved for fcntl() codes. */
        ZFD_IOCTL_FSYNC = 0x100,
        ZFD_IOCTL_LSEEK,
        ZFD_IOCTL_POLL_PREPARE,
        ZFD_IOCTL_POLL_UPDATE,
        ZFD_IOCTL_POLL_OFFLOAD,
        ZFD_IOCTL_SET_LOCK,
 
        /* Codes above 0x5400 and below 0x5500 are reserved for termios, FIO, etc */
        ZFD_IOCTL_FIONREAD = 0x541B,
        ZFD_IOCTL_FIONBIO = 0x5421,
};
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_SYS_FDTABLE_H_ */