From: Cristian Toader <cristian.matei.toader@gmail.com>
Date: Thu, 29 Aug 2013 12:44:01 +0000 (+0300)
Subject: documentation update for _array functions
X-Git-Tag: tor-0.2.5.1-alpha~39^2~29
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f93ba9a2ef182faf1d9faacf26012135eb999ccf;p=thirdparty%2Ftor.git

documentation update for _array functions
---

diff --git a/src/common/sandbox.h b/src/common/sandbox.h
index 2c0eb30b8b..51449ca415 100644
--- a/src/common/sandbox.h
+++ b/src/common/sandbox.h
@@ -119,11 +119,10 @@ int sandbox_cfg_allow_open_filename(sandbox_cfg_t **cfg, char *file,
 /** Function used to add a series of open allowed filenames to a supplied
  * configuration.
  *  @param cfg  sandbox configuration.
- *  @param num  number of files.
  *  @param ... all future parameters are specified as pairs of <(char*), 1 / 0>
  *    the char* specifies the path to the allowed file, 1 tells the function
  *    that the char* needs to be free-ed, 0 means the pointer does not need to
- *    be free-ed.
+ *    be free-ed; the final parameter needs to be <NULL, 0>.
  */
 int sandbox_cfg_allow_open_filename_array(sandbox_cfg_t **cfg, ...);
 
@@ -139,11 +138,10 @@ int sandbox_cfg_allow_openat_filename(sandbox_cfg_t **cfg, char *file,
 /** Function used to add a series of openat allowed filenames to a supplied
  * configuration.
  *  @param cfg  sandbox configuration.
- *  @param num  number of files.
  *  @param ... all future parameters are specified as pairs of <(char*), 1 / 0>
  *    the char* specifies the path to the allowed file, 1 tells the function
  *    that the char* needs to be free-ed, 0 means the pointer does not need to
- *    be free-ed.
+ *    be free-ed; the final parameter needs to be <NULL, 0>.
  */
 int sandbox_cfg_allow_openat_filename_array(sandbox_cfg_t **cfg, ...);
 
@@ -158,11 +156,10 @@ int sandbox_cfg_allow_execve(sandbox_cfg_t **cfg, char *com);
 /** Function used to add a series of execve allowed filenames to a supplied
  * configuration.
  *  @param cfg  sandbox configuration.
- *  @param num  number of files.
  *  @param ... all future parameters are specified as pairs of <(char*), 1 / 0>
  *    the char* specifies the path to the allowed file, 1 tells the function
  *    that the char* needs to be free-ed, 0 means the pointer does not need to
- *    be free-ed.
+ *    be free-ed; the final parameter needs to be <NULL, 0>.
  */
 int sandbox_cfg_allow_execve_array(sandbox_cfg_t **cfg, ...);
 
@@ -178,11 +175,10 @@ int sandbox_cfg_allow_stat64_filename(sandbox_cfg_t **cfg, char *file,
 /** Function used to add a series of stat64 allowed filenames to a supplied
  * configuration.
  *  @param cfg  sandbox configuration.
- *  @param num  number of files.
  *  @param ... all future parameters are specified as pairs of <(char*), 1 / 0>
  *    the char* specifies the path to the allowed file, 1 tells the function
  *    that the char* needs to be free-ed, 0 means the pointer does not need to
- *    be free-ed.
+ *    be free-ed; the final parameter needs to be <NULL, 0>.
  */
 int sandbox_cfg_allow_stat64_filename_array(sandbox_cfg_t **cfg, ...);