diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/dktools/dk4mkdhw.h |
Initial commit
Diffstat (limited to 'support/dktools/dk4mkdhw.h')
-rw-r--r-- | support/dktools/dk4mkdhw.h | 144 |
1 files changed, 144 insertions, 0 deletions
diff --git a/support/dktools/dk4mkdhw.h b/support/dktools/dk4mkdhw.h new file mode 100644 index 0000000000..c54a082412 --- /dev/null +++ b/support/dktools/dk4mkdhw.h @@ -0,0 +1,144 @@ +/* + WARNING: This file was generated by dkct. + Changes you make here will be lost if dkct is run again! + You should modify the original source and run dkct on it. + Original source: dk4mkdhw.ctr +*/ + +/* +Copyright (C) 2015-2017, Dirk Krause + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. +* Redistributions in binary form must reproduce the above opyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. +* Neither the name of the author nor the names of contributors may be used + to endorse or promote products derived from this software without specific + prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. +IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY +DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ + +#ifndef DK4MKDHW_H_INCLUDED +/** Avoid multiple inclusions. */ +#define DK4MKDHW_H_INCLUDED 1 + + +#line 10 "dk4mkdhw.ctr" + +/** @file + Make directory hierarchy (create all parent directories for a + file or directory and the directory itself if required), + the file or directory name is specified as wchar_t string. +*/ + +#ifndef DK4CONF_H_INCLUDED +#include "dk4conf.h" +#endif + +#ifndef DK4TYPES_H_INCLUDED +#include "dk4types.h" +#endif + +#ifndef DK4ERROR_H_INCLUDED +#include "dk4error.h" +#endif + +#if DK4_HAVE_WCHAR_H +#ifndef WCHAR_H_INCLUDED +#include <wchar.h> +#endif +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +/** Find position of first separator for real directory. + + This function is not intended for use in application programs, + it is exported only for use from the dk4appmkdh module. + + The function either returns a value or sets the back variable + to 1 or reports an error. + @param fn File name. + @param bptr Pointer to the back variable. + @param lc Flag: Last component in fn is directory too. + @param erp Error report, may be NULL. + @return First separator after a real directory on success if + found, NULL otherwise. +*/ +wchar_t * +dk4mkdir_hierarchy_wc_first_sep(wchar_t *fn, int *bptr, int lc, dk4_er_t *erp); + +/** Check whether directory exists or attempt to create directory. + @param fn File name. + @param ro Flag: Read only (test directory presence), + do not attempt to create directory. + @param erp Error report, may be NULL. + @return 1 if directory is available now, 0 otherwise. + + Error codes: + - DK4_E_INVALID_ARGUMENTS<br> + if fn is NULL, + - DK4_E_NOT_FOUND<br> + if a server/share combination is not present on Windows, + - DK4_E_NON_DIR<br> + if any component in the path is not a directory, + - DK4_E_CREATE_DIR_FAILED<br> + with GetLastError() result in lDetails1 if the CreateDirectory() + function failed. +*/ +int +dk4mkdir_hierarchy_wc_one(const wchar_t *fn, int ro, dk4_er_t *erp); + +/** Create directory structure. + CRT on Windows: Optional. + @param fn File name. + @param lc Flag: Last component in fn is directory too. + @param erp Error report, may be NULL. + @return 1 on success, 0 on error. + + Error codes: + - DK4_E_INVALID_ARGUMENTS<br> + if fn is NULL, + - DK4_E_BUFFER_TOO_SMALL<br> + if fn is too long, + - DK4_E_MATH_OVERFLOW<br> + if a mathematical overflow occured in size allocation, + - DK4_E_NOT_FOUND<br> + if a server/share combination is not present on Windows, + - DK4_E_NON_DIR<br> + if one of the components in fn is not a directory, + - DK4_E_MKDIR_FAILED<br> + with errno in idetails if the function fails to create the directory + or a parent directory, + - DK4_E_CREATE_DIR_FAILED<br> + with GetLastError() result in lDetails1 if the CreateDirectory() + function failed on a Windows system. +*/ +int +dk4mkdir_hierarchy_wc(const wchar_t *fn, int lc, dk4_er_t *erp); + +#ifdef __cplusplus +} +#endif + + + + +#endif |