|
Packit |
90a5c9 |
/* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
Packit |
90a5c9 |
* contributor license agreements. See the NOTICE file distributed with
|
|
Packit |
90a5c9 |
* this work for additional information regarding copyright ownership.
|
|
Packit |
90a5c9 |
* The ASF licenses this file to You under the Apache License, Version 2.0
|
|
Packit |
90a5c9 |
* (the "License"); you may not use this file except in compliance with
|
|
Packit |
90a5c9 |
* the License. You may obtain a copy of the License at
|
|
Packit |
90a5c9 |
*
|
|
Packit |
90a5c9 |
* http://www.apache.org/licenses/LICENSE-2.0
|
|
Packit |
90a5c9 |
*
|
|
Packit |
90a5c9 |
* Unless required by applicable law or agreed to in writing, software
|
|
Packit |
90a5c9 |
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
Packit |
90a5c9 |
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
Packit |
90a5c9 |
* See the License for the specific language governing permissions and
|
|
Packit |
90a5c9 |
* limitations under the License.
|
|
Packit |
90a5c9 |
*/
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
#ifndef mod_md_md_util_h
|
|
Packit |
90a5c9 |
#define mod_md_md_util_h
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
#include <stdio.h>
|
|
Packit |
90a5c9 |
#include <apr_file_io.h>
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
struct apr_array_header_t;
|
|
Packit |
90a5c9 |
struct apr_table_t;
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* pool utils */
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
typedef apr_status_t md_util_action(void *baton, apr_pool_t *p, apr_pool_t *ptemp);
|
|
Packit |
90a5c9 |
typedef apr_status_t md_util_vaction(void *baton, apr_pool_t *p, apr_pool_t *ptemp, va_list ap);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_pool_do(md_util_action *cb, void *baton, apr_pool_t *p);
|
|
Packit |
90a5c9 |
apr_status_t md_util_pool_vdo(md_util_vaction *cb, void *baton, apr_pool_t *p, ...);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* string related */
|
|
Packit |
90a5c9 |
char *md_util_str_tolower(char *s);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
int md_array_str_index(const struct apr_array_header_t *array, const char *s,
|
|
Packit |
90a5c9 |
int start, int case_sensitive);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
int md_array_str_eq(const struct apr_array_header_t *a1,
|
|
Packit |
90a5c9 |
const struct apr_array_header_t *a2, int case_sensitive);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
struct apr_array_header_t *md_array_str_clone(apr_pool_t *p, struct apr_array_header_t *array);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
struct apr_array_header_t *md_array_str_compact(apr_pool_t *p, struct apr_array_header_t *src,
|
|
Packit |
90a5c9 |
int case_sensitive);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
struct apr_array_header_t *md_array_str_remove(apr_pool_t *p, struct apr_array_header_t *src,
|
|
Packit |
90a5c9 |
const char *exclude, int case_sensitive);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
int md_array_str_add_missing(struct apr_array_header_t *dest,
|
|
Packit |
90a5c9 |
struct apr_array_header_t *src, int case_sensitive);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* process execution */
|
|
Packit |
90a5c9 |
apr_status_t md_util_exec(apr_pool_t *p, const char *cmd, const char * const *argv,
|
|
Packit |
90a5c9 |
int *exit_code);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* dns name check */
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
int md_util_is_dns_name(apr_pool_t *p, const char *hostname, int need_fqdn);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* file system related */
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
struct apr_file_t;
|
|
Packit |
90a5c9 |
struct apr_finfo_t;
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_fopen(FILE **pf, const char *fn, const char *mode);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_fcreatex(struct apr_file_t **pf, const char *fn,
|
|
Packit |
90a5c9 |
apr_fileperms_t perms, apr_pool_t *p);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_path_merge(const char **ppath, apr_pool_t *p, ...);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_is_dir(const char *path, apr_pool_t *pool);
|
|
Packit |
90a5c9 |
apr_status_t md_util_is_file(const char *path, apr_pool_t *pool);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
typedef apr_status_t md_util_file_cb(void *baton, struct apr_file_t *f, apr_pool_t *p);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_freplace(const char *fpath, apr_fileperms_t perms, apr_pool_t *p,
|
|
Packit |
90a5c9 |
md_util_file_cb *write, void *baton);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**
|
|
Packit |
90a5c9 |
* Remove a file/directory and all files/directories contain up to max_level. If max_level == 0,
|
|
Packit |
90a5c9 |
* only an empty directory or a file can be removed.
|
|
Packit |
90a5c9 |
*/
|
|
Packit |
90a5c9 |
apr_status_t md_util_rm_recursive(const char *fpath, apr_pool_t *p, int max_level);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
typedef apr_status_t md_util_fdo_cb(void *baton, apr_pool_t *p, apr_pool_t *ptemp,
|
|
Packit |
90a5c9 |
const char *dir, const char *name,
|
|
Packit |
90a5c9 |
apr_filetype_e ftype);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_files_do(md_util_fdo_cb *cb, void *baton, apr_pool_t *p,
|
|
Packit |
90a5c9 |
const char *path, ...);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**
|
|
Packit |
90a5c9 |
* Depth first traversal of directory tree starting at path.
|
|
Packit |
90a5c9 |
*/
|
|
Packit |
90a5c9 |
apr_status_t md_util_tree_do(md_util_fdo_cb *cb, void *baton, apr_pool_t *p,
|
|
Packit |
90a5c9 |
const char *path, int follow_links);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_ftree_remove(const char *path, apr_pool_t *p);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_text_fread8k(const char **ptext, apr_pool_t *p, const char *fpath);
|
|
Packit |
90a5c9 |
apr_status_t md_text_fcreatex(const char *fpath, apr_fileperms_t
|
|
Packit |
90a5c9 |
perms, apr_pool_t *p, const char *text);
|
|
Packit |
90a5c9 |
apr_status_t md_text_freplace(const char *fpath, apr_fileperms_t perms,
|
|
Packit |
90a5c9 |
apr_pool_t *p, const char *text);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* base64 url encodings */
|
|
Packit |
90a5c9 |
const char *md_util_base64url_encode(const char *data,
|
|
Packit |
90a5c9 |
apr_size_t len, apr_pool_t *pool);
|
|
Packit |
90a5c9 |
apr_size_t md_util_base64url_decode(const char **decoded, const char *encoded,
|
|
Packit |
90a5c9 |
apr_pool_t *pool);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* http/url related */
|
|
Packit |
90a5c9 |
const char *md_util_schemify(apr_pool_t *p, const char *s, const char *def_scheme);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_abs_uri_check(apr_pool_t *p, const char *s, const char **perr);
|
|
Packit |
90a5c9 |
apr_status_t md_util_abs_http_uri_check(apr_pool_t *p, const char *uri, const char **perr);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
const char *md_link_find_relation(const struct apr_table_t *headers,
|
|
Packit |
90a5c9 |
apr_pool_t *pool, const char *relation);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* retry logic */
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
typedef apr_status_t md_util_try_fn(void *baton, int i);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
apr_status_t md_util_try(md_util_try_fn *fn, void *baton, int ignore_errs,
|
|
Packit |
90a5c9 |
apr_interval_time_t timeout, apr_interval_time_t start_delay,
|
|
Packit |
90a5c9 |
apr_interval_time_t max_delay, int backoff);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
/**************************************************************************************************/
|
|
Packit |
90a5c9 |
/* date/time related */
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
#define MD_SECS_PER_HOUR (60*60)
|
|
Packit |
90a5c9 |
#define MD_SECS_PER_DAY (24*MD_SECS_PER_HOUR)
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
const char *md_print_duration(apr_pool_t *p, apr_interval_time_t duration);
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
#endif /* md_util_h */
|