lighttpd 1.4.x
https://www.lighttpd.net/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
612 lines
18 KiB
612 lines
18 KiB
#include "first.h" |
|
|
|
#include "base.h" |
|
#include "buffer.h" |
|
#include "array.h" |
|
#include "log.h" |
|
#include "http_header.h" |
|
#include "sock_addr.h" |
|
|
|
#include "configfile.h" |
|
|
|
#include <string.h> |
|
#include <stdlib.h> /* strtol */ |
|
|
|
/** |
|
* like all glue code this file contains functions which |
|
* are the external interface of lighttpd. The functions |
|
* are used by the server itself and the plugins. |
|
* |
|
* The main-goal is to have a small library in the end |
|
* which is linked against both and which will define |
|
* the interface itself in the end. |
|
* |
|
*/ |
|
|
|
|
|
/* handle global options */ |
|
|
|
/* parse config array */ |
|
int config_insert_values_internal(server *srv, const array *ca, const config_values_t cv[], config_scope_type_t scope) { |
|
size_t i; |
|
const data_unset *du; |
|
|
|
for (i = 0; cv[i].key; i++) { |
|
|
|
if (NULL == (du = array_get_element_klen(ca, cv[i].key, strlen(cv[i].key)))) { |
|
/* no found */ |
|
|
|
continue; |
|
} |
|
|
|
if ((T_CONFIG_SCOPE_SERVER == cv[i].scope) |
|
&& (T_CONFIG_SCOPE_SERVER != scope)) { |
|
/* server scope options should only be set in server scope, not in conditionals */ |
|
log_error_write(srv, __FILE__, __LINE__, "ss", |
|
"DEPRECATED: don't set server options in conditionals, variable:", |
|
cv[i].key); |
|
} |
|
|
|
switch (cv[i].type) { |
|
case T_CONFIG_ARRAY: |
|
if (du->type == TYPE_ARRAY) { |
|
size_t j; |
|
const data_array *da = (const data_array *)du; |
|
|
|
for (j = 0; j < da->value.used; j++) { |
|
data_unset *ds = da->value.data[j]; |
|
if (ds->type == TYPE_STRING || ds->type == TYPE_INTEGER || ds->type == TYPE_ARRAY) { |
|
array_insert_unique(cv[i].destination, ds->fn->copy(ds)); |
|
} else { |
|
log_error_write(srv, __FILE__, __LINE__, "sssbsd", |
|
"the value of an array can only be a string, variable:", |
|
cv[i].key, "[", &ds->key, "], type:", ds->type); |
|
|
|
return -1; |
|
} |
|
} |
|
} else { |
|
log_error_write(srv, __FILE__, __LINE__, "ss", cv[i].key, "should have been a array of strings like ... = ( \"...\" )"); |
|
|
|
return -1; |
|
} |
|
break; |
|
case T_CONFIG_STRING: |
|
if (du->type == TYPE_STRING) { |
|
const data_string *ds = (const data_string *)du; |
|
|
|
buffer_copy_buffer(cv[i].destination, &ds->value); |
|
} else { |
|
log_error_write(srv, __FILE__, __LINE__, "ss", cv[i].key, "should have been a string like ... = \"...\""); |
|
|
|
return -1; |
|
} |
|
break; |
|
case T_CONFIG_SHORT: |
|
switch(du->type) { |
|
case TYPE_INTEGER: { |
|
const data_integer *di = (const data_integer *)du; |
|
|
|
*((unsigned short *)(cv[i].destination)) = di->value; |
|
break; |
|
} |
|
case TYPE_STRING: { |
|
const data_string *ds = (const data_string *)du; |
|
|
|
/* If the value came from an environment variable, then it is a |
|
* data_string, although it may contain a number in ASCII |
|
* decimal format. We try to interpret the string as a decimal |
|
* short before giving up, in order to support setting numeric |
|
* values with environment variables (eg, port number). |
|
*/ |
|
if (ds->value.ptr && *ds->value.ptr) { |
|
char *e; |
|
long l = strtol(ds->value.ptr, &e, 10); |
|
if (e != ds->value.ptr && !*e && l >=0 && l <= 65535) { |
|
*((unsigned short *)(cv[i].destination)) = l; |
|
break; |
|
} |
|
} |
|
|
|
log_error_write(srv, __FILE__, __LINE__, "ssb", "got a string but expected a short:", cv[i].key, &ds->value); |
|
|
|
return -1; |
|
} |
|
default: |
|
log_error_write(srv, __FILE__, __LINE__, "ssds", "unexpected type for key:", cv[i].key, du->type, "expected a short integer, range 0 ... 65535"); |
|
return -1; |
|
} |
|
break; |
|
case T_CONFIG_INT: |
|
switch(du->type) { |
|
case TYPE_INTEGER: { |
|
const data_integer *di = (const data_integer *)du; |
|
|
|
*((unsigned int *)(cv[i].destination)) = di->value; |
|
break; |
|
} |
|
case TYPE_STRING: { |
|
const data_string *ds = (const data_string *)du; |
|
|
|
if (ds->value.ptr && *ds->value.ptr) { |
|
char *e; |
|
long l = strtol(ds->value.ptr, &e, 10); |
|
if (e != ds->value.ptr && !*e && l >= 0) { |
|
*((unsigned int *)(cv[i].destination)) = l; |
|
break; |
|
} |
|
} |
|
|
|
log_error_write(srv, __FILE__, __LINE__, "ssb", "got a string but expected an integer:", cv[i].key, &ds->value); |
|
|
|
return -1; |
|
} |
|
default: |
|
log_error_write(srv, __FILE__, __LINE__, "ssds", "unexpected type for key:", cv[i].key, du->type, "expected an integer, range 0 ... 4294967295"); |
|
return -1; |
|
} |
|
break; |
|
case T_CONFIG_BOOLEAN: |
|
if (du->type == TYPE_STRING) { |
|
const data_string *ds = (const data_string *)du; |
|
|
|
if (buffer_is_equal_string(&ds->value, CONST_STR_LEN("enable"))) { |
|
*((unsigned short *)(cv[i].destination)) = 1; |
|
} else if (buffer_is_equal_string(&ds->value, CONST_STR_LEN("disable"))) { |
|
*((unsigned short *)(cv[i].destination)) = 0; |
|
} else { |
|
log_error_write(srv, __FILE__, __LINE__, "ssbs", "ERROR: unexpected value for key:", cv[i].key, &ds->value, "(enable|disable)"); |
|
|
|
return -1; |
|
} |
|
} else { |
|
log_error_write(srv, __FILE__, __LINE__, "ssss", "ERROR: unexpected type for key:", cv[i].key, "(string)", "\"(enable|disable)\""); |
|
|
|
return -1; |
|
} |
|
break; |
|
case T_CONFIG_LOCAL: |
|
case T_CONFIG_UNSET: |
|
break; |
|
case T_CONFIG_UNSUPPORTED: |
|
log_error_write(srv, __FILE__, __LINE__, "ssss", "ERROR: found unsupported key:", cv[i].key, "-", (char *)(cv[i].destination)); |
|
|
|
srv->config_unsupported = 1; |
|
|
|
break; |
|
case T_CONFIG_DEPRECATED: |
|
log_error_write(srv, __FILE__, __LINE__, "ssss", "ERROR: found deprecated key:", cv[i].key, "-", (char *)(cv[i].destination)); |
|
|
|
srv->config_deprecated = 1; |
|
|
|
break; |
|
} |
|
} |
|
|
|
return 0; |
|
} |
|
|
|
int config_insert_values_global(server *srv, const array *ca, const config_values_t cv[], config_scope_type_t scope) { |
|
size_t i; |
|
const data_unset *du; |
|
|
|
for (i = 0; cv[i].key; i++) { |
|
if (NULL == (du = array_get_element_klen(ca, cv[i].key, strlen(cv[i].key)))) { |
|
/* no found */ |
|
|
|
continue; |
|
} |
|
array_set_key_value(srv->config_touched, CONST_BUF_LEN(&du->key), CONST_STR_LEN("")); |
|
} |
|
|
|
return config_insert_values_internal(srv, ca, cv, scope); |
|
} |
|
|
|
__attribute_cold__ |
|
static const char* cond_result_to_string(cond_result_t cond_result) { |
|
switch (cond_result) { |
|
case COND_RESULT_UNSET: return "unset"; |
|
case COND_RESULT_SKIP: return "skipped"; |
|
case COND_RESULT_FALSE: return "false"; |
|
case COND_RESULT_TRUE: return "true"; |
|
default: return "invalid cond_result_t"; |
|
} |
|
} |
|
|
|
static int config_addrstr_eq_remote_ip_mask(connection *con, const char *addrstr, int nm_bits, sock_addr *rmt) { |
|
/* special-case 0 == nm_bits to mean "all bits of the address" in addrstr */ |
|
sock_addr addr; |
|
if (1 == sock_addr_inet_pton(&addr, addrstr, AF_INET, 0)) { |
|
if (nm_bits > 32) { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: ipv4 netmask too large: %d", nm_bits); |
|
return -1; |
|
} |
|
} else if (1 == sock_addr_inet_pton(&addr, addrstr, AF_INET6, 0)) { |
|
if (nm_bits > 128) { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: ipv6 netmask too large: %d", nm_bits); |
|
return -1; |
|
} |
|
} else { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: ip addr is invalid: %s", addrstr); |
|
return -1; |
|
} |
|
return sock_addr_is_addr_eq_bits(&addr, rmt, nm_bits); |
|
} |
|
|
|
static int config_addrbuf_eq_remote_ip_mask(connection *con, const buffer *string, char *nm_slash, sock_addr *rmt) { |
|
char *err; |
|
int nm_bits = strtol(nm_slash + 1, &err, 10); |
|
size_t addrstrlen = (size_t)(nm_slash - string->ptr); |
|
char addrstr[64]; /*(larger than INET_ADDRSTRLEN and INET6_ADDRSTRLEN)*/ |
|
|
|
if (*err) { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: non-digit found in netmask: %s %s", string->ptr, err); |
|
return -1; |
|
} |
|
|
|
if (nm_bits <= 0) { |
|
if (*(nm_slash+1) == '\0') { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: no number after / %s", string->ptr); |
|
} else { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: invalid netmask <= 0: %s %s", string->ptr, err); |
|
} |
|
return -1; |
|
} |
|
|
|
if (addrstrlen >= sizeof(addrstr)) { |
|
log_error(con->errh, __FILE__, __LINE__, "ERROR: address string too long: %s", string->ptr); |
|
return -1; |
|
} |
|
|
|
memcpy(addrstr, string->ptr, addrstrlen); |
|
addrstr[addrstrlen] = '\0'; |
|
|
|
return config_addrstr_eq_remote_ip_mask(con, addrstr, nm_bits, rmt); |
|
} |
|
|
|
static int data_config_pcre_exec(const data_config *dc, cond_cache_t *cache, const buffer *b); |
|
|
|
static cond_result_t config_check_cond_cached(connection *con, const data_config *dc, const int debug_cond); |
|
|
|
static cond_result_t config_check_cond_nocache(connection *con, const data_config *dc, const int debug_cond) { |
|
static struct const_char_buffer { |
|
const char *ptr; |
|
uint32_t used; |
|
uint32_t size; |
|
} empty_string = { "", 1, 0 }; |
|
|
|
/* check parent first */ |
|
if (dc->parent && dc->parent->context_ndx) { |
|
/** |
|
* a nested conditional |
|
* |
|
* if the parent is not decided yet or false, we can't be true either |
|
*/ |
|
if (debug_cond) { |
|
log_error(con->errh, __FILE__, __LINE__, "go parent %s", dc->parent->key.ptr); |
|
} |
|
|
|
switch (config_check_cond_cached(con, dc->parent, debug_cond)) { |
|
case COND_RESULT_UNSET: |
|
/* decide later */ |
|
return COND_RESULT_UNSET; |
|
case COND_RESULT_SKIP: |
|
case COND_RESULT_FALSE: |
|
/* failed precondition */ |
|
return COND_RESULT_SKIP; |
|
case COND_RESULT_TRUE: |
|
/* proceed */ |
|
break; |
|
} |
|
} |
|
|
|
if (dc->prev) { |
|
/** |
|
* a else branch; can only be executed if the previous branch |
|
* was evaluated as "false" (not unset/skipped/true) |
|
*/ |
|
if (debug_cond) { |
|
log_error(con->errh, __FILE__, __LINE__, "go prev %s", dc->prev->key.ptr); |
|
} |
|
|
|
/* make sure prev is checked first */ |
|
switch (config_check_cond_cached(con, dc->prev, debug_cond)) { |
|
case COND_RESULT_UNSET: |
|
/* decide later */ |
|
return COND_RESULT_UNSET; |
|
case COND_RESULT_SKIP: |
|
case COND_RESULT_TRUE: |
|
/* failed precondition */ |
|
return COND_RESULT_SKIP; |
|
case COND_RESULT_FALSE: |
|
/* proceed */ |
|
break; |
|
} |
|
} |
|
|
|
if (!(con->conditional_is_valid & (1 << dc->comp))) { |
|
if (debug_cond) { |
|
log_error(con->errh, __FILE__, __LINE__, "%d %s not available yet", |
|
dc->comp, |
|
dc->key.ptr); |
|
} |
|
|
|
return COND_RESULT_UNSET; |
|
} |
|
|
|
/* if we had a real result before and weren't cleared just return it */ |
|
cond_cache_t * const cache = &con->cond_cache[dc->context_ndx]; |
|
switch (cache->local_result) { |
|
case COND_RESULT_TRUE: |
|
case COND_RESULT_FALSE: |
|
return cache->local_result; |
|
default: |
|
break; |
|
} |
|
|
|
if (CONFIG_COND_ELSE == dc->cond) return COND_RESULT_TRUE; |
|
|
|
/* pass the rules */ |
|
|
|
buffer *l; |
|
switch (dc->comp) { |
|
case COMP_HTTP_HOST: |
|
|
|
l = con->uri.authority; |
|
|
|
if (buffer_string_is_empty(l)) { |
|
l = (buffer *)&empty_string; |
|
break; |
|
} |
|
|
|
switch(dc->cond) { |
|
case CONFIG_COND_NE: |
|
case CONFIG_COND_EQ: { |
|
unsigned short port = sock_addr_get_port(&con->srv_socket->addr); |
|
if (0 == port) break; |
|
const char *ck_colon = strchr(dc->string.ptr, ':'); |
|
const char *val_colon = strchr(l->ptr, ':'); |
|
|
|
/* append server-port if necessary */ |
|
if (NULL != ck_colon && NULL == val_colon) { |
|
/* condition "host:port" but client send "host" */ |
|
buffer *tb = con->srv->tmp_buf; |
|
buffer_copy_buffer(tb, l); |
|
buffer_append_string_len(tb, CONST_STR_LEN(":")); |
|
buffer_append_int(tb, port); |
|
l = tb; |
|
} else if (NULL != val_colon && NULL == ck_colon) { |
|
/* condition "host" but client send "host:port" */ |
|
buffer *tb = con->srv->tmp_buf; |
|
buffer_copy_string_len(tb, l->ptr, val_colon - l->ptr); |
|
l = tb; |
|
} |
|
break; |
|
} |
|
default: |
|
break; |
|
} |
|
|
|
break; |
|
case COMP_HTTP_REMOTE_IP: { |
|
char *nm_slash; |
|
/* handle remoteip limitations |
|
* |
|
* "10.0.0.1" is provided for all comparisions |
|
* |
|
* only for == and != we support |
|
* |
|
* "10.0.0.1/24" |
|
*/ |
|
|
|
if ((dc->cond == CONFIG_COND_EQ || |
|
dc->cond == CONFIG_COND_NE) && |
|
(NULL != (nm_slash = strchr(dc->string.ptr, '/')))) { |
|
switch (config_addrbuf_eq_remote_ip_mask(con, &dc->string, nm_slash, &con->dst_addr)) { |
|
case 1: return (dc->cond == CONFIG_COND_EQ) ? COND_RESULT_TRUE : COND_RESULT_FALSE; |
|
case 0: return (dc->cond == CONFIG_COND_EQ) ? COND_RESULT_FALSE : COND_RESULT_TRUE; |
|
case -1: return COND_RESULT_FALSE; /*(error parsing configfile entry)*/ |
|
} |
|
} |
|
l = con->dst_addr_buf; |
|
break; |
|
} |
|
case COMP_HTTP_SCHEME: |
|
l = con->uri.scheme; |
|
break; |
|
|
|
case COMP_HTTP_URL: |
|
l = con->uri.path; |
|
break; |
|
|
|
case COMP_HTTP_QUERY_STRING: |
|
l = con->uri.query; |
|
break; |
|
|
|
case COMP_SERVER_SOCKET: |
|
l = con->srv_socket->srv_token; |
|
break; |
|
|
|
case COMP_HTTP_REQUEST_HEADER: |
|
*((const buffer **)&l) = http_header_request_get(con, HTTP_HEADER_UNSPECIFIED, CONST_BUF_LEN(dc->comp_tag)); |
|
if (NULL == l) l = (buffer *)&empty_string; |
|
break; |
|
case COMP_HTTP_REQUEST_METHOD: |
|
l = con->srv->tmp_buf; |
|
buffer_clear(l); |
|
http_method_append(l, con->request.http_method); |
|
break; |
|
default: |
|
return COND_RESULT_FALSE; |
|
} |
|
|
|
if (NULL == l) { /*(should not happen)*/ |
|
log_error(con->errh, __FILE__, __LINE__, |
|
"%s () compare to NULL", dc->comp_key->ptr); |
|
return COND_RESULT_FALSE; |
|
} |
|
else if (debug_cond) { |
|
log_error(con->errh, __FILE__, __LINE__, |
|
"%s (%s) compare to %s", dc->comp_key->ptr, l->ptr, dc->string.ptr); |
|
} |
|
|
|
switch(dc->cond) { |
|
case CONFIG_COND_NE: |
|
case CONFIG_COND_EQ: |
|
if (buffer_is_equal(l, &dc->string)) { |
|
return (dc->cond == CONFIG_COND_EQ) ? COND_RESULT_TRUE : COND_RESULT_FALSE; |
|
} else { |
|
return (dc->cond == CONFIG_COND_EQ) ? COND_RESULT_FALSE : COND_RESULT_TRUE; |
|
} |
|
case CONFIG_COND_NOMATCH: |
|
case CONFIG_COND_MATCH: { |
|
if (data_config_pcre_exec(dc, cache, l) > 0) { |
|
return (dc->cond == CONFIG_COND_MATCH) ? COND_RESULT_TRUE : COND_RESULT_FALSE; |
|
} else { |
|
/* cache is already cleared */ |
|
return (dc->cond == CONFIG_COND_MATCH) ? COND_RESULT_FALSE : COND_RESULT_TRUE; |
|
} |
|
} |
|
default: |
|
/* no way */ |
|
break; |
|
} |
|
|
|
return COND_RESULT_FALSE; |
|
} |
|
|
|
static cond_result_t config_check_cond_cached(connection *con, const data_config *dc, const int debug_cond) { |
|
cond_cache_t * const cache = &con->cond_cache[dc->context_ndx]; |
|
int offset = 2; |
|
|
|
if (COND_RESULT_UNSET == cache->result) { |
|
offset = 0; |
|
cache->result = config_check_cond_nocache(con, dc, debug_cond); |
|
switch (cache->result) { |
|
case COND_RESULT_FALSE: |
|
case COND_RESULT_TRUE: |
|
/* remember result of local condition for a partial reset */ |
|
cache->local_result = cache->result; |
|
break; |
|
default: |
|
break; |
|
} |
|
} |
|
|
|
if (debug_cond) { |
|
log_error(con->errh, __FILE__, __LINE__, "%d (%s) result: %s", |
|
dc->context_ndx, |
|
"uncached"+offset, |
|
cond_result_to_string(cache->result)); |
|
} |
|
|
|
return cache->result; |
|
} |
|
|
|
__attribute_noinline__ |
|
static cond_result_t config_check_cond_calc(connection *con, const int context_ndx) { |
|
const data_config * const dc = (const data_config *) |
|
con->srv->config_context->data[context_ndx]; |
|
const int debug_cond = con->conf.log_condition_handling; |
|
if (debug_cond) { |
|
log_error(con->errh, __FILE__, __LINE__, |
|
"=== start of condition block ==="); |
|
} |
|
return config_check_cond_cached(con, dc, debug_cond); |
|
} |
|
|
|
/* future: might make static inline in header for plugins */ |
|
int config_check_cond(connection * const con, const int context_ndx) { |
|
const cond_cache_t * const cache = &con->cond_cache[context_ndx]; |
|
return COND_RESULT_TRUE |
|
== (COND_RESULT_UNSET != cache->result |
|
? cache->result |
|
: config_check_cond_calc(con, context_ndx)); |
|
} |
|
|
|
/* if we reset the cache result for a node, we also need to clear all |
|
* child nodes and else-branches*/ |
|
static void config_cond_clear_node(server *srv, connection *con, const data_config *dc) { |
|
/* if a node is "unset" all children are unset too */ |
|
if (con->cond_cache[dc->context_ndx].result != COND_RESULT_UNSET) { |
|
size_t i; |
|
|
|
#if 0 |
|
/* (redundant; matches not relevant unless COND_RESULT_TRUE) */ |
|
switch (con->cond_cache[dc->context_ndx].local_result) { |
|
case COND_RESULT_TRUE: |
|
case COND_RESULT_FALSE: |
|
break; |
|
default: |
|
con->cond_cache[dc->context_ndx].patterncount = 0; |
|
con->cond_cache[dc->context_ndx].comp_value = NULL; |
|
} |
|
#endif |
|
con->cond_cache[dc->context_ndx].result = COND_RESULT_UNSET; |
|
|
|
for (i = 0; i < dc->children.used; ++i) { |
|
const data_config *dc_child = dc->children.data[i]; |
|
if (NULL == dc_child->prev) { |
|
/* only call for first node in if-else chain */ |
|
config_cond_clear_node(srv, con, dc_child); |
|
} |
|
} |
|
if (NULL != dc->next) config_cond_clear_node(srv, con, dc->next); |
|
} |
|
} |
|
|
|
/** |
|
* reset the config-cache for a named item |
|
* |
|
* if the item is COND_LAST_ELEMENT we reset all items |
|
*/ |
|
void config_cond_cache_reset_item(server *srv, connection *con, comp_key_t item) { |
|
for (uint32_t i = 0; i < srv->config_context->used; ++i) { |
|
const data_config *dc = (data_config *)srv->config_context->data[i]; |
|
|
|
if (item == dc->comp) { |
|
/* clear local_result */ |
|
con->cond_cache[i].local_result = COND_RESULT_UNSET; |
|
/* clear result in subtree (including the node itself) */ |
|
config_cond_clear_node(srv, con, dc); |
|
} |
|
} |
|
} |
|
|
|
/** |
|
* reset the config cache to its initial state at connection start |
|
*/ |
|
void config_cond_cache_reset(server *srv, connection *con) { |
|
cond_cache_t * const cond_cache = con->cond_cache; |
|
con->conditional_is_valid = 0; |
|
/* resetting all entries; no need to follow children as in config_cond_cache_reset_item */ |
|
for (uint32_t i = 1, used = srv->config_context->used; i < used; ++i) { |
|
cond_cache[i].result = COND_RESULT_UNSET; |
|
cond_cache[i].local_result = COND_RESULT_UNSET; |
|
cond_cache[i].patterncount = 0; |
|
cond_cache[i].comp_value = NULL; |
|
} |
|
} |
|
|
|
#ifdef HAVE_PCRE_H |
|
#include <pcre.h> |
|
#endif |
|
|
|
static int data_config_pcre_exec(const data_config *dc, cond_cache_t *cache, const buffer *b) { |
|
#ifdef HAVE_PCRE_H |
|
#ifndef elementsof |
|
#define elementsof(x) (sizeof(x) / sizeof(x[0])) |
|
#endif |
|
cache->patterncount = |
|
pcre_exec(dc->regex, dc->regex_study, CONST_BUF_LEN(b), 0, 0, |
|
cache->matches, elementsof(cache->matches)); |
|
if (cache->patterncount > 0) |
|
cache->comp_value = b; /* holds pointer to b (!) for pattern subst */ |
|
return cache->patterncount; |
|
#else |
|
UNUSED(dc); |
|
UNUSED(cache); |
|
UNUSED(b); |
|
return 0; |
|
#endif |
|
}
|
|
|