| ︙ | | | ︙ | |
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
# define OF_HAVE_SANDBOX
#endif
/*!
* @protocol OFApplicationDelegate OFApplication.h ObjFW/OFApplication.h
*
* @brief A protocol for delegates of OFApplication.
*/
@protocol OFApplicationDelegate <OFObject>
/*!
* @brief A method which is called when the application was initialized and is
* running now.
*/
- (void)applicationDidFinishLaunching;
|
>
>
|
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# define OF_HAVE_SANDBOX
#endif
/*!
* @protocol OFApplicationDelegate OFApplication.h ObjFW/OFApplication.h
*
* @brief A protocol for delegates of OFApplication.
*
* @note Signals are not available on AmigaOS!
*/
@protocol OFApplicationDelegate <OFObject>
/*!
* @brief A method which is called when the application was initialized and is
* running now.
*/
- (void)applicationDidFinishLaunching;
|
| ︙ | | | ︙ | |
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
141
142
143
144
145
146
147
148
|
*
* @brief A class which represents the application as an object.
*
* In order to create a new OFApplication, you should create a class conforming
* to the optional @ref OFApplicationDelegate protocol and put
* `OF_APPLICATION_DELEGATE(NameOfYourClass)` in the .m file of that class.
*/
@interface OFApplication: OFObject
{
OFString *_programName;
OFArray OF_GENERIC(OFString *) *_arguments;
OFMutableDictionary OF_GENERIC(OFString *, OFString *) *_environment;
int *_argc;
char ***_argv;
#ifdef OF_APPLICATION_M
@public
#endif
id <OFApplicationDelegate> _Nullable _delegate;
void (*_Nullable _SIGINTHandler)(id, SEL);
#ifndef OF_WINDOWS
void (*_Nullable _SIGHUPHandler)(id, SEL);
void (*_Nullable _SIGUSR1Handler)(id, SEL);
void (*_Nullable _SIGUSR2Handler)(id, SEL);
#endif
#ifdef OF_HAVE_SANDBOX
OFSandbox *_Nullable _activeSandbox, *_Nullable _activeExecSandbox;
#endif
}
#ifdef OF_HAVE_CLASS_PROPERTIES
@property (class, readonly, nullable, nonatomic)
OFApplication *sharedApplication;
@property (class, readonly, nullable, nonatomic) OFString *programName;
|
>
|
>
|
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
*
* @brief A class which represents the application as an object.
*
* In order to create a new OFApplication, you should create a class conforming
* to the optional @ref OFApplicationDelegate protocol and put
* `OF_APPLICATION_DELEGATE(NameOfYourClass)` in the .m file of that class.
*/
OF_SUBCLASSING_RESTRICTED
@interface OFApplication: OFObject
{
OFString *_programName;
OFArray OF_GENERIC(OFString *) *_arguments;
OFMutableDictionary OF_GENERIC(OFString *, OFString *) *_environment;
int *_argc;
char ***_argv;
#ifdef OF_APPLICATION_M
@public
#endif
id <OFApplicationDelegate> _Nullable _delegate;
void (*_Nullable _SIGINTHandler)(id, SEL);
#ifndef OF_WINDOWS
void (*_Nullable _SIGHUPHandler)(id, SEL);
void (*_Nullable _SIGUSR1Handler)(id, SEL);
void (*_Nullable _SIGUSR2Handler)(id, SEL);
#endif
#ifdef OF_HAVE_SANDBOX
OFSandbox *_Nullable _activeSandbox;
OFSandbox *_Nullable _activeSandboxForChildProcesses;
#endif
}
#ifdef OF_HAVE_CLASS_PROPERTIES
@property (class, readonly, nullable, nonatomic)
OFApplication *sharedApplication;
@property (class, readonly, nullable, nonatomic) OFString *programName;
|
| ︙ | | | ︙ | |
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
#ifdef OF_HAVE_SANDBOX
/*!
* @brief The sandbox currently active for this application.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) OFSandbox *activeSandbox;
/*!
* @brief The sandbox currently active for `exec()`'d processes of this
* application.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic)
OFSandbox *activeExecSandbox;
#endif
/*!
* @brief Returns the only OFApplication instance in the application.
*
* @return The only OFApplication instance in the application
*/
|
|
<
|
|
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
#ifdef OF_HAVE_SANDBOX
/*!
* @brief The sandbox currently active for this application.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic) OFSandbox *activeSandbox;
/*!
* @brief The sandbox currently active for child processes of this application.
*/
@property OF_NULLABLE_PROPERTY (readonly, nonatomic)
OFSandbox *activeSandboxForChildProcesses;
#endif
/*!
* @brief Returns the only OFApplication instance in the application.
*
* @return The only OFApplication instance in the application
*/
|
| ︙ | | | ︙ | |
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
|
#ifdef OF_HAVE_SANDBOX
/*!
* @brief Activates the specified sandbox for the application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* @warning If you allow `exec()`, but do not call
* @ref activateSandboxForExecdProcesses, an `exec()`'d process does not have
* its permissions restricted!
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
+ (void)activateSandbox: (OFSandbox *)sandbox;
/*!
* @brief Activates the specified sandbox for `exec()`'d processes of the
* application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* `unveiledPaths` on the sandbox must *not* be empty, otherwise an
* @ref OFInvalidArgumentException is raised.
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
+ (void)activateSandboxForExecdProcesses: (OFSandbox *)sandbox;
#endif
- (instancetype)init OF_UNAVAILABLE;
/*!
* @brief Gets argc and argv.
*
|
|
|
|
|
|
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
|
#ifdef OF_HAVE_SANDBOX
/*!
* @brief Activates the specified sandbox for the application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* @warning If you allow `exec()`, but do not call
* @ref activateSandboxForChildProcesses:, an `exec()`'d process does
* not have its permissions restricted!
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
+ (void)activateSandbox: (OFSandbox *)sandbox;
/*!
* @brief Activates the specified sandbox for child processes of the
* application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* `unveiledPaths` on the sandbox must *not* be empty, otherwise an
* @ref OFInvalidArgumentException is raised.
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
+ (void)activateSandboxForChildProcesses: (OFSandbox *)sandbox;
#endif
- (instancetype)init OF_UNAVAILABLE;
/*!
* @brief Gets argc and argv.
*
|
| ︙ | | | ︙ | |
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
|
#ifdef OF_HAVE_SANDBOX
/*!
* @brief Activates the specified sandbox for the application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* @warning If you allow `exec()`, but do not call
* @ref activateSandboxForExecdProcesses, an `exec()`'d process does not have
* its permissions restricted!
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
- (void)activateSandbox: (OFSandbox *)sandbox;
/*!
* @brief Activates the specified sandbox for `exec()`'d processes of the
* application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* `unveiledPaths` on the sandbox must *not* be empty, otherwise an
* @ref OFInvalidArgumentException is raised.
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
- (void)activateSandboxForExecdProcesses: (OFSandbox *)sandbox;
#endif
@end
#ifdef __cplusplus
extern "C" {
#endif
extern int of_application_main(int *_Nonnull,
char *_Nullable *_Nonnull[_Nonnull], id <OFApplicationDelegate>);
#ifdef __cplusplus
}
#endif
OF_ASSUME_NONNULL_END
|
|
|
|
|
|
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
|
#ifdef OF_HAVE_SANDBOX
/*!
* @brief Activates the specified sandbox for the application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* @warning If you allow `exec()`, but do not call
* @ref activateSandboxForChildProcesses:, an `exec()`'d process does
* not have its permissions restricted!
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
- (void)activateSandbox: (OFSandbox *)sandbox;
/*!
* @brief Activates the specified sandbox for child processes of the
* application.
*
* This is only available if `OF_HAVE_SANDBOX` is defined.
*
* `unveiledPaths` on the sandbox must *not* be empty, otherwise an
* @ref OFInvalidArgumentException is raised.
*
* @note Once a sandbox has been activated, you cannot activate a different
* sandbox. You can however change the active sandbox and reactivate it.
*
* @param sandbox The sandbox to activate
*/
- (void)activateSandboxForChildProcesses: (OFSandbox *)sandbox;
#endif
@end
#ifdef __cplusplus
extern "C" {
#endif
extern int of_application_main(int *_Nonnull,
char *_Nullable *_Nonnull[_Nonnull], id <OFApplicationDelegate>);
#ifdef __cplusplus
}
#endif
OF_ASSUME_NONNULL_END
|