source: mainline/uspace/lib/libc/include/ipc/vfs.h@ 86018c1

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 86018c1 was 2b88074b, checked in by Martin Decky <martin@…>, 16 years ago

vfs: file descriptors housekeeping changes

  • add support for allocating new file descriptors from the end of the fd range (O_DESC)
  • add support for assigning of an already opened file to a free file descriptor

vfs: VFS_OUT_CLOSE is called only when the file reference count is about to drop to zero
vfs: implement VFS_IN_DUP

libc: optimize current working directory housekeeping

  • using opendir() was an overkill
  • allocate current working directory file descriptor from the end of the fd range using O_DESC (so it doesn't mess with the well-known descriptors 0, 1 and 2)

libc: implement dup2() (via VFS_IN_DUP)

getvc: change stdin/stdout/stderr by a slightly more elegant way (using dup2())
  • Property mode set to 100644
File size: 3.9 KB
Line 
1/*
2 * Copyright (c) 2009 Martin Decky
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 libcipc
30 * @{
31 */
32/** @file
33 */
34
35#ifndef LIBC_IPC_VFS_H_
36#define LIBC_IPC_VFS_H_
37
38#include <sys/types.h>
39#include <ipc/ipc.h>
40
41#define FS_NAME_MAXLEN 20
42#define MAX_PATH_LEN (64 * 1024)
43#define PLB_SIZE (2 * MAX_PATH_LEN)
44
45/* Basic types. */
46typedef int16_t fs_handle_t;
47typedef uint32_t fs_index_t;
48
49/**
50 * A structure like this is passed to VFS by each individual FS upon its
51 * registration. It assosiates a human-readable identifier with each
52 * registered FS.
53 */
54typedef struct {
55 /** Unique identifier of the fs. */
56 char name[FS_NAME_MAXLEN + 1];
57} vfs_info_t;
58
59typedef enum {
60 VFS_IN_OPEN = IPC_FIRST_USER_METHOD,
61 VFS_IN_OPEN_NODE,
62 VFS_IN_READ,
63 VFS_IN_WRITE,
64 VFS_IN_SEEK,
65 VFS_IN_TRUNCATE,
66 VFS_IN_FSTAT,
67 VFS_IN_CLOSE,
68 VFS_IN_MOUNT,
69 VFS_IN_UNMOUNT,
70 VFS_IN_SYNC,
71 VFS_IN_REGISTER,
72 VFS_IN_MKDIR,
73 VFS_IN_UNLINK,
74 VFS_IN_RENAME,
75 VFS_IN_STAT,
76 VFS_IN_DUP
77} vfs_in_request_t;
78
79typedef enum {
80 VFS_OUT_OPEN_NODE = IPC_FIRST_USER_METHOD,
81 VFS_OUT_READ,
82 VFS_OUT_WRITE,
83 VFS_OUT_TRUNCATE,
84 VFS_OUT_CLOSE,
85 VFS_OUT_MOUNT,
86 VFS_OUT_MOUNTED,
87 VFS_OUT_UNMOUNT,
88 VFS_OUT_SYNC,
89 VFS_OUT_STAT,
90 VFS_OUT_LOOKUP,
91 VFS_OUT_DESTROY,
92 VFS_OUT_LAST
93} vfs_out_request_t;
94
95/*
96 * Lookup flags.
97 */
98
99/**
100 * No lookup flags used.
101 */
102#define L_NONE 0
103
104/**
105 * Lookup will succeed only if the object is a regular file. If L_CREATE is
106 * specified, an empty file will be created. This flag is mutually exclusive
107 * with L_DIRECTORY.
108 */
109#define L_FILE 1
110
111/**
112 * Lookup wil succeed only if the object is a directory. If L_CREATE is
113 * specified, an empty directory will be created. This flag is mutually
114 * exclusive with L_FILE.
115 */
116#define L_DIRECTORY 2
117
118/**
119 * When used with L_CREATE, L_EXCLUSIVE will cause the lookup to fail if the
120 * object already exists. L_EXCLUSIVE is implied when L_DIRECTORY is used.
121 */
122#define L_EXCLUSIVE 4
123
124/**
125 * L_CREATE is used for creating both regular files and directories.
126 */
127#define L_CREATE 8
128
129/**
130 * L_LINK is used for linking to an already existing nodes.
131 */
132#define L_LINK 16
133
134/**
135 * L_UNLINK is used to remove leaves from the file system namespace. This flag
136 * cannot be passed directly by the client, but will be set by VFS during
137 * VFS_UNLINK.
138 */
139#define L_UNLINK 32
140
141/**
142 * L_OPEN is used to indicate that the lookup operation is a part of VFS_OPEN
143 * call from the client. This means that the server might allocate some
144 * resources for the opened file. This flag cannot be passed directly by the
145 * client.
146 */
147#define L_OPEN 64
148
149#endif
150
151/** @}
152 */
Note: See TracBrowser for help on using the repository browser.