source: mainline/uspace/lib/c/include/vfs/vfs.h@ 75b24cd

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 75b24cd was a6fc88a, checked in by Jakub Jermar <jakub@…>, 9 years ago

Let vfs_link() and vfs_link_path() return the linked file handle

Add an output argument to both vfs_link() and vfs_link_path() so that the
client may receive the file handle of the linked file or directory. This
makes it easy to work with the new file or directory as it is ready to be
opened or in case of a directory to use it as a parent for further
operations without the need for additional vfs_lookup().

  • Property mode set to 100644
File size: 3.9 KB
Line 
1/*
2 * Copyright (c) 2007 Jakub Jermar
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - 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 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libc
30 * @{
31 */
32/** @file
33 */
34
35#ifndef LIBC_VFS_H_
36#define LIBC_VFS_H_
37
38#include <sys/types.h>
39#include <ipc/vfs.h>
40#include <ipc/loc.h>
41#include <adt/list.h>
42#include <stdio.h>
43#include <async.h>
44
45#define MAX_OPEN_FILES 128
46
47enum vfs_change_state_type {
48 VFS_PASS_HANDLE
49};
50
51typedef enum {
52 KIND_FILE,
53 KIND_DIRECTORY,
54} vfs_file_kind_t;
55
56
57struct stat {
58 fs_handle_t fs_handle;
59 service_id_t service_id;
60 fs_index_t index;
61 unsigned int lnkcnt;
62 bool is_file;
63 bool is_directory;
64 aoff64_t size;
65 service_id_t service;
66};
67
68struct statfs {
69 char fs_name[FS_NAME_MAXLEN + 1];
70 uint32_t f_bsize; /* fundamental file system block size */
71 uint64_t f_blocks; /* total data blocks in file system */
72 uint64_t f_bfree; /* free blocks in fs */
73};
74
75extern int vfs_fhandle(FILE *, int *);
76
77extern char *vfs_absolutize(const char *, size_t *);
78extern int vfs_clone(int, int, bool);
79extern int vfs_cwd_get(char *path, size_t);
80extern int vfs_cwd_set(const char *path);
81extern async_exch_t *vfs_exchange_begin(void);
82extern void vfs_exchange_end(async_exch_t *);
83extern int vfs_link(int, const char *, vfs_file_kind_t, int *);
84extern int vfs_link_path(const char *, vfs_file_kind_t, int *);
85extern int vfs_lookup(const char *, int);
86extern int vfs_lookup_open(const char *, int, int);
87extern int vfs_mount_path(const char *, const char *, const char *,
88 const char *, unsigned int, unsigned int);
89extern int vfs_mount(int, const char *, service_id_t, const char *, unsigned,
90 unsigned, int *);
91extern int vfs_open(int, int);
92extern int vfs_pass_handle(async_exch_t *, int, async_exch_t *);
93extern int vfs_put(int);
94extern ssize_t vfs_read(int, aoff64_t *, void *, size_t);
95extern int vfs_read_short(int, aoff64_t, void *, size_t, ssize_t *);
96extern int vfs_receive_handle(bool);
97extern int vfs_rename_path(const char *, const char *);
98extern int vfs_resize(int, aoff64_t);
99extern int vfs_root(void);
100extern void vfs_root_set(int);
101extern int vfs_stat(int, struct stat *);
102extern int vfs_stat_path(const char *, struct stat *);
103extern int vfs_statfs(int, struct statfs *);
104extern int vfs_statfs_path(const char *, struct statfs *);
105extern int vfs_sync(int);
106extern int vfs_unlink(int, const char *, int);
107extern int vfs_unlink_path(const char *);
108extern int vfs_unmount(int);
109extern int vfs_unmount_path(const char *);
110extern int vfs_walk(int, const char *, int);
111extern ssize_t vfs_write(int, aoff64_t *, const void *, size_t);
112extern int vfs_write_short(int, aoff64_t, const void *, size_t, ssize_t *);
113
114#endif
115
116/** @}
117 */
Note: See TracBrowser for help on using the repository browser.