1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
/*
Copyright (C) 1994, 1995 Free Software Foundation
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
struct trivfs_protid
{
struct port_info pi;
uid_t *uids, *gids;
int nuids, ngids;
int isroot;
mach_port_t realnode; /* restricted permissions */
void *hook; /* for user use */
struct trivfs_peropen *po;
};
struct trivfs_peropen
{
void *hook; /* for user use */
int openmodes;
int refcnt;
struct trivfs_control *cntl;
};
struct trivfs_control
{
struct port_info pi;
struct mutex lock;
struct port_class *protid_class;
mach_port_t underlying;
};
/* The user must define these variables. */
extern int trivfs_fstype;
extern int trivfs_fsid;
/* Set these if trivfs should allow read, write,
or execute of file. */
extern int trivfs_support_read;
extern int trivfs_support_write;
extern int trivfs_support_exec;
/* Set this some combination of O_READ, O_WRITE, and O_EXEC;
trivfs will only allow opens of the specified modes.
(trivfs_support_* is not used to validate opens, only actual
operations.) */
extern int trivfs_allow_open;
extern struct port_class *trivfs_protid_portclasses;
extern int trivfs_protid_nportclasses;
extern struct port_class *trivfs_cntl_portclasses;
extern int trivfs_cntl_nportclasses;
/* The user must define this function. This should modify a struct
stat (as returned from the underlying node) for presentation to
callers of io_stat. It is permissable for this function to do
nothing. */
void trivfs_modify_stat (struct stat *);
/* If this variable is set, it is called every time an open happens.
UIDS, GIDS, and FLAGS are from the open; CNTL identifies the
node being opened. This call need not check permissions on the underlying
node. This call can block as necessary, unless O_NONBLOCK is set
in FLAGS. Any desired error can be returned, which will be reflected
to the user and prevent the open from succeeding. */
error_t (*trivfs_check_open_hook) (struct trivfs_control *cntl,
uid_t *uids, u_int nuids,
gid_t *gids, u_int ngids,
int flags);
/* If this variable is set, it is called every time a new protid
structure is created and initialized. */
void (*trivfs_protid_create_hook) (struct trivfs_protid *);
/* If this variable is set, it is called every time a new peropen
structure is created and initialized. */
void (*trivfs_peropen_create_hook) (struct trivfs_peropen *);
/* If this variable is set, it is called every time a protid structure
is about to be destroyed. */
void (*trivfs_protid_destroy_hook) (struct trivfs_protid *);
/* If this variable is set, it is called every time a peropen structure
is about to be destroyed. */
void (*trivfs_peropen_destroy_hook) (struct trivfs_peropen *);
/* Creates a control port for this filesystem and sends it to BOOTSTRAP with
fsys_startup. CONTROL_TYPE is the ports library type for the control
port, and PROTID_TYPE is the type for ports representing opens of this
node. If CONTROL isn't NULL, the trivfs control port is return in it. If
any error occurs sending fsys_startup, it is returned, otherwise 0. */
error_t trivfs_startup(mach_port_t bootstrap,
struct port_class *control_class,
struct port_class *protid_class,
struct trivfs_control **control);
/* Call this to create a new control port and return a receive right
for it; exactly one send right must be created from the returned
receive right. UNDERLYING is the underlying port, such as fsys_startup
returns as the realnode. PROTIDTYPE is the ports type to be used
for ports that refer to this underlying node. CNTLTYPE is the ports type
to be used for the control port for this node. */
mach_port_t trivfs_handle_port (mach_port_t underlying,
struct port_class *control_class,
struct port_class *protid_class);
/* Install these as libports cleanroutines for trivfs_protid_class
and trivfs_cntl_class respectively. */
void trivfs_clean_protid (void *);
void trivfs_clean_cntl (void *);
/* This demultiplees messages for trivfs ports. */
int trivfs_demuxer (mach_msg_header_t *, mach_msg_header_t *);
/* The user must define this function. Someone wants the filesystem
to go away. FLAGS are from the set FSYS_GOAWAY_*; REALNODE,
CNTLTYPE, and PROTIDTYPE are as from the trivfs_handle_port
call which creade this filesystem. */
error_t trivfs_goaway (int flags, mach_port_t realnode,
struct port_class *control_class,
struct port_class *protid_class);
/* Call this to set atime for the node to the current time. */
error_t trivfs_set_atime (struct trivfs_control *cntl);
/* Call this to set mtime for the node to the current time. */
error_t trivfs_set_mtime (struct trivfs_control *cntl);
|