mirror of
				https://git.proxmox.com/git/mirror_frr
				synced 2025-11-04 08:28:50 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			448 lines
		
	
	
		
			14 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			448 lines
		
	
	
		
			14 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
 | 
						|
/* Interface function header.
 | 
						|
 * Copyright (C) 1999 Kunihiro Ishiguro
 | 
						|
 *
 | 
						|
 * This file is part of GNU Zebra.
 | 
						|
 *
 | 
						|
 * GNU Zebra is free software; you can redistribute it and/or modify it
 | 
						|
 * under the terms of the GNU General Public License as published by the
 | 
						|
 * Free Software Foundation; either version 2, or (at your option) any
 | 
						|
 * later version.
 | 
						|
 *
 | 
						|
 * GNU Zebra is distributed in the hope that it will be useful, but
 | 
						|
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
						|
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 | 
						|
 * General Public License for more details.
 | 
						|
 *
 | 
						|
 * You should have received a copy of the GNU General Public License along
 | 
						|
 * with this program; see the file COPYING; if not, write to the Free Software
 | 
						|
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef _ZEBRA_INTERFACE_H
 | 
						|
#define _ZEBRA_INTERFACE_H
 | 
						|
 | 
						|
#include "redistribute.h"
 | 
						|
#include "vrf.h"
 | 
						|
#include "hook.h"
 | 
						|
 | 
						|
#include "zebra/zebra_l2.h"
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#endif
 | 
						|
 | 
						|
/* For interface multicast configuration. */
 | 
						|
#define IF_ZEBRA_MULTICAST_UNSPEC 0
 | 
						|
#define IF_ZEBRA_MULTICAST_ON     1
 | 
						|
#define IF_ZEBRA_MULTICAST_OFF    2
 | 
						|
 | 
						|
/* For interface shutdown configuration. */
 | 
						|
#define IF_ZEBRA_SHUTDOWN_OFF    0
 | 
						|
#define IF_ZEBRA_SHUTDOWN_ON     1
 | 
						|
 | 
						|
#if defined(HAVE_RTADV)
 | 
						|
/* Router advertisement parameter.  From RFC4861, RFC6275 and RFC4191. */
 | 
						|
struct rtadvconf {
 | 
						|
	/* A flag indicating whether or not the router sends periodic Router
 | 
						|
	   Advertisements and responds to Router Solicitations.
 | 
						|
	   Default: FALSE */
 | 
						|
	int AdvSendAdvertisements;
 | 
						|
 | 
						|
	/* The maximum time allowed between sending unsolicited multicast
 | 
						|
	   Router Advertisements from the interface, in milliseconds.
 | 
						|
	   MUST be no less than 70 ms [RFC6275 7.5] and no greater
 | 
						|
	   than 1800000 ms [RFC4861 6.2.1].
 | 
						|
 | 
						|
	   Default: 600000 milliseconds */
 | 
						|
	int MaxRtrAdvInterval;
 | 
						|
#define RTADV_MAX_RTR_ADV_INTERVAL 600000
 | 
						|
 | 
						|
	/* The minimum time allowed between sending unsolicited multicast
 | 
						|
	   Router Advertisements from the interface, in milliseconds.
 | 
						|
	   MUST be no less than 30 ms [RFC6275 7.5].
 | 
						|
	   MUST be no greater than .75 * MaxRtrAdvInterval.
 | 
						|
 | 
						|
	   Default: 0.33 * MaxRtrAdvInterval */
 | 
						|
	int MinRtrAdvInterval; /* This field is currently unused. */
 | 
						|
#define RTADV_MIN_RTR_ADV_INTERVAL (0.33 * RTADV_MAX_RTR_ADV_INTERVAL)
 | 
						|
 | 
						|
	/* Unsolicited Router Advertisements' interval timer. */
 | 
						|
	int AdvIntervalTimer;
 | 
						|
 | 
						|
	/* The TRUE/FALSE value to be placed in the "Managed address
 | 
						|
	   configuration" flag field in the Router Advertisement.  See
 | 
						|
	   [ADDRCONF].
 | 
						|
 | 
						|
	   Default: FALSE */
 | 
						|
	int AdvManagedFlag;
 | 
						|
 | 
						|
 | 
						|
	/* The TRUE/FALSE value to be placed in the "Other stateful
 | 
						|
	   configuration" flag field in the Router Advertisement.  See
 | 
						|
	   [ADDRCONF].
 | 
						|
 | 
						|
	   Default: FALSE */
 | 
						|
	int AdvOtherConfigFlag;
 | 
						|
 | 
						|
	/* The value to be placed in MTU options sent by the router.  A
 | 
						|
	   value of zero indicates that no MTU options are sent.
 | 
						|
 | 
						|
	   Default: 0 */
 | 
						|
	int AdvLinkMTU;
 | 
						|
 | 
						|
 | 
						|
	/* The value to be placed in the Reachable Time field in the Router
 | 
						|
	   Advertisement messages sent by the router.  The value zero means
 | 
						|
	   unspecified (by this router).  MUST be no greater than 3,600,000
 | 
						|
	   milliseconds (1 hour).
 | 
						|
 | 
						|
	   Default: 0 */
 | 
						|
	uint32_t AdvReachableTime;
 | 
						|
#define RTADV_MAX_REACHABLE_TIME 3600000
 | 
						|
 | 
						|
	/* The value to be placed in the Retrans Timer field in the Router
 | 
						|
	   Advertisement messages sent by the router.  The value zero means
 | 
						|
	   unspecified (by this router).
 | 
						|
 | 
						|
	   Default: 0 */
 | 
						|
	int AdvRetransTimer;
 | 
						|
 | 
						|
	/* The default value to be placed in the Cur Hop Limit field in the
 | 
						|
	   Router Advertisement messages sent by the router.  The value
 | 
						|
	   should be set to that current diameter of the Internet.  The
 | 
						|
	   value zero means unspecified (by this router).
 | 
						|
 | 
						|
	   Default: The value specified in the "Assigned Numbers" RFC
 | 
						|
	   [ASSIGNED] that was in effect at the time of implementation. */
 | 
						|
	int AdvCurHopLimit;
 | 
						|
 | 
						|
	/* The value to be placed in the Router Lifetime field of Router
 | 
						|
	   Advertisements sent from the interface, in seconds.  MUST be
 | 
						|
	   either zero or between MaxRtrAdvInterval and 9000 seconds.  A
 | 
						|
	   value of zero indicates that the router is not to be used as a
 | 
						|
	   default router.
 | 
						|
 | 
						|
	   Default: 3 * MaxRtrAdvInterval */
 | 
						|
	int AdvDefaultLifetime;
 | 
						|
#define RTADV_MAX_RTRLIFETIME 9000 /* 2.5 hours */
 | 
						|
 | 
						|
	/* A list of prefixes to be placed in Prefix Information options in
 | 
						|
	   Router Advertisement messages sent from the interface.
 | 
						|
 | 
						|
	   Default: all prefixes that the router advertises via routing
 | 
						|
	   protocols as being on-link for the interface from which the
 | 
						|
	   advertisement is sent. The link-local prefix SHOULD NOT be
 | 
						|
	   included in the list of advertised prefixes. */
 | 
						|
	struct list *AdvPrefixList;
 | 
						|
 | 
						|
	/* The TRUE/FALSE value to be placed in the "Home agent"
 | 
						|
	   flag field in the Router Advertisement.  See [RFC6275 7.1].
 | 
						|
 | 
						|
	   Default: FALSE */
 | 
						|
	int AdvHomeAgentFlag;
 | 
						|
#ifndef ND_RA_FLAG_HOME_AGENT
 | 
						|
#define ND_RA_FLAG_HOME_AGENT 	0x20
 | 
						|
#endif
 | 
						|
 | 
						|
	/* The value to be placed in Home Agent Information option if Home
 | 
						|
	   Flag is set.
 | 
						|
	   Default: 0 */
 | 
						|
	int HomeAgentPreference;
 | 
						|
 | 
						|
	/* The value to be placed in Home Agent Information option if Home
 | 
						|
	   Flag is set. Lifetime (seconds) MUST not be greater than 18.2
 | 
						|
	   hours.
 | 
						|
	   The value 0 has special meaning: use of AdvDefaultLifetime value.
 | 
						|
 | 
						|
	   Default: 0 */
 | 
						|
	int HomeAgentLifetime;
 | 
						|
#define RTADV_MAX_HALIFETIME 65520 /* 18.2 hours */
 | 
						|
 | 
						|
	/* The TRUE/FALSE value to insert or not an Advertisement Interval
 | 
						|
	   option. See [RFC 6275 7.3]
 | 
						|
 | 
						|
	   Default: FALSE */
 | 
						|
	int AdvIntervalOption;
 | 
						|
 | 
						|
	/* The value to be placed in the Default Router Preference field of
 | 
						|
	   a router advertisement. See [RFC 4191 2.1 & 2.2]
 | 
						|
 | 
						|
	   Default: 0 (medium) */
 | 
						|
	int DefaultPreference;
 | 
						|
#define RTADV_PREF_MEDIUM 0x0 /* Per RFC4191. */
 | 
						|
 | 
						|
	/*
 | 
						|
	 * List of recursive DNS servers to include in the RDNSS option.
 | 
						|
	 * See [RFC8106 5.1]
 | 
						|
	 *
 | 
						|
	 * Default: empty list; do not emit RDNSS option
 | 
						|
	 */
 | 
						|
	struct list *AdvRDNSSList;
 | 
						|
 | 
						|
	/*
 | 
						|
	 * List of DNS search domains to include in the DNSSL option.
 | 
						|
	 * See [RFC8106 5.2]
 | 
						|
	 *
 | 
						|
	 * Default: empty list; do not emit DNSSL option
 | 
						|
	 */
 | 
						|
	struct list *AdvDNSSLList;
 | 
						|
 | 
						|
	uint8_t inFastRexmit; /* True if we're rexmits faster than usual */
 | 
						|
 | 
						|
	/* Track if RA was configured by BGP or by the Operator or both */
 | 
						|
	uint8_t ra_configured;    /* Was RA configured? */
 | 
						|
#define BGP_RA_CONFIGURED (1<<0)  /* BGP configured RA? */
 | 
						|
#define VTY_RA_CONFIGURED (1<<1)  /* Operator configured RA? */
 | 
						|
#define VTY_RA_INTERVAL_CONFIGURED (1<<2)  /* Operator configured RA interval */
 | 
						|
	int NumFastReXmitsRemain; /* Loaded first with number of fast
 | 
						|
				     rexmits to do */
 | 
						|
 | 
						|
#define RTADV_FAST_REXMIT_PERIOD 1 /* 1 sec */
 | 
						|
#define RTADV_NUM_FAST_REXMITS   4 /* Fast Rexmit RA 4 times on certain events */
 | 
						|
};
 | 
						|
 | 
						|
struct rtadv_rdnss {
 | 
						|
	/* Address of recursive DNS server to advertise */
 | 
						|
	struct in6_addr addr;
 | 
						|
 | 
						|
	/*
 | 
						|
	 * Lifetime in seconds; all-ones means infinity, zero
 | 
						|
	 * stop using it.
 | 
						|
	 */
 | 
						|
	uint32_t lifetime;
 | 
						|
 | 
						|
	/* If lifetime not set, use a default of 3*MaxRtrAdvInterval */
 | 
						|
	int lifetime_set;
 | 
						|
};
 | 
						|
 | 
						|
/*
 | 
						|
 * [RFC1035 2.3.4] sets the maximum length of a domain name (a sequence of
 | 
						|
 * labels, each prefixed by a length octet) at 255 octets.
 | 
						|
 */
 | 
						|
#define RTADV_MAX_ENCODED_DOMAIN_NAME 255
 | 
						|
 | 
						|
struct rtadv_dnssl {
 | 
						|
	/* Domain name without trailing root zone dot (NUL-terminated) */
 | 
						|
	char name[RTADV_MAX_ENCODED_DOMAIN_NAME - 1];
 | 
						|
 | 
						|
	/* Name encoded as in [RFC1035 3.1] */
 | 
						|
	uint8_t encoded_name[RTADV_MAX_ENCODED_DOMAIN_NAME];
 | 
						|
 | 
						|
	/* Actual length of encoded_name */
 | 
						|
	size_t encoded_len;
 | 
						|
 | 
						|
	/* Lifetime as for RDNSS */
 | 
						|
	uint32_t lifetime;
 | 
						|
	int lifetime_set;
 | 
						|
};
 | 
						|
 | 
						|
#endif /* HAVE_RTADV */
 | 
						|
 | 
						|
/* Zebra interface type - ones of interest. */
 | 
						|
typedef enum {
 | 
						|
	ZEBRA_IF_OTHER = 0, /* Anything else */
 | 
						|
	ZEBRA_IF_VXLAN,     /* VxLAN interface */
 | 
						|
	ZEBRA_IF_VRF,       /* VRF device */
 | 
						|
	ZEBRA_IF_BRIDGE,    /* bridge device */
 | 
						|
	ZEBRA_IF_VLAN,      /* VLAN sub-interface */
 | 
						|
	ZEBRA_IF_MACVLAN,   /* MAC VLAN interface*/
 | 
						|
	ZEBRA_IF_VETH,      /* VETH interface*/
 | 
						|
	ZEBRA_IF_BOND,	    /* Bond */
 | 
						|
	ZEBRA_IF_BOND_SLAVE,	    /* Bond */
 | 
						|
} zebra_iftype_t;
 | 
						|
 | 
						|
/* Zebra "slave" interface type */
 | 
						|
typedef enum {
 | 
						|
	ZEBRA_IF_SLAVE_NONE,   /* Not a slave */
 | 
						|
	ZEBRA_IF_SLAVE_VRF,    /* Member of a VRF */
 | 
						|
	ZEBRA_IF_SLAVE_BRIDGE, /* Member of a bridge */
 | 
						|
	ZEBRA_IF_SLAVE_BOND,   /* Bond member */
 | 
						|
	ZEBRA_IF_SLAVE_OTHER,  /* Something else - e.g., bond slave */
 | 
						|
} zebra_slave_iftype_t;
 | 
						|
 | 
						|
struct irdp_interface;
 | 
						|
 | 
						|
/* `zebra' daemon local interface structure. */
 | 
						|
struct zebra_if {
 | 
						|
	/* Shutdown configuration. */
 | 
						|
	uint8_t shutdown;
 | 
						|
 | 
						|
	/* Multicast configuration. */
 | 
						|
	uint8_t multicast;
 | 
						|
 | 
						|
	/* Router advertise configuration. */
 | 
						|
	uint8_t rtadv_enable;
 | 
						|
 | 
						|
	/* Installed addresses chains tree. */
 | 
						|
	struct route_table *ipv4_subnets;
 | 
						|
 | 
						|
	/* Information about up/down changes */
 | 
						|
	unsigned int up_count;
 | 
						|
	char up_last[QUAGGA_TIMESTAMP_LEN];
 | 
						|
	unsigned int down_count;
 | 
						|
	char down_last[QUAGGA_TIMESTAMP_LEN];
 | 
						|
 | 
						|
#if defined(HAVE_RTADV)
 | 
						|
	struct rtadvconf rtadv;
 | 
						|
	unsigned int ra_sent, ra_rcvd;
 | 
						|
#endif /* HAVE_RTADV */
 | 
						|
 | 
						|
	struct irdp_interface *irdp;
 | 
						|
 | 
						|
#ifdef HAVE_STRUCT_SOCKADDR_DL
 | 
						|
	union {
 | 
						|
		/* note that sdl_storage is never accessed, it only exists to
 | 
						|
		 * make space.
 | 
						|
		 * all actual uses refer to sdl - but use sizeof(sdl_storage)!
 | 
						|
		 * this fits
 | 
						|
		 * best with C aliasing rules. */
 | 
						|
		struct sockaddr_dl sdl;
 | 
						|
		struct sockaddr_storage sdl_storage;
 | 
						|
	};
 | 
						|
#endif
 | 
						|
 | 
						|
#ifdef SUNOS_5
 | 
						|
	/* the real IFF_UP state of the primary interface.
 | 
						|
	 * need this to differentiate between all interfaces being
 | 
						|
	 * down (but primary still plumbed) and primary having gone
 | 
						|
	 * ~IFF_UP, and all addresses gone.
 | 
						|
	 */
 | 
						|
	uint8_t primary_state;
 | 
						|
#endif /* SUNOS_5 */
 | 
						|
 | 
						|
	/* ptm enable configuration */
 | 
						|
	uint8_t ptm_enable;
 | 
						|
 | 
						|
	/* Zebra interface and "slave" interface type */
 | 
						|
	zebra_iftype_t zif_type;
 | 
						|
	zebra_slave_iftype_t zif_slave_type;
 | 
						|
 | 
						|
	/* Additional L2 info, depends on zif_type */
 | 
						|
	union zebra_l2if_info l2info;
 | 
						|
 | 
						|
	/* For members of a bridge, link to bridge. */
 | 
						|
	/* Note: If additional fields become necessary, this can be modified to
 | 
						|
	 * be a pointer to a dynamically allocd struct.
 | 
						|
	 */
 | 
						|
	struct zebra_l2info_brslave brslave_info;
 | 
						|
 | 
						|
	struct zebra_l2info_bondslave bondslave_info;
 | 
						|
 | 
						|
	/* Link fields - for sub-interfaces. */
 | 
						|
	ifindex_t link_ifindex;
 | 
						|
	struct interface *link;
 | 
						|
 | 
						|
	struct thread *speed_update;
 | 
						|
 | 
						|
	/*
 | 
						|
	 * Does this interface have a v6 to v4 ll neighbor entry
 | 
						|
	 * for bgp unnumbered?
 | 
						|
	 */
 | 
						|
	bool v6_2_v4_ll_neigh_entry;
 | 
						|
	char neigh_mac[6];
 | 
						|
	struct in6_addr v6_2_v4_ll_addr6;
 | 
						|
 | 
						|
	/* The description of the interface */
 | 
						|
	char *desc;
 | 
						|
};
 | 
						|
 | 
						|
DECLARE_HOOK(zebra_if_extra_info, (struct vty * vty, struct interface *ifp),
 | 
						|
	     (vty, ifp))
 | 
						|
DECLARE_HOOK(zebra_if_config_wr, (struct vty * vty, struct interface *ifp),
 | 
						|
	     (vty, ifp))
 | 
						|
 | 
						|
static inline void zebra_if_set_ziftype(struct interface *ifp,
 | 
						|
					zebra_iftype_t zif_type,
 | 
						|
					zebra_slave_iftype_t zif_slave_type)
 | 
						|
{
 | 
						|
	struct zebra_if *zif;
 | 
						|
 | 
						|
	zif = (struct zebra_if *)ifp->info;
 | 
						|
	zif->zif_type = zif_type;
 | 
						|
	zif->zif_slave_type = zif_slave_type;
 | 
						|
}
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_VRF(ifp)                                                   \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VRF)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_BRIDGE(ifp)                                                \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_BRIDGE)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_VLAN(ifp)                                                  \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VLAN)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_VXLAN(ifp)                                                 \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VXLAN)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_MACVLAN(ifp)                                               \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_MACVLAN)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_VETH(ifp)                                               \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_type == ZEBRA_IF_VETH)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_BRIDGE_SLAVE(ifp)					\
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_slave_type                      \
 | 
						|
	 == ZEBRA_IF_SLAVE_BRIDGE)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_VRF_SLAVE(ifp)                                             \
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_slave_type == ZEBRA_IF_SLAVE_VRF)
 | 
						|
 | 
						|
#define IS_ZEBRA_IF_BOND_SLAVE(ifp)					\
 | 
						|
	(((struct zebra_if *)(ifp->info))->zif_slave_type                      \
 | 
						|
	 == ZEBRA_IF_SLAVE_BOND)
 | 
						|
 | 
						|
extern void zebra_if_init(void);
 | 
						|
 | 
						|
extern struct interface *if_lookup_by_index_per_ns(struct zebra_ns *, uint32_t);
 | 
						|
extern struct interface *if_lookup_by_name_per_ns(struct zebra_ns *,
 | 
						|
						  const char *);
 | 
						|
extern struct interface *if_link_per_ns(struct zebra_ns *, struct interface *);
 | 
						|
extern const char *ifindex2ifname_per_ns(struct zebra_ns *, unsigned int);
 | 
						|
 | 
						|
extern void if_unlink_per_ns(struct interface *);
 | 
						|
extern void if_nbr_mac_to_ipv4ll_neigh_update(struct interface *fip,
 | 
						|
					      char mac[6],
 | 
						|
					      struct in6_addr *address,
 | 
						|
					      int add);
 | 
						|
extern void if_nbr_ipv6ll_to_ipv4ll_neigh_update(struct interface *ifp,
 | 
						|
						 struct in6_addr *address,
 | 
						|
						 int add);
 | 
						|
extern void if_nbr_ipv6ll_to_ipv4ll_neigh_del_all(struct interface *ifp);
 | 
						|
extern void if_delete_update(struct interface *ifp);
 | 
						|
extern void if_add_update(struct interface *ifp);
 | 
						|
extern void if_up(struct interface *);
 | 
						|
extern void if_down(struct interface *);
 | 
						|
extern void if_refresh(struct interface *);
 | 
						|
extern void if_flags_update(struct interface *, uint64_t);
 | 
						|
extern int if_subnet_add(struct interface *, struct connected *);
 | 
						|
extern int if_subnet_delete(struct interface *, struct connected *);
 | 
						|
extern int ipv6_address_configured(struct interface *ifp);
 | 
						|
extern void if_handle_vrf_change(struct interface *ifp, vrf_id_t vrf_id);
 | 
						|
extern void zebra_if_update_link(struct interface *ifp, ifindex_t link_ifindex,
 | 
						|
				 ns_id_t ns_id);
 | 
						|
extern void zebra_if_update_all_links(void);
 | 
						|
extern void zebra_if_set_protodown(struct interface *ifp, bool down);
 | 
						|
 | 
						|
extern void vrf_add_update(struct vrf *vrfp);
 | 
						|
 | 
						|
#ifdef HAVE_PROC_NET_DEV
 | 
						|
extern void ifstat_update_proc(void);
 | 
						|
#endif /* HAVE_PROC_NET_DEV */
 | 
						|
#ifdef HAVE_NET_RT_IFLIST
 | 
						|
extern void ifstat_update_sysctl(void);
 | 
						|
 | 
						|
#endif /* HAVE_NET_RT_IFLIST */
 | 
						|
#ifdef HAVE_PROC_NET_DEV
 | 
						|
extern int interface_list_proc(void);
 | 
						|
#endif /* HAVE_PROC_NET_DEV */
 | 
						|
#ifdef HAVE_PROC_NET_IF_INET6
 | 
						|
extern int ifaddr_proc_ipv6(void);
 | 
						|
#endif /* HAVE_PROC_NET_IF_INET6 */
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
}
 | 
						|
#endif
 | 
						|
 | 
						|
#endif /* _ZEBRA_INTERFACE_H */
 |