File POSIX API

File POSIX API 的协作图:

宏定义
#define	AT_FDCWD   (-100)

函数
int	open (const char *file, int flags,...)
	RTM_EXPORT (open)
int	openat (int dirfd, const char *path, int flag,...)
int	utimensat (int __fd, const char *__path, const struct timespec __times[2], int __flags)
int	creat (const char *path, mode_t mode)
	RTM_EXPORT (creat)
int	close (int fd)
	RTM_EXPORT (close)
ssize_t	read (int fd, void *buf, size_t len)
	RTM_EXPORT (read)
ssize_t	write (int fd, const void *buf, size_t len)
	RTM_EXPORT (write)
off_t	lseek (int fd, off_t offset, int whence)
	RTM_EXPORT (lseek)
int	rename (const char *old_file, const char *new_file)
	RTM_EXPORT (rename)
int	unlink (const char *pathname)
	RTM_EXPORT (unlink)
int	stat (const char *file, struct stat *buf)
	RTM_EXPORT (stat)
int	fstat (int fildes, struct stat *buf)
	RTM_EXPORT (fstat)
int	fsync (int fildes)
	RTM_EXPORT (fsync)
int	fcntl (int fildes, int cmd,...)
	RTM_EXPORT (fcntl)
int	ioctl (int fildes, int cmd,...)
	RTM_EXPORT (ioctl)
int	ftruncate (int fd, off_t length)
	RTM_EXPORT (ftruncate)
int	statfs (const char *path, struct statfs *buf)
	RTM_EXPORT (statfs)
int	fstatfs (int fildes, struct statfs *buf)
	RTM_EXPORT (fstatfs)
int	mkdir (const char *path, mode_t mode)
	RTM_EXPORT (mkdir)
	FINSH_FUNCTION_EXPORT (mkdir, create a directory)
int	rmdir (const char *pathname)
	RTM_EXPORT (rmdir)
DIR *	opendir (const char *name)
	RTM_EXPORT (opendir)
struct dirent *	readdir (DIR *d)
	RTM_EXPORT (readdir)
long	telldir (DIR *d)
	RTM_EXPORT (telldir)
void	seekdir (DIR *d, long offset)
	RTM_EXPORT (seekdir)
void	rewinddir (DIR *d)
	RTM_EXPORT (rewinddir)
int	closedir (DIR *d)
	RTM_EXPORT (closedir)
int	access (const char *path, int amode)
void	setcwd (char *buf)
	RTM_EXPORT (setcwd)
char *	getcwd (char *buf, size_t size)
	RTM_EXPORT (getcwd)
ssize_t	pread (int fd, void *buf, size_t len, off_t offset)
	RTM_EXPORT (pread)
ssize_t	pwrite (int fd, const void *buf, size_t len, off_t offset)
	RTM_EXPORT (pwrite)

详细描述

宏定义说明

AT_FDCWD

#define AT_FDCWD   (-100)

在文件 dfs_posix.c 第 92 行定义.

函数说明

open()

int open	(	const char *	file,
		int	flags,
			... )

this function is a POSIX compliant version, which will open a file and return a file descriptor according specified flags.

参数

file

the path name of file.

flags

the file open flags. Common values include: Access modes (mutually exclusive): O_RDONLY: Open for read-only access. O_WRONLY: Open for write-only access. O_RDWR: Open for both reading and writing. File status flags (can be combined with bitwise OR |): O_CREAT: Create the file if it does not exist. Requires a mode argument. O_TRUNC: Truncate the file to zero length if it already exists. O_APPEND: Append writes to the end of the file. O_EXCL: Ensure that O_CREAT creates the file exclusively. Other platform-specific flags

返回

the non-negative integer on successful open, others for failed.

在文件 dfs_posix.c 第 48 行定义.

{
    int fd, result;
    struct dfs_file *df = RT_NULL;
    mode_t mode = 0;
 
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    if ((flags & O_CREAT) || (flags & O_TMPFILE) == O_TMPFILE)
    {
        va_list ap;
        va_start(ap, flags);
        mode = va_arg(ap, mode_t);
        va_end(ap);
    }
 
    fd = fd_new();
    if (fd >= 0)
    {
        df = fd_get(fd);
    }
    else
    {
        rt_set_errno(-RT_ERROR);
        return RT_NULL;
    }
 
    result = dfs_file_open(df, file, flags, mode);
    if (result < 0)
    {
        fd_release(fd);
        rt_set_errno(result);
        return -1;
    }
 
    return fd;
}

引用了 dfs_file_open(), fd_get(), fd_new(), fd_release(), dfs_file::flags, dfs_file::mode , 以及 RT_NULL.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [1/28]

RTM_EXPORT

(

open

)

引用了 open().

函数调用图:

openat()

int openat	(	int	dirfd,
		const char *	path,
		int	flag,
			... )

Opens a file relative to a directory file descriptor.

参数

dirfd	The file descriptor of the directory to base the relative path on.
path	The path to the file to be opened, relative to the directory specified by dirfd. Can be an absolute path (in which case dirfd is ignored).
flag	File access and status flags (e.g., O_RDONLY, O_WRONLY, O_CREAT).

返回

On success, returns a new file descriptor for the opened file. On failure, returns -1 and sets errno to indicate the error.

注解

When using relative paths, ensure dirfd is a valid directory descriptor. When pathname is absolute, the dirfd argument is ignored.

在文件 dfs_posix.c 第 110 行定义.

{
    struct dfs_file *d;
    char *fullpath;
    int fd;
 
    if (!path)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    fullpath = (char*)path;
 
    if (path[0] != '/')
    {
        if (dirfd != AT_FDCWD)
        {
            d = fd_get(dirfd);
            if (!d || !d->vnode)
            {
                rt_set_errno(-EBADF);
                return -1;
            }
 
            fullpath = dfs_dentry_full_path(d->dentry);
            if (!fullpath)
            {
                rt_set_errno(-ENOMEM);
                return -1;
            }
        }
    }
 
    fd = open(fullpath, flag, 0);
 
    if (fullpath != path)
    {
        rt_free(fullpath);
    }
 
    return fd;
}

引用了 AT_FDCWD, dfs_file::dentry, dfs_dentry_full_path(), fd_get(), open(), rt_free() , 以及 dfs_file::vnode.

函数调用图:

utimensat()

int utimensat	(	int	__fd,
		const char *	__path,
		const struct timespec	__times[2],
		int	__flags )

在文件 dfs_posix.c 第 154 行定义.

{
    int ret;
    struct stat buffer;
    struct dfs_file *d;
    char *fullpath;
    struct dfs_attr attr;
    time_t current_time;
    char *link_fn = (char *)rt_malloc(DFS_PATH_MAX);
    int err;
 
    if (__path == NULL)
    {
        return -EFAULT;
    }
 
    if (__path[0] == '/' || __fd == AT_FDCWD)
    {
        if (stat(__path, &buffer) < 0)
        {
            return -ENOENT;
        }
        else
        {
            fullpath = (char*)__path;
        }
    }
    else
    {
        if (__fd != AT_FDCWD)
        {
            d = fd_get(__fd);
            if (!d || !d->vnode)
            {
                return -EBADF;
            }
 
            fullpath = dfs_dentry_full_path(d->dentry);
            if (!fullpath)
            {
                rt_set_errno(-ENOMEM);
                return -1;
            }
        }
    }
 
    /*update time*/
    attr.ia_valid = ATTR_ATIME_SET | ATTR_MTIME_SET;
    time(&current_time);
    if (UTIME_NOW == __times[0].tv_nsec)
    {
        attr.ia_atime.tv_sec = current_time;
    }
    else if (UTIME_OMIT != __times[0].tv_nsec)
    {
        attr.ia_atime.tv_sec = __times[0].tv_sec;
    }
    else
    {
        attr.ia_valid &= ~ATTR_ATIME_SET;
    }
 
    if (UTIME_NOW == __times[1].tv_nsec)
    {
        attr.ia_mtime.tv_sec = current_time;
    }
    else if (UTIME_OMIT == __times[1].tv_nsec)
    {
        attr.ia_mtime.tv_sec = __times[1].tv_sec;
    }
    else
    {
        attr.ia_valid &= ~ATTR_MTIME_SET;
    }
 
    if (dfs_file_lstat(fullpath, &buffer) == 0)
    {
        if (S_ISLNK(buffer.st_mode) && (__flags != AT_SYMLINK_NOFOLLOW))
        {
            if (link_fn)
            {
                err = dfs_file_readlink(fullpath, link_fn, DFS_PATH_MAX);
                if (err < 0)
                {
                    rt_free(link_fn);
                    return -ENOENT;
                }
                else
                {
                    fullpath = link_fn;
                    if (dfs_file_stat(fullpath, &buffer) != 0)
                    {
                        rt_free(link_fn);
                        return -ENOENT;
                    }
                }
            }
 
        }
    }
    attr.st_mode = buffer.st_mode;
    ret = dfs_file_setattr(fullpath, &attr);
    rt_free(link_fn);
 
    return ret;
}

引用了 AT_FDCWD, AT_SYMLINK_NOFOLLOW, ATTR_ATIME_SET, ATTR_MTIME_SET, dfs_file::dentry, dfs_dentry_full_path(), dfs_file_lstat(), dfs_file_readlink(), dfs_file_setattr(), dfs_file_stat(), DFS_PATH_MAX, fd_get(), dfs_attr::ia_atime, dfs_attr::ia_mtime, dfs_attr::ia_valid, rt_free(), rt_malloc(), dfs_attr::st_mode, stat(), UTIME_NOW, UTIME_OMIT , 以及 dfs_file::vnode.

函数调用图:

creat()

int creat	(	const char *	path,
		mode_t	mode )

this function is a POSIX compliant version, which will create a new file or rewrite an existing one

参数

path	the path name of file.
mode	the file permission bits to be used in creating the file (not used, can be 0)

返回

the non-negative integer on successful open, others for failed.

在文件 dfs_posix.c 第 270 行定义.

{
    return open(path, O_WRONLY | O_CREAT | O_TRUNC, mode);
}

引用了 open().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [2/28]

RTM_EXPORT

(

creat

)

引用了 creat().

函数调用图:

close()

int close

(

int

fd

)

this function is a POSIX compliant version, which will close the open file descriptor.

参数

fd	the file descriptor.

返回

0 on successful, -1 on failed.

在文件 dfs_posix.c 第 284 行定义.

{
    int result;
    struct dfs_file *file;
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    result = dfs_file_close(file);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    fd_release(fd);
 
    return 0;
}

引用了 dfs_file_close(), fd_get() , 以及 fd_release().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [3/28]

RTM_EXPORT

(

close

)

引用了 close() , 以及 read().

函数调用图:

read()

ssize_t read	(	int	fd,
		void *	buf,
		size_t	len )

this function is a POSIX compliant version, which will read specified data buffer length for an open file descriptor.

参数

fd	the file descriptor.
buf	the buffer to save the read data.
len	the maximal length of data buffer

返回

the actual read data buffer length. If the returned value is 0, it may be reach the end of file, please check errno.

在文件 dfs_posix.c 第 325 行定义.

{
    ssize_t result;
    struct dfs_file *file;
 
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    result = dfs_file_read(file, buf, len);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return result;
}

引用了 dfs_file_read() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [4/28]

RTM_EXPORT

(

read

)

引用了 read() , 以及 write().

函数调用图:

write()

ssize_t write	(	int	fd,
		const void *	buf,
		size_t	len )

this function is a POSIX compliant version, which will write specified data buffer length for an open file descriptor.

参数

fd	the file descriptor
buf	the data buffer to be written.
len	the data buffer length.

返回

the actual written data buffer length.

在文件 dfs_posix.c 第 370 行定义.

{
    ssize_t result;
    struct dfs_file *file;
 
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    result = dfs_file_write(file, buf, len);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return result;
}

引用了 dfs_file_write() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [5/28]

RTM_EXPORT

(

write

)

引用了 write().

函数调用图:

lseek()

off_t lseek	(	int	fd,
		off_t	offset,
		int	whence )

this function is a POSIX compliant version, which will Reposition the file offset for an open file descriptor.

The lseek function sets the file offset for the file descriptor fd to a new value, determined by the offset and whence parameters. It can be used to seek to specific positions in a file for reading or writing.

参数

fd	the file descriptor.
offset	The offset, in bytes, to set the file position. The meaning of offset depends on the value of whence.
whence	the directive of seek. It can be one of: SEEK_SET: Set the offset to offset bytes from the beginning of the file. SEEK_CUR: Set the offset to its current location plus offset bytes. SEEK_END: Set the offset to the size of the file plus offset bytes.

返回

the resulting read/write position in the file, or -1 on failed.

在文件 dfs_posix.c 第 420 行定义.

{
    off_t result;
    struct dfs_file *file;
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    result = dfs_file_lseek(file, offset, whence);
    if (result < 0)
    {
        rt_set_errno(-EPERM);
 
        return -1;
    }
 
    return result;
}

引用了 dfs_file_lseek() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [6/28]

RTM_EXPORT

(

lseek

)

引用了 lseek().

函数调用图:

rename()

int rename	(	const char *	old_file,
		const char *	new_file )

this function is a POSIX compliant version, which will rename old file name to new file name.

参数

old_file	the old file name.
new_file	the new file name.

返回

0 on successful, -1 on failed.

note: the old and new file name must be belong to a same file system.

在文件 dfs_posix.c 第 456 行定义.

{
    int result;
 
    if (old_file == NULL || new_file == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    result = dfs_file_rename(old_file, new_file);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return 0;
}

引用了 dfs_file_rename().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [7/28]

RTM_EXPORT

(

rename

)

引用了 rename().

函数调用图:

unlink()

int unlink

(

const char *

pathname

)

this function is a POSIX compliant version, which will unlink (remove) a specified path file from file system.

参数

pathname

the specified path name to be unlinked.

返回

0 on successful, -1 on failed.

在文件 dfs_posix.c 第 486 行定义.

{
    int result;
    struct stat stat;
 
    if (pathname == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    result = dfs_file_lstat(pathname, &stat);
    if (result == 0 && S_ISDIR(stat.st_mode))
    {
        rt_set_errno(-RT_ERROR);
 
        return -1;
    }
 
    result = dfs_file_unlink(pathname);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return 0;
}

引用了 dfs_file_lstat(), dfs_file_unlink() , 以及 stat().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [8/28]

RTM_EXPORT

(

unlink

)

引用了 unlink().

函数调用图:

stat()

int stat	(	const char *	file,
		struct stat *	buf )

this function is a POSIX compliant version, which will get file information.

参数

file	the file name
buf	the data buffer to save stat description.

返回

0 on successful, -1 on failed.

在文件 dfs_posix.c 第 526 行定义.

{
    int result;
 
    if (file == NULL || buf == NULL)
    {
        rt_set_errno(EBADF);
        return -1;
    }
 
    result = dfs_file_stat(file, buf);
    if (result < 0)
    {
        rt_set_errno(-result);
    }
 
    return result;
}

引用了 dfs_file_stat() , 以及 stat().

函数调用图:

RTM_EXPORT() [9/28]

RTM_EXPORT

(

stat

)

引用了 stat().

函数调用图:

fstat()

int fstat	(	int	fildes,
		struct stat *	buf )

this function is a POSIX compliant version, which will get file status.

参数

fildes	the file description
buf	the data buffer to save stat description.

返回

0 on successful, -1 on failed.

在文件 dfs_posix.c 第 554 行定义.

{
    int ret = -1;
    struct dfs_file *file;
 
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    /* get the fd */
    file = fd_get(fildes);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    if (dfs_is_mounted(file->dentry->mnt) == 0)
    {
        ret = file->dentry->mnt->fs_ops->stat(file->dentry, buf);
    }
 
    return ret;
}

引用了 dfs_file::dentry, dfs_is_mounted(), fd_get(), dfs_mnt::fs_ops, dfs_dentry::mnt, dfs_filesystem_ops::stat , 以及 stat().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [10/28]

RTM_EXPORT

(

fstat

)

引用了 fstat().

函数调用图:

fsync()

int fsync

(

int

fildes

)

this function is a POSIX compliant version, which shall request that all data for the open file descriptor named by fildes is to be transferred to the storage device associated with the file described by fildes.

参数

fildes

the file description

返回

0 on successful completion. Otherwise, -1 shall be returned and errno set to indicate the error.

在文件 dfs_posix.c 第 594 行定义.

{
    int ret;
    struct dfs_file *file;
 
    file = fd_get(fildes);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    ret = dfs_file_fsync(file);
 
    return ret;
}

引用了 dfs_file_fsync() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [11/28]

RTM_EXPORT

(

fsync

)

引用了 fsync().

函数调用图:

fcntl()

int fcntl	(	int	fildes,
		int	cmd,
			... )

this function is a POSIX compliant version, which shall perform a variety of control functions on devices.

参数

fildes	the file description
cmd	the specified command, Common values include: F_DUPFD: Duplicate a file descriptor. F_GETFD: Get the file descriptor flags. F_SETFD: Set the file descriptor flags. F_GETFL: Get the file status flags. F_SETFL: Set the file status flags.
...	represents the additional information that is needed by this specific device to perform the requested function. For example: When cmd is F_SETFL, an additional integer argument specifies the new status flags.

返回

0 on successful completion. Otherwise, -1 shall be returned and errno set to indicate the error.

在文件 dfs_posix.c 第 631 行定义.

{
    int ret = -1;
    struct dfs_file *file;
 
    file = fd_get(fildes);
    if (file)
    {
        void *arg;
        va_list ap;
 
        va_start(ap, cmd);
        arg = va_arg(ap, void *);
        va_end(ap);
 
        ret = dfs_file_ioctl(file, cmd, arg);
        if (ret < 0)
        {
            ret = dfs_file_fcntl(fildes, cmd, (unsigned long)arg);
        }
    }
    else
    {
        ret = -EBADF;
    }
 
    if (ret < 0)
    {
        rt_set_errno(ret);
        ret = -1;
    }
 
    return ret;
}

引用了 dfs_file_fcntl(), dfs_file_ioctl() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [12/28]

RTM_EXPORT

(

fcntl

)

引用了 fcntl().

函数调用图:

ioctl()

int ioctl	(	int	fildes,
		int	cmd,
			... )

this function is a POSIX compliant version, which shall perform a variety of control functions on devices.

参数

fildes	the file description
cmd	the specified command
...	represents the additional information that is needed by this specific device to perform the requested function.

返回

0 on successful completion. Otherwise, -1 shall be returned and errno set to indicate the error.

在文件 dfs_posix.c 第 679 行定义.

{
    void *arg;
    va_list ap;
 
    va_start(ap, cmd);
    arg = va_arg(ap, void *);
    va_end(ap);
 
    /* we use fcntl for this API. */
    return fcntl(fildes, cmd, arg);
}

引用了 fcntl().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [13/28]

RTM_EXPORT

(

ioctl

)

引用了 ioctl().

函数调用图:

ftruncate()

int ftruncate	(	int	fd,
		off_t	length )

this function is a POSIX compliant version, which cause the regular file referenced by fd to be truncated to a size of precisely length bytes.

参数

fd	the file descriptor.
length	the length to be truncated.

返回

Upon successful completion, ftruncate() shall return 0; otherwise, -1 shall be returned and errno set to indicate the error.

在文件 dfs_posix.c 第 703 行定义.

{
    int result;
    struct dfs_file *file;
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    if (length < 0)
    {
        rt_set_errno(-EINVAL);
 
        return -1;
    }
 
    result = dfs_file_ftruncate(file, length);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return 0;
}

引用了 dfs_file_ftruncate() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [14/28]

RTM_EXPORT

(

ftruncate

)

引用了 ftruncate().

函数调用图:

statfs()

int statfs	(	const char *	path,
		struct statfs *	buf )

this function is a POSIX compliant version, which will return the information about a mounted file system.

参数

path	the path which mounted file system.
buf	the buffer to save the returned information.

返回

0 on successful, others on failed.

在文件 dfs_posix.c 第 744 行定义.

{
    int result;
 
    if (path == NULL || buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    result = dfs_statfs(path, buf);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return result;
}

引用了 dfs_statfs() , 以及 statfs().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [15/28]

RTM_EXPORT

(

statfs

)

引用了 statfs().

函数调用图:

fstatfs()

int fstatfs	(	int	fildes,
		struct statfs *	buf )

this function is a POSIX compliant version, which will return the information about a mounted file system.

参数

fildes	the file description.
buf	the buffer to save the returned information.

返回

0 on successful, others on failed.

在文件 dfs_posix.c 第 775 行定义.

{
    int ret = -1;
    struct dfs_file *file;
 
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    /* get the fd */
    file = fd_get(fildes);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    if (dfs_is_mounted(file->dentry->mnt) == 0)
    {
        ret = file->dentry->mnt->fs_ops->statfs(file->dentry->mnt, buf);
    }
 
    return ret;
}

引用了 dfs_file::dentry, dfs_is_mounted(), fd_get(), dfs_mnt::fs_ops, dfs_dentry::mnt, dfs_filesystem_ops::statfs , 以及 statfs().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [16/28]

RTM_EXPORT

(

fstatfs

)

引用了 fstatfs().

函数调用图:

mkdir()

int mkdir	(	const char *	path,
		mode_t	mode )

this function is a POSIX compliant version, which will make a directory

参数

path	the directory path to be made.
mode	The permission mode for the new directory (unused here, can be set to 0).

返回

0 on successful, others on failed.

在文件 dfs_posix.c 第 812 行定义.

{
    int result;
    struct stat stat;
    struct dfs_file file;
 
    if (path == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    if (path && dfs_file_lstat(path, &stat) == 0)
    {
        rt_set_errno(-EEXIST);
        return -1;
    }
 
    dfs_file_init(&file);
 
    result = dfs_file_open(&file, path, O_DIRECTORY | O_CREAT, mode);
    if (result >= 0)
    {
        dfs_file_close(&file);
        result = 0;
    }
    else
    {
        rt_set_errno(result);
        result = -1;
    }
 
    dfs_file_deinit(&file);
 
    return result;
}

引用了 dfs_file_close(), dfs_file_deinit(), dfs_file_init(), dfs_file_lstat(), dfs_file_open(), dfs_file::mode , 以及 stat().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [17/28]

RTM_EXPORT

(

mkdir

)

引用了 mkdir().

函数调用图:

FINSH_FUNCTION_EXPORT()

FINSH_FUNCTION_EXPORT	(	mkdir	,
		create a	directory )

引用了 mkdir().

函数调用图:

rmdir()

int rmdir

(

const char *

pathname

)

this function is a POSIX compliant version, which will remove a directory.

参数

pathname

the path name to be removed.

返回

0 on successful, others on failed.

在文件 dfs_posix.c 第 862 行定义.

{
    int result;
    DIR *dir = RT_NULL;
    struct stat stat;
 
    if (!pathname)
    {
        rt_set_errno(-EPERM);
        return -1;
    }
 
    dir = opendir(pathname);
    if (dir)
    {
        struct dirent *dirent;
 
        while (1)
        {
            dirent = readdir(dir);
            if (dirent == RT_NULL)
                break;
            if (rt_strcmp(".", dirent->d_name) != 0 &&
                rt_strcmp("..", dirent->d_name) != 0)
            {
                break;
            }
        }
 
        closedir(dir);
 
        if (dirent)
        {
            rt_set_errno(-EPERM);
            return -1;
        }
    }
 
    if (dfs_file_lstat(pathname, &stat) == 0)
    {
        if (S_ISLNK(stat.st_mode))
        {
            rt_set_errno(-EPERM);
            return -1;
        }
    }
 
    result = dfs_file_unlink(pathname);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return 0;
}

引用了 closedir(), dfs_file_lstat(), dfs_file_unlink(), opendir(), readdir(), RT_NULL , 以及 stat().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [18/28]

RTM_EXPORT

(

rmdir

)

引用了 rmdir().

函数调用图:

opendir()

DIR * opendir

(

const char *

name

)

this function is a POSIX compliant version, which will open a directory.

参数

name	the path name to be open.

返回

the DIR pointer of directory, NULL on open directory failed.

在文件 dfs_posix.c 第 928 行定义.

{
    DIR *t = RT_NULL;
    int fd, result;
    struct dfs_file *file = RT_NULL;
 
    if (!name || dfs_file_isdir(name) != 0)
    {
        rt_set_errno(-RT_ERROR);
        return RT_NULL;
    }
 
    fd = fd_new();
    if (fd >= 0)
    {
        file = fd_get(fd);
    }
    else
    {
        rt_set_errno(-RT_ERROR);
        return RT_NULL;
    }
 
    result = dfs_file_open(file, name, O_RDONLY | O_DIRECTORY, 0);
    if (result >= 0)
    {
        /* open successfully */
        t = (DIR *) rt_malloc(sizeof(DIR));
        if (t == NULL)
        {
            dfs_file_close(file);
            fd_release(fd);
        }
        else
        {
            rt_memset(t, 0, sizeof(DIR));
 
            t->fd = fd;
        }
 
        return t;
    }
 
    fd_release(fd);
    rt_set_errno(result);
 
    return NULL;
}

引用了 dfs_file_close(), dfs_file_isdir(), dfs_file_open(), fd_get(), fd_new(), fd_release(), rt_malloc() , 以及 RT_NULL.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [19/28]

RTM_EXPORT

(

opendir

)

引用了 opendir().

函数调用图:

readdir()

struct dirent * readdir

(

DIR *

d

)

this function is a POSIX compliant version, which will return a pointer to a dirent structure representing the next directory entry in the directory stream.

参数

d	the directory stream pointer.

返回

the next directory entry, NULL on the end of directory or failed.

在文件 dfs_posix.c 第 987 行定义.

{
    int result;
    struct dirent *dirent = NULL;
 
    if (d == NULL)
    {
        rt_set_errno(-EBADF);
        return NULL;
    }
 
    do
    {
        if (d->num)
        {
            struct dirent *dirent_ptr;
            dirent_ptr = (struct dirent *)&d->buf[d->cur];
            d->cur += dirent_ptr->d_reclen;
        }
 
        if (!d->num || d->cur >= d->num)
        {
            /* get a new entry */
            result = dfs_file_getdents(fd_get(d->fd),
                                       (struct dirent *)d->buf,
                                       sizeof(d->buf) - 1);
            if (result <= 0)
            {
                rt_set_errno(result);
 
                return NULL;
            }
 
            d->num = result;
            d->cur = 0; /* current entry index */
        }
 
        dirent = (struct dirent *)(d->buf + d->cur);
        if (rt_strcmp(".", dirent->d_name) != 0 &&
            rt_strcmp("..", dirent->d_name) != 0)
        {
            break;
        }
    } while (dirent);
 
    return dirent;
}

引用了 dfs_file_getdents() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [20/28]

RTM_EXPORT

(

readdir

)

引用了 readdir().

函数调用图:

telldir()

long telldir

(

DIR *

d

)

this function is a POSIX compliant version, which will return current location in directory stream.

参数

d	the directory stream pointer.

返回

the current location in directory stream.

在文件 dfs_posix.c 第 1044 行定义.

{
    struct dfs_file *file;
    long result;
 
    if (d == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    file = fd_get(d->fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return 0;
    }
 
    result = file->fpos - d->num + d->cur;
 
    return result;
}

引用了 fd_get() , 以及 dfs_file::fpos.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [21/28]

RTM_EXPORT

(

telldir

)

引用了 telldir().

函数调用图:

seekdir()

void seekdir	(	DIR *	d,
		long	offset )

this function is a POSIX compliant version, which will set position of next directory structure in the directory stream.

参数

d	the directory stream.
offset	the offset in directory stream.

在文件 dfs_posix.c 第 1076 行定义.

{
    struct dfs_file *file;
 
    if (d == NULL)
    {
        rt_set_errno(-EBADF);
        return;
    }
 
    file = fd_get(d->fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return;
    }
 
    if (d && d->fd > 0)
    {
        if (file->fpos > offset)
        {
            /* seek to the offset position of directory */
            if (dfs_file_lseek(fd_get(d->fd), 0, SEEK_SET) >= 0)
                d->num = d->cur = 0;
        }
 
        while(file->fpos < offset)
        {
            if (!readdir(d))
            {
                break;
            }
        }
    }
}

引用了 dfs_file_lseek(), fd_get(), dfs_file::fpos , 以及 readdir().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [22/28]

RTM_EXPORT

(

seekdir

)

引用了 seekdir().

函数调用图:

rewinddir()

void rewinddir

(

DIR *

d

)

this function is a POSIX compliant version, which will reset directory stream.

参数

d	the directory stream.

在文件 dfs_posix.c 第 1120 行定义.

{
    if (d && d->fd > 0)
    {
        /* seek to the beginning of directory */
        if (dfs_file_lseek(fd_get(d->fd), 0, SEEK_SET) >= 0)
            d->num = d->cur = 0;
    }
}

引用了 dfs_file_lseek() , 以及 fd_get().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [23/28]

RTM_EXPORT

(

rewinddir

)

引用了 rewinddir().

函数调用图:

closedir()

int closedir

(

DIR *

d

)

this function is a POSIX compliant version, which will close a directory stream.

参数

d	the directory stream.

返回

0 on successful, -1 on failed.

在文件 dfs_posix.c 第 1139 行定义.

{
    int result;
    struct dfs_file *file;
 
    if (d == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    file = fd_get(d->fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    result = dfs_file_close(file);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
    else
    {
        fd_release(d->fd);
        rt_free(d);
    }
 
    return 0;
}

引用了 dfs_file_close(), fd_get(), fd_release() , 以及 rt_free().

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [24/28]

RTM_EXPORT

(

closedir

)

引用了 closedir() , 以及 working_directory.

函数调用图:

access()

int access	(	const char *	path,
		int	amode )

this function is a POSIX compliant version, which shall check the file named by the pathname pointed to by the path argument for accessibility according to the bit pattern contained in amode.

参数

path	the specified file/dir path.
amode	the value is either the bitwise-inclusive OR of the access permissions to be checked (R_OK, W_OK, X_OK) or the existence test (F_OK).

在文件 dfs_posix.c 第 1258 行定义.

{
    struct stat st;
 
    if (path == NULL)
    {
        rt_set_errno(-EINVAL);
        return -1;
    }
 
    if (stat(path, &st) < 0)
    {
        rt_set_errno(-ENOENT);
        return -1;
    }
 
    if (amode == F_OK)
    {
        return 0;
    }
 
    if ((amode & R_OK) && !(st.st_mode & S_IRUSR))
    {
        rt_set_errno(-EACCES);
        return -1;
    }
 
    if ((amode & W_OK) && !(st.st_mode & S_IWUSR))
    {
        rt_set_errno(-EACCES);
        return -1;
    }
 
    if ((amode & X_OK) && !(st.st_mode & S_IXUSR))
    {
        rt_set_errno(-EACCES);
        return -1;
    }
 
    return 0;
}

引用了 stat().

函数调用图:

setcwd()

void setcwd

(

char *

buf

)

this function is a POSIX compliant version, which will set current working directory.

参数

buf	the current directory.

在文件 dfs_posix.c 第 1306 行定义.

{
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return;
    }
 
#ifdef DFS_USING_WORKDIR
    dfs_lock();
#ifdef RT_USING_SMART
    lwp_setcwd(buf);
#else
    rt_strncpy(working_directory, buf, DFS_PATH_MAX);
#endif
    dfs_unlock();
#else
    rt_kprintf(NO_WORKING_DIR);
#endif
 
    return ;
}

引用了 dfs_lock(), DFS_PATH_MAX, dfs_unlock(), NO_WORKING_DIR, rt_kprintf , 以及 working_directory.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [25/28]

RTM_EXPORT

(

setcwd

)

引用了 setcwd().

函数调用图:

getcwd()

char * getcwd	(	char *	buf,
		size_t	size )

this function is a POSIX compliant version, which will return current working directory.

参数

buf	the returned current directory.
size	the buffer size.

返回

the returned current directory.

在文件 dfs_posix.c 第 1339 行定义.

{
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return NULL;
    }
 
#ifdef DFS_USING_WORKDIR
    char *dir_buf = RT_NULL;
 
    dfs_lock();
 
#ifdef RT_USING_SMART
    dir_buf = lwp_getcwd();
#else
    dir_buf = &working_directory[0];
#endif
 
    /* copy to buf parameter */
    if (buf)
    {
        rt_strncpy(buf, dir_buf, size);
    }
 
    dfs_unlock();
#else
    rt_kprintf(NO_WORKING_DIR);
#endif
 
    return buf;
}

引用了 dfs_lock(), dfs_unlock(), NO_WORKING_DIR, rt_kprintf, RT_NULL , 以及 working_directory.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [26/28]

RTM_EXPORT

(

getcwd

)

引用了 getcwd().

函数调用图:

pread()

ssize_t pread	(	int	fd,
		void *	buf,
		size_t	len,
		off_t	offset )

this function is a POSIX compliant version, which will read specified data buffer length for an open file descriptor.

参数

fd	the file descriptor.
buf	the buffer to save the read data.
len	the maximal length of data buffer
offset	the file pos

返回

the actual read data buffer length. If the returned value is 0, it may be reach the end of file, please check errno.

在文件 dfs_posix.c 第 1385 行定义.

{
    ssize_t result;
    off_t fpos;
    struct dfs_file *file;
 
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
 
    /* fpos lock */
    fpos = dfs_file_get_fpos(file);
    result = dfs_file_pread(file, buf, len, offset);
    /* fpos unlock */
    dfs_file_set_fpos(file, fpos);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return result;
}

引用了 dfs_file_get_fpos(), dfs_file_pread(), dfs_file_set_fpos(), fd_get() , 以及 dfs_file::fpos.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [27/28]

RTM_EXPORT

(

pread

)

引用了 pread().

函数调用图:

pwrite()

ssize_t pwrite	(	int	fd,
		const void *	buf,
		size_t	len,
		off_t	offset )

this function is a POSIX compliant version, which will write specified data buffer length for an open file descriptor.

参数

fd	the file descriptor
buf	the data buffer to be written.
len	the data buffer length.
offset	the file pos

返回

the actual written data buffer length.

在文件 dfs_posix.c 第 1432 行定义.

{
    ssize_t result;
    off_t fpos;
    struct dfs_file *file;
 
    if (buf == NULL)
    {
        rt_set_errno(-EBADF);
        return -1;
    }
 
    file = fd_get(fd);
    if (file == NULL)
    {
        rt_set_errno(-EBADF);
 
        return -1;
    }
    /* fpos lock */
    fpos = dfs_file_get_fpos(file);
    result = dfs_file_pwrite(file, buf, len, offset);
    /* fpos unlock */
    dfs_file_set_fpos(file, fpos);
    if (result < 0)
    {
        rt_set_errno(result);
 
        return -1;
    }
 
    return result;
}

引用了 dfs_file_get_fpos(), dfs_file_pwrite(), dfs_file_set_fpos(), fd_get() , 以及 dfs_file::fpos.

函数调用图:

这是这个函数的调用关系图:

RTM_EXPORT() [28/28]

RTM_EXPORT

(

pwrite

)

引用了 pwrite().

函数调用图: