Changeset 4063

Timestamp:

08/07/07 16:13:20 (1 year ago)

Author:

vboxsync

Message:

Runtime: Added basic RTEnv...(RTENV,..) API.

Files:

• trunk/include/iprt/env.h (modified) (1 diff)
• trunk/include/iprt/types.h (modified) (1 diff)
• trunk/src/VBox/Runtime/Makefile.kmk (modified) (1 diff)
• trunk/src/VBox/Runtime/generic/env-generic.cpp (added)

trunk/include/iprt/env.h

@@ -78 +78 @@
-/** @todo Add the missing environment APIs: safe, printf like, and various modifications. */
-
+/**
+ * Creates an empty environment block.
+ * 
+ * @returns IPRT status code. Typical error is VERR_NO_MEMORY.
+ * 
+ * @param   pEnv        Where to store the handle of the environment block.
+ */
+RTDECL(int) RTEnvCreate(PRTENV pEnv);
+
+/**
+ * Destroys an environment block.
+ *
+ * @returns IPRT status code.
+ *
+ * @param   Env     Handle of the environment block.
+ */
+RTDECL(int) RTEnvDestroy(RTENV Env);
+
+/**
+ * Creates an environment block and fill it with variables from the given
+ * environment array.
+ *
+ * @returns IPRT status code. Typical error is VERR_NO_MEMORY.
+ *
+ * @param   pEnv        Where to store the handle of the environment block.
+ * @param   apszEnv     Pointer to the NULL-terminated array of environment
+ *                      variables. If NULL, the current process' environment
+ *                      will be cloned.
+ */
+RTDECL(int) RTEnvClone(PRTENV pEnv, char const *const *apszEnv);
+
+/** @todo later */
+/*
+RTDECL(int) RTEnvCloneEx(PRTENV pEnv, const RTENV Env);
+
+RTDECL(int) RTEnvExistEx(RTENV Env, const char *pszVar);
+RTDECL(int) RTEnvSetEx(RTENV Env, const char *pszVar, const char *pszValue);
+RTDECL(int) RTEnvGetEx(RTENV Env, const char *pszVar, const char **ppszValue);
+RTDECL(int) RTEnvCountEx(RTENV Env, size_t *cbCount);
+*/
+
+/**
+ * Puts a 'variable=value' string into the environment.
+ *
+ * The supplied string must be in the current process' codepage.
+ * This function makes a copy of the supplied string.
+ * 
+ * @returns IPRT status code. Typical error is VERR_NO_MEMORY.
+ * 
+ * @param   Env                 Handle of the environment block.
+ * @param   pszVarEqualValue    The variable '=' value string. If the value and '=' is 
+ *                              omitted, the variable is removed from the environment.
+ */
+RTDECL(int) RTEnvPutEx(RTENV Env, const char *pszVarEqualValue);
+
+/**
+ * Returns a raw pointer to the array of environment variables of the given
+ * environment block where every variable is a string in format
+ * 'variable=value'.
+ *
+ * All returned strings are in the current process' codepage.
+ * 
+ * @returns Pointer to the raw array of environment variables.
+ * @returns NULL if Env is NULL or invalid.
+ * 
+ * @param   Env                 Handle of the environment block.
+ */
+RTDECL(char const *const *) RTEnvGetArray(RTENV Env);
+
-#endif /* IN_RING3 */
-

trunk/include/iprt/types.h

@@ -935 +935 @@
-#define NIL_RTHEAPSIMPLE                            ((RTHEAPSIMPLE)0)
-
+/** Handle to an environment block. */
+typedef HCPTRTYPE(struct RTENVINTERNAL *)           RTENV;
+/** Pointer to a handle to an environment block. */
+typedef RTENV                                      *PRTENV;
+/** NIL simple heap handle. */
+#define NIL_RTENV                                   ((RTENV)0)
+
-
-/**

trunk/src/VBox/Runtime/Makefile.kmk

@@ -173 +173 @@
-        generic/semfastmutex-generic.cpp \
-        generic/spinlock-generic.cpp \
+        generic/env-generic.cpp \
-        ldr.cpp \
-        ldrFile.cpp \