comparison src/util.h @ 7612:3ae88e96dde2

[gaim-migrate @ 8236] This is an attempt to both fix the directory creation permissions and simplify the creation of nested directories from within gaim at the same time. If you need nested directories, simply call gaim_build_dir with the same arguments you would have given to mkdir and it will recursively create the tree for you. I spent way too much time on this. committer: Tailor Script <[e-mail]>

7611:92d05dd1047f

 * @see gaim_home_dir()
 */
char *gaim_user_dir(void);

/**
 * Creates a temporary file and returns a file pointer to it.
 *
 * This is like mkstemp(), but returns a file pointer and uses a
 * pre-set template. It uses the semantics of tempnam() for the
 * directory to use and allocates the space for the file path.

7612:3ae88e96dde2

 * @see gaim_home_dir()
 */
char *gaim_user_dir(void);

/**
 * Builds a complete path from the root, making any directories along
 * the path which do not already exist.
 * 
 * @param path The path you wish to create.  Note that it must start
 *        from the root or this function will fail.
 * 
 * @param mode Unix-style permissions for this directory.
 * 
 * @return 0 for success, nonzero on any error.
 */
int gaim_build_dir(char *path, int mode);

/**
 * Creates a temporary file and returns a file pointer to it.
 *
 * This is like mkstemp(), but returns a file pointer and uses a
 * pre-set template. It uses the semantics of tempnam() for the
 * directory to use and allocates the space for the file path.