Mirrors_Framework/nuttx
1
0
Fork 0
mirror of https://github.com/apache/nuttx.git synced 2026-06-08 01:42:58 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

fs/vfs/fs_fstat.c: Add file_fstat() function for internal OS use.

Browse Source
This commit is contained in:
ligd
2018-08-26 13:26:37 -06:00
committed by Gregory Nutt
parent 6361f93fda
commit aa52c457cc
2 changed files with 103 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files
include/nuttx/fs/fs.h
+34 -7
View File
@@ -499,7 +499,7 @@ void fs_initialize(void);
* Input Parameters:
* path - The path to the inode to create
* fops - The file operations structure
* mode - inmode privileges (not used)
* mode - Access privileges (not used)
* priv - Private, user data that will be associated with the inode.
*
* Returned Value:
@@ -526,7 +526,7 @@ int register_driver(FAR const char *path,
* Input Parameters:
* path - The path to the inode to create
* bops - The block driver operations structure
* mode - inmode privileges (not used)
* mode - Access privileges (not used)
* priv - Private, user data that will be associated with the inode.
*
* Returned Value:
@@ -881,7 +881,7 @@ int fs_getfilep(int fd, FAR struct file **filep);
* Name: file_read
*
* Description:
* file_read() is an interanl OS interface. It is functionally similar to
* file_read() is an internal OS interface. It is functionally similar to
* the standard read() interface except:
*
* - It does not modify the errno variable,
@@ -908,7 +908,7 @@ ssize_t file_read(FAR struct file *filep, FAR void *buf, size_t nbytes);
* Name: nx_read
*
* Description:
* nx_read() is an interanl OS interface. It is functionally similar to
* nx_read() is an internal OS interface. It is functionally similar to
* the standard read() interface except:
*
* - It does not modify the errno variable, and
@@ -945,7 +945,7 @@ ssize_t file_write(FAR struct file *filep, FAR const void *buf, size_t nbytes);
* Name: nx_write
*
* Description:
* nx_write() writes up to nytes bytes to the file referenced by the file
* nx_write() writes up to nbytes bytes to the file referenced by the file
* descriptor fd from the buffer starting at buf. nx_write() is an
* internal OS function. It is functionally equivalent to write() except
* that:
@@ -961,7 +961,7 @@ ssize_t file_write(FAR struct file *filep, FAR const void *buf, size_t nbytes);
* Returned Value:
* On success, the number of bytes written are returned (zero indicates
* nothing was written). On any failure, a negated errno value is returned
* (see comments withwrite() for a description of the appropriate errno
* (see comments with write() for a description of the appropriate errno
* values).
*
****************************************************************************/
@@ -1089,7 +1089,7 @@ int file_vfcntl(FAR struct file *filep, int cmd, va_list ap);
* Name: file_poll
*
* Description:
* Low-level poll operation based on struc file. This is used both to (1)
* Low-level poll operation based on struct file. This is used both to (1)
* support detached file, and also (2) by fdesc_poll() to perform all
* normal operations on file descriptors descriptors.
*
@@ -1108,6 +1108,33 @@ int file_vfcntl(FAR struct file *filep, int cmd, va_list ap);
int file_poll(FAR struct file *filep, FAR struct pollfd *fds, bool setup);
#endif
/****************************************************************************
* Name: file_fstat
*
* Description:
* file_fstat() is an internal OS interface. It is functionally similar to
* the standard fstat() interface except:
*
* - It does not modify the errno variable,
* - It is not a cancellation point,
* - It does not handle socket descriptors, and
* - It accepts a file structure instance instead of file descriptor.
*
* Input Parameters:
* filep - File structure instance
* buf - The caller provide location in which to return information about
* the open file.
*
* Returned Value:
* Upon successful completion, 0 shall be returned. Otherwise, -1 shall be
* returned and errno set to indicate the error.
*
****************************************************************************/
#if CONFIG_NFILE_DESCRIPTORS > 0
int file_fstat(FAR struct file *filep, FAR struct stat *buf);
#endif
/****************************************************************************
* Name: fdesc_poll
*