aboutsummaryrefslogtreecommitdiff
path: root/toys.h
diff options
context:
space:
mode:
authorRob Landley <rob@landley.net>2009-01-25 16:59:14 -0600
committerRob Landley <rob@landley.net>2009-01-25 16:59:14 -0600
commit53dda1a9cfc453fa5b2e5ff0ed58f8a9c99749a9 (patch)
tree5f2c1f85d1d25debf4159f8539a67eef9f4d927d /toys.h
parentddae5e91f6dc0f5bfb4fdf6d5b5bbd8df25d97f0 (diff)
downloadtoybox-53dda1a9cfc453fa5b2e5ff0ed58f8a9c99749a9.tar.gz
Comment tweaks.
Diffstat (limited to 'toys.h')
-rw-r--r--toys.h13
1 files changed, 9 insertions, 4 deletions
diff --git a/toys.h b/toys.h
index 1896361f..2920cca4 100644
--- a/toys.h
+++ b/toys.h
@@ -54,16 +54,21 @@ struct toy_list *toy_find(char *name);
void toy_init(struct toy_list *which, char *argv[]);
void toy_exec(char *argv[]);
-// List of available applets
+// Flags describing applet behavior.
#define TOYFLAG_USR (1<<0)
#define TOYFLAG_BIN (1<<1)
#define TOYFLAG_SBIN (1<<2)
#define TOYMASK_LOCATION ((1<<4)-1)
+// This is a shell built-in function, running in the same process context.
#define TOYFLAG_NOFORK (1<<4)
+
+// Start applet with a umask of 0 (saves old umask in this.old_umask)
#define TOYFLAG_UMASK (1<<5)
+// Array of available applets
+
extern struct toy_list {
char *name;
void (*toy_main)(void);
@@ -71,7 +76,7 @@ extern struct toy_list {
int flags;
} toy_list[];
-// Global context for any applet.
+// Global context shared by all applets.
extern struct toy_context {
struct toy_list *which; // Which entry in toy_list is this one?
@@ -80,8 +85,8 @@ extern struct toy_context {
unsigned optflags; // Command line option flags from get_optflags()
char **optargs; // Arguments left over from get_optflags()
int optc; // Count of optargs
- int exithelp; // Should error_exit print a usage message first? (Option parsing.)
- int old_umask;
+ int exithelp; // Should error_exit print a usage message first?
+ int old_umask; // Old umask preserved by TOYFLAG_UMASK
} toys;
// One big temporary buffer, for use by applets (not library functions).