X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Flibrrd.pod;fp=doc%2Flibrrd.pod;h=4daa93cf73c74bc5533564b60ca8073175e2c1aa;hb=8753076ac00af4a10484417a91d1c07baa872fbe;hp=04a295d520f9de7d341453ff0db3dfb317f0f66d;hpb=75b8cf7a1eff3d24a8567f3209aa023ad4473e95;p=rrdtool.git

diff --git a/doc/librrd.pod b/doc/librrd.pod
index 04a295d..4daa93c 100644
--- a/doc/librrd.pod
+++ b/doc/librrd.pod
@@ -58,6 +58,34 @@ source pointer will be NULL and the count will be zero.
     rrd_free_ptrs(&arr, &arr_size);
     /* here, arr == NULL && arr_size == 0 */
 
+=item B<rrd_mkdir_p(const char *pathname, mode_t mode)>
+
+Create the directory named C<pathname> including all of its parent
+directories (similar to C<mkdir -p> on the command line - see L<mkdir(1)> for
+more information). The argument C<mode> specifies the permissions to use. It
+is modified by the process's C<umask>. See L<mkdir(2)> for more details.
+
+The function returns 0 on success, a negative value else. In case of an error,
+C<errno> is set accordingly. Aside from the errors documented in L<mkdir(2)>,
+the function may fail with the following errors:
+
+=over 4
+
+=item B<EINVAL>
+
+C<pathname> is C<NULL> or the empty string.
+
+=item B<ENOMEM>
+
+Insufficient memory was available.
+
+=item B<any error returned by L<stat(2)>>
+
+=back
+
+In contrast to L<mkdir(2)>, the function does B<not> fail if C<pathname>
+already exists and is a directory.
+
 =item B<rrd_dump_cr_r(char *filename, int opt_header, rrd_output_callback_t cb, void *user)>
 
 In some situations it is necessary to get the output of C<rrd_dump> without