2005-01-07 01:45:51 +00:00
|
|
|
/*-
|
1994-05-24 10:09:53 +00:00
|
|
|
* Copyright (c) 1982, 1986, 1993
|
|
|
|
* The Regents of the University of California. All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
|
|
* documentation and/or other materials provided with the distribution.
|
|
|
|
* 4. Neither the name of the University nor the names of its contributors
|
|
|
|
* may be used to endorse or promote products derived from this software
|
|
|
|
* without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
|
|
|
|
*
|
2001-10-17 10:44:39 +00:00
|
|
|
* @(#)if_loop.c 8.2 (Berkeley) 1/9/95
|
1999-08-28 01:08:13 +00:00
|
|
|
* $FreeBSD$
|
1994-05-24 10:09:53 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Loopback interface driver for protocol testing and timing.
|
|
|
|
*/
|
|
|
|
|
1998-01-09 00:51:57 +00:00
|
|
|
#include "opt_atalk.h"
|
1998-01-08 23:42:31 +00:00
|
|
|
#include "opt_inet.h"
|
1999-12-07 17:39:16 +00:00
|
|
|
#include "opt_inet6.h"
|
1997-12-15 20:31:25 +00:00
|
|
|
#include "opt_ipx.h"
|
2009-02-27 14:12:05 +00:00
|
|
|
#include "opt_route.h"
|
2009-01-10 23:50:23 +00:00
|
|
|
#include "opt_mac.h"
|
1997-12-15 20:31:25 +00:00
|
|
|
|
1994-05-24 10:09:53 +00:00
|
|
|
#include <sys/param.h>
|
|
|
|
#include <sys/systm.h>
|
|
|
|
#include <sys/kernel.h>
|
|
|
|
#include <sys/mbuf.h>
|
2001-01-31 07:58:58 +00:00
|
|
|
#include <sys/module.h>
|
2002-03-04 21:46:00 +00:00
|
|
|
#include <machine/bus.h>
|
|
|
|
#include <sys/rman.h>
|
1994-05-24 10:09:53 +00:00
|
|
|
#include <sys/socket.h>
|
1997-03-24 11:33:46 +00:00
|
|
|
#include <sys/sockio.h>
|
2001-01-29 11:06:26 +00:00
|
|
|
#include <sys/sysctl.h>
|
Commit step 1 of the vimage project, (network stack)
virtualization work done by Marko Zec (zec@).
This is the first in a series of commits over the course
of the next few weeks.
Mark all uses of global variables to be virtualized
with a V_ prefix.
Use macros to map them back to their global names for
now, so this is a NOP change only.
We hope to have caught at least 85-90% of what is needed
so we do not invalidate a lot of outstanding patches again.
Obtained from: //depot/projects/vimage-commit2/...
Reviewed by: brooks, des, ed, mav, julian,
jamie, kris, rwatson, zec, ...
(various people I forgot, different versions)
md5 (with a bit of help)
Sponsored by: NLnet Foundation, The FreeBSD Foundation
X-MFC after: never
V_Commit_Message_Reviewed_By: more people than the patch
2008-08-17 23:27:27 +00:00
|
|
|
#include <sys/vimage.h>
|
1994-05-24 10:09:53 +00:00
|
|
|
|
|
|
|
#include <net/if.h>
|
Major overhaul of pseudo-interface cloning. Highlights include:
- Split the code out into if_clone.[ch].
- Locked struct if_clone. [1]
- Add a per-cloner match function rather then simply matching names of
the form <name><unit> and <name>.
- Use the match function to allow creation of <interface>.<tag>
vlan interfaces. The old way is preserved unchanged!
- Also the match function to allow creation of stf(4) interfaces named
stf0, stf, or 6to4. This is the only major user visible change in
that "ifconfig stf" creates the interface stf rather then stf0 and
does not print "stf0" to stdout.
- Allow destroy functions to fail so they can refuse to delete
interfaces. Currently, we forbid the deletion of interfaces which
were created in the init function, particularly lo0, pflog0, and
pfsync0. In the case of lo0 this was a panic implementation so it
does not count as a user visiable change. :-)
- Since most interfaces do not need the new functionality, an family of
wrapper functions, ifc_simple_*(), were created to wrap old style
cloner functions.
- The IF_CLONE_INITIALIZER macro is replaced with a new incompatible
IFC_CLONE_INITIALIZER and ifc_simple consumers use IFC_SIMPLE_DECLARE
instead.
Submitted by: Maurycy Pawlowski-Wieronski <maurycy at fouk.org> [1]
Reviewed by: andre, mlaier
Discussed on: net
2004-06-22 20:13:25 +00:00
|
|
|
#include <net/if_clone.h>
|
1994-05-24 10:09:53 +00:00
|
|
|
#include <net/if_types.h>
|
|
|
|
#include <net/netisr.h>
|
|
|
|
#include <net/route.h>
|
|
|
|
#include <net/bpf.h>
|
2008-12-02 21:37:28 +00:00
|
|
|
#include <net/vnet.h>
|
1994-05-24 10:09:53 +00:00
|
|
|
|
|
|
|
#ifdef INET
|
|
|
|
#include <netinet/in.h>
|
|
|
|
#include <netinet/in_var.h>
|
|
|
|
#endif
|
|
|
|
|
1995-10-26 20:31:59 +00:00
|
|
|
#ifdef IPX
|
|
|
|
#include <netipx/ipx.h>
|
|
|
|
#include <netipx/ipx_if.h>
|
|
|
|
#endif
|
|
|
|
|
1999-11-22 02:45:11 +00:00
|
|
|
#ifdef INET6
|
|
|
|
#ifndef INET
|
|
|
|
#include <netinet/in.h>
|
|
|
|
#endif
|
|
|
|
#include <netinet6/in6_var.h>
|
2000-07-04 16:35:15 +00:00
|
|
|
#include <netinet/ip6.h>
|
1999-11-22 02:45:11 +00:00
|
|
|
#endif
|
|
|
|
|
1996-05-24 01:35:45 +00:00
|
|
|
#ifdef NETATALK
|
|
|
|
#include <netatalk/at.h>
|
|
|
|
#include <netatalk/at_var.h>
|
2001-09-10 01:33:03 +00:00
|
|
|
#endif
|
1996-05-24 01:35:45 +00:00
|
|
|
|
2009-01-10 23:50:23 +00:00
|
|
|
#include <security/mac/mac_framework.h>
|
|
|
|
|
1994-05-29 07:43:54 +00:00
|
|
|
#ifdef TINY_LOMTU
|
1994-05-24 10:09:53 +00:00
|
|
|
#define LOMTU (1024+512)
|
1999-11-22 02:45:11 +00:00
|
|
|
#elif defined(LARGE_LOMTU)
|
|
|
|
#define LOMTU 131072
|
1994-05-29 07:43:54 +00:00
|
|
|
#else
|
1995-03-04 04:28:50 +00:00
|
|
|
#define LOMTU 16384
|
1994-05-29 07:43:54 +00:00
|
|
|
#endif
|
1994-05-24 10:09:53 +00:00
|
|
|
|
2009-03-16 10:56:50 +00:00
|
|
|
#define LO_CSUM_FEATURES (CSUM_IP | CSUM_TCP | CSUM_UDP | CSUM_SCTP)
|
|
|
|
#define LO_CSUM_SET (CSUM_DATA_VALID | CSUM_PSEUDO_HDR | \
|
|
|
|
CSUM_IP_CHECKED | CSUM_IP_VALID | \
|
|
|
|
CSUM_SCTP_VALID)
|
|
|
|
|
2002-03-04 21:46:00 +00:00
|
|
|
int loioctl(struct ifnet *, u_long, caddr_t);
|
|
|
|
static void lortrequest(int, struct rtentry *, struct rt_addrinfo *);
|
|
|
|
int looutput(struct ifnet *ifp, struct mbuf *m,
|
|
|
|
struct sockaddr *dst, struct rtentry *rt);
|
2006-07-09 06:04:01 +00:00
|
|
|
static int lo_clone_create(struct if_clone *, int, caddr_t);
|
2004-04-14 00:57:49 +00:00
|
|
|
static void lo_clone_destroy(struct ifnet *);
|
First pass at separating per-vnet initializer functions
from existing functions for initializing global state.
At this stage, the new per-vnet initializer functions are
directly called from the existing global initialization code,
which should in most cases result in compiler inlining those
new functions, hence yielding a near-zero functional change.
Modify the existing initializer functions which are invoked via
protosw, like ip_init() et. al., to allow them to be invoked
multiple times, i.e. per each vnet. Global state, if any,
is initialized only if such functions are called within the
context of vnet0, which will be determined via the
IS_DEFAULT_VNET(curvnet) check (currently always true).
While here, V_irtualize a few remaining global UMA zones
used by net/netinet/netipsec networking code. While it is
not yet clear to me or anybody else whether this is the right
thing to do, at this stage this makes the code more readable,
and makes it easier to track uncollected UMA-zone-backed
objects on vnet removal. In the long run, it's quite possible
that some form of shared use of UMA zone pools among multiple
vnets should be considered.
Bump __FreeBSD_version due to changes in layout of structs
vnet_ipfw, vnet_inet and vnet_net.
Approved by: julian (mentor)
2009-04-06 22:29:41 +00:00
|
|
|
static int vnet_loif_iattach(const void *);
|
2002-03-04 21:46:00 +00:00
|
|
|
|
2008-11-19 09:39:34 +00:00
|
|
|
#ifdef VIMAGE_GLOBALS
|
|
|
|
struct ifnet *loif; /* Used externally */
|
|
|
|
#endif
|
2002-03-04 21:46:00 +00:00
|
|
|
|
Introduce vnet module registration / initialization framework with
dependency tracking and ordering enforcement.
With this change, per-vnet initialization functions introduced with
r190787 are no longer directly called from traditional initialization
functions (which cc in most cases inlined to pre-r190787 code), but are
instead registered via the vnet framework first, and are invoked only
after all prerequisite modules have been initialized. In the long run,
this framework should allow us to both initialize and dismantle
multiple vnet instances in a correct order.
The problem this change aims to solve is how to replay the
initialization sequence of various network stack components, which
have been traditionally triggered via different mechanisms (SYSINIT,
protosw). Note that this initialization sequence was and still can be
subtly different depending on whether certain pieces of code have been
statically compiled into the kernel, loaded as modules by boot
loader, or kldloaded at run time.
The approach is simple - we record the initialization sequence
established by the traditional mechanisms whenever vnet_mod_register()
is called for a particular vnet module. The vnet_mod_register_multi()
variant allows a single initializer function to be registered multiple
times but with different arguments - currently this is only used in
kern/uipc_domain.c by net_add_domain() with different struct domain *
as arguments, which allows for protosw-registered initialization
routines to be invoked in a correct order by the new vnet
initialization framework.
For the purpose of identifying vnet modules, each vnet module has to
have a unique ID, which is statically assigned in sys/vimage.h.
Dynamic assignment of vnet module IDs is not supported yet.
A vnet module may specify a single prerequisite module at registration
time by filling in the vmi_dependson field of its vnet_modinfo struct
with the ID of the module it depends on. Unless specified otherwise,
all vnet modules depend on VNET_MOD_NET (container for ifnet list head,
rt_tables etc.), which thus has to and will always be initialized
first. The framework will panic if it detects any unresolved
dependencies before completing system initialization. Detection of
unresolved dependencies for vnet modules registered after boot
(kldloaded modules) is not provided.
Note that the fact that each module can specify only a single
prerequisite may become problematic in the long run. In particular,
INET6 depends on INET being already instantiated, due to TCP / UDP
structures residing in INET container. IPSEC also depends on INET,
which will in turn additionally complicate making INET6-only kernel
configs a reality.
The entire registration framework can be compiled out by turning on the
VIMAGE_GLOBALS kernel config option.
Reviewed by: bz
Approved by: julian (mentor)
2009-04-11 05:58:58 +00:00
|
|
|
#ifndef VIMAGE_GLOBALS
|
|
|
|
static const vnet_modinfo_t vnet_loif_modinfo = {
|
|
|
|
.vmi_id = VNET_MOD_LOIF,
|
|
|
|
.vmi_name = "loif",
|
|
|
|
.vmi_iattach = vnet_loif_iattach
|
|
|
|
};
|
|
|
|
#endif /* !VIMAGE_GLOBALS */
|
|
|
|
|
Major overhaul of pseudo-interface cloning. Highlights include:
- Split the code out into if_clone.[ch].
- Locked struct if_clone. [1]
- Add a per-cloner match function rather then simply matching names of
the form <name><unit> and <name>.
- Use the match function to allow creation of <interface>.<tag>
vlan interfaces. The old way is preserved unchanged!
- Also the match function to allow creation of stf(4) interfaces named
stf0, stf, or 6to4. This is the only major user visible change in
that "ifconfig stf" creates the interface stf rather then stf0 and
does not print "stf0" to stdout.
- Allow destroy functions to fail so they can refuse to delete
interfaces. Currently, we forbid the deletion of interfaces which
were created in the init function, particularly lo0, pflog0, and
pfsync0. In the case of lo0 this was a panic implementation so it
does not count as a user visiable change. :-)
- Since most interfaces do not need the new functionality, an family of
wrapper functions, ifc_simple_*(), were created to wrap old style
cloner functions.
- The IF_CLONE_INITIALIZER macro is replaced with a new incompatible
IFC_CLONE_INITIALIZER and ifc_simple consumers use IFC_SIMPLE_DECLARE
instead.
Submitted by: Maurycy Pawlowski-Wieronski <maurycy at fouk.org> [1]
Reviewed by: andre, mlaier
Discussed on: net
2004-06-22 20:13:25 +00:00
|
|
|
IFC_SIMPLE_DECLARE(lo, 1);
|
2002-03-04 21:46:00 +00:00
|
|
|
|
2004-04-14 00:57:49 +00:00
|
|
|
static void
|
2008-04-07 01:43:30 +00:00
|
|
|
lo_clone_destroy(struct ifnet *ifp)
|
2002-03-04 21:46:00 +00:00
|
|
|
{
|
2008-11-26 22:32:07 +00:00
|
|
|
#ifdef INVARIANTS
|
|
|
|
INIT_VNET_NET(ifp->if_vnet);
|
|
|
|
#endif
|
2002-03-04 21:46:00 +00:00
|
|
|
|
2002-05-25 20:17:04 +00:00
|
|
|
/* XXX: destroying lo0 will lead to panics. */
|
Commit step 1 of the vimage project, (network stack)
virtualization work done by Marko Zec (zec@).
This is the first in a series of commits over the course
of the next few weeks.
Mark all uses of global variables to be virtualized
with a V_ prefix.
Use macros to map them back to their global names for
now, so this is a NOP change only.
We hope to have caught at least 85-90% of what is needed
so we do not invalidate a lot of outstanding patches again.
Obtained from: //depot/projects/vimage-commit2/...
Reviewed by: brooks, des, ed, mav, julian,
jamie, kris, rwatson, zec, ...
(various people I forgot, different versions)
md5 (with a bit of help)
Sponsored by: NLnet Foundation, The FreeBSD Foundation
X-MFC after: never
V_Commit_Message_Reviewed_By: more people than the patch
2008-08-17 23:27:27 +00:00
|
|
|
KASSERT(V_loif != ifp, ("%s: destroying lo0", __func__));
|
2002-03-04 21:46:00 +00:00
|
|
|
|
|
|
|
bpfdetach(ifp);
|
|
|
|
if_detach(ifp);
|
2005-06-10 16:49:24 +00:00
|
|
|
if_free(ifp);
|
2002-03-04 21:46:00 +00:00
|
|
|
}
|
|
|
|
|
2004-04-14 00:57:49 +00:00
|
|
|
static int
|
2008-04-07 01:43:30 +00:00
|
|
|
lo_clone_create(struct if_clone *ifc, int unit, caddr_t params)
|
2001-01-29 11:06:26 +00:00
|
|
|
{
|
Step 1.5 of importing the network stack virtualization infrastructure
from the vimage project, as per plan established at devsummit 08/08:
http://wiki.freebsd.org/Image/Notes200808DevSummit
Introduce INIT_VNET_*() initializer macros, VNET_FOREACH() iterator
macros, and CURVNET_SET() context setting macros, all currently
resolving to NOPs.
Prepare for virtualization of selected SYSCTL objects by introducing a
family of SYSCTL_V_*() macros, currently resolving to their global
counterparts, i.e. SYSCTL_V_INT() == SYSCTL_INT().
Move selected #defines from sys/sys/vimage.h to newly introduced header
files specific to virtualized subsystems (sys/net/vnet.h,
sys/netinet/vinet.h etc.).
All the changes are verified to have zero functional impact at this
point in time by doing MD5 comparision between pre- and post-change
object files(*).
(*) netipsec/keysock.c did not validate depending on compile time options.
Implemented by: julian, bz, brooks, zec
Reviewed by: julian, bz, brooks, kris, rwatson, ...
Approved by: julian (mentor)
Obtained from: //depot/projects/vimage-commit2/...
X-MFC after: never
Sponsored by: NLnet Foundation, The FreeBSD Foundation
2008-10-02 15:37:58 +00:00
|
|
|
INIT_VNET_NET(curvnet);
|
2005-06-10 16:49:24 +00:00
|
|
|
struct ifnet *ifp;
|
2001-01-29 11:06:26 +00:00
|
|
|
|
2008-06-29 13:17:01 +00:00
|
|
|
ifp = if_alloc(IFT_LOOP);
|
|
|
|
if (ifp == NULL)
|
2005-06-10 16:49:24 +00:00
|
|
|
return (ENOSPC);
|
|
|
|
|
|
|
|
if_initname(ifp, ifc->ifc_name, unit);
|
|
|
|
ifp->if_mtu = LOMTU;
|
|
|
|
ifp->if_flags = IFF_LOOPBACK | IFF_MULTICAST;
|
|
|
|
ifp->if_ioctl = loioctl;
|
|
|
|
ifp->if_output = looutput;
|
|
|
|
ifp->if_snd.ifq_maxlen = ifqmaxlen;
|
2009-03-16 09:22:34 +00:00
|
|
|
ifp->if_capabilities = ifp->if_capenable = IFCAP_HWCSUM;
|
2009-03-16 10:56:50 +00:00
|
|
|
ifp->if_hwassist = LO_CSUM_FEATURES;
|
2005-06-10 16:49:24 +00:00
|
|
|
if_attach(ifp);
|
2005-06-26 18:11:11 +00:00
|
|
|
bpfattach(ifp, DLT_NULL, sizeof(u_int32_t));
|
Commit step 1 of the vimage project, (network stack)
virtualization work done by Marko Zec (zec@).
This is the first in a series of commits over the course
of the next few weeks.
Mark all uses of global variables to be virtualized
with a V_ prefix.
Use macros to map them back to their global names for
now, so this is a NOP change only.
We hope to have caught at least 85-90% of what is needed
so we do not invalidate a lot of outstanding patches again.
Obtained from: //depot/projects/vimage-commit2/...
Reviewed by: brooks, des, ed, mav, julian,
jamie, kris, rwatson, zec, ...
(various people I forgot, different versions)
md5 (with a bit of help)
Sponsored by: NLnet Foundation, The FreeBSD Foundation
X-MFC after: never
V_Commit_Message_Reviewed_By: more people than the patch
2008-08-17 23:27:27 +00:00
|
|
|
if (V_loif == NULL)
|
|
|
|
V_loif = ifp;
|
2002-03-11 09:26:07 +00:00
|
|
|
|
|
|
|
return (0);
|
2001-01-29 11:06:26 +00:00
|
|
|
}
|
|
|
|
|
First pass at separating per-vnet initializer functions
from existing functions for initializing global state.
At this stage, the new per-vnet initializer functions are
directly called from the existing global initialization code,
which should in most cases result in compiler inlining those
new functions, hence yielding a near-zero functional change.
Modify the existing initializer functions which are invoked via
protosw, like ip_init() et. al., to allow them to be invoked
multiple times, i.e. per each vnet. Global state, if any,
is initialized only if such functions are called within the
context of vnet0, which will be determined via the
IS_DEFAULT_VNET(curvnet) check (currently always true).
While here, V_irtualize a few remaining global UMA zones
used by net/netinet/netipsec networking code. While it is
not yet clear to me or anybody else whether this is the right
thing to do, at this stage this makes the code more readable,
and makes it easier to track uncollected UMA-zone-backed
objects on vnet removal. In the long run, it's quite possible
that some form of shared use of UMA zone pools among multiple
vnets should be considered.
Bump __FreeBSD_version due to changes in layout of structs
vnet_ipfw, vnet_inet and vnet_net.
Approved by: julian (mentor)
2009-04-06 22:29:41 +00:00
|
|
|
static int vnet_loif_iattach(const void *unused __unused)
|
|
|
|
{
|
|
|
|
INIT_VNET_NET(curvnet);
|
|
|
|
|
|
|
|
V_loif = NULL;
|
|
|
|
if_clone_attach(&lo_cloner);
|
|
|
|
return (0);
|
|
|
|
}
|
|
|
|
|
2001-01-31 07:58:58 +00:00
|
|
|
static int
|
2008-05-09 20:38:25 +00:00
|
|
|
loop_modevent(module_t mod, int type, void *data)
|
|
|
|
{
|
2008-11-26 22:32:07 +00:00
|
|
|
INIT_VNET_NET(curvnet);
|
2008-04-07 01:43:30 +00:00
|
|
|
|
2008-05-09 20:38:25 +00:00
|
|
|
switch (type) {
|
|
|
|
case MOD_LOAD:
|
Introduce vnet module registration / initialization framework with
dependency tracking and ordering enforcement.
With this change, per-vnet initialization functions introduced with
r190787 are no longer directly called from traditional initialization
functions (which cc in most cases inlined to pre-r190787 code), but are
instead registered via the vnet framework first, and are invoked only
after all prerequisite modules have been initialized. In the long run,
this framework should allow us to both initialize and dismantle
multiple vnet instances in a correct order.
The problem this change aims to solve is how to replay the
initialization sequence of various network stack components, which
have been traditionally triggered via different mechanisms (SYSINIT,
protosw). Note that this initialization sequence was and still can be
subtly different depending on whether certain pieces of code have been
statically compiled into the kernel, loaded as modules by boot
loader, or kldloaded at run time.
The approach is simple - we record the initialization sequence
established by the traditional mechanisms whenever vnet_mod_register()
is called for a particular vnet module. The vnet_mod_register_multi()
variant allows a single initializer function to be registered multiple
times but with different arguments - currently this is only used in
kern/uipc_domain.c by net_add_domain() with different struct domain *
as arguments, which allows for protosw-registered initialization
routines to be invoked in a correct order by the new vnet
initialization framework.
For the purpose of identifying vnet modules, each vnet module has to
have a unique ID, which is statically assigned in sys/vimage.h.
Dynamic assignment of vnet module IDs is not supported yet.
A vnet module may specify a single prerequisite module at registration
time by filling in the vmi_dependson field of its vnet_modinfo struct
with the ID of the module it depends on. Unless specified otherwise,
all vnet modules depend on VNET_MOD_NET (container for ifnet list head,
rt_tables etc.), which thus has to and will always be initialized
first. The framework will panic if it detects any unresolved
dependencies before completing system initialization. Detection of
unresolved dependencies for vnet modules registered after boot
(kldloaded modules) is not provided.
Note that the fact that each module can specify only a single
prerequisite may become problematic in the long run. In particular,
INET6 depends on INET being already instantiated, due to TCP / UDP
structures residing in INET container. IPSEC also depends on INET,
which will in turn additionally complicate making INET6-only kernel
configs a reality.
The entire registration framework can be compiled out by turning on the
VIMAGE_GLOBALS kernel config option.
Reviewed by: bz
Approved by: julian (mentor)
2009-04-11 05:58:58 +00:00
|
|
|
#ifndef VIMAGE_GLOBALS
|
|
|
|
vnet_mod_register(&vnet_loif_modinfo);
|
|
|
|
#else
|
First pass at separating per-vnet initializer functions
from existing functions for initializing global state.
At this stage, the new per-vnet initializer functions are
directly called from the existing global initialization code,
which should in most cases result in compiler inlining those
new functions, hence yielding a near-zero functional change.
Modify the existing initializer functions which are invoked via
protosw, like ip_init() et. al., to allow them to be invoked
multiple times, i.e. per each vnet. Global state, if any,
is initialized only if such functions are called within the
context of vnet0, which will be determined via the
IS_DEFAULT_VNET(curvnet) check (currently always true).
While here, V_irtualize a few remaining global UMA zones
used by net/netinet/netipsec networking code. While it is
not yet clear to me or anybody else whether this is the right
thing to do, at this stage this makes the code more readable,
and makes it easier to track uncollected UMA-zone-backed
objects on vnet removal. In the long run, it's quite possible
that some form of shared use of UMA zone pools among multiple
vnets should be considered.
Bump __FreeBSD_version due to changes in layout of structs
vnet_ipfw, vnet_inet and vnet_net.
Approved by: julian (mentor)
2009-04-06 22:29:41 +00:00
|
|
|
vnet_loif_iattach(NULL);
|
Introduce vnet module registration / initialization framework with
dependency tracking and ordering enforcement.
With this change, per-vnet initialization functions introduced with
r190787 are no longer directly called from traditional initialization
functions (which cc in most cases inlined to pre-r190787 code), but are
instead registered via the vnet framework first, and are invoked only
after all prerequisite modules have been initialized. In the long run,
this framework should allow us to both initialize and dismantle
multiple vnet instances in a correct order.
The problem this change aims to solve is how to replay the
initialization sequence of various network stack components, which
have been traditionally triggered via different mechanisms (SYSINIT,
protosw). Note that this initialization sequence was and still can be
subtly different depending on whether certain pieces of code have been
statically compiled into the kernel, loaded as modules by boot
loader, or kldloaded at run time.
The approach is simple - we record the initialization sequence
established by the traditional mechanisms whenever vnet_mod_register()
is called for a particular vnet module. The vnet_mod_register_multi()
variant allows a single initializer function to be registered multiple
times but with different arguments - currently this is only used in
kern/uipc_domain.c by net_add_domain() with different struct domain *
as arguments, which allows for protosw-registered initialization
routines to be invoked in a correct order by the new vnet
initialization framework.
For the purpose of identifying vnet modules, each vnet module has to
have a unique ID, which is statically assigned in sys/vimage.h.
Dynamic assignment of vnet module IDs is not supported yet.
A vnet module may specify a single prerequisite module at registration
time by filling in the vmi_dependson field of its vnet_modinfo struct
with the ID of the module it depends on. Unless specified otherwise,
all vnet modules depend on VNET_MOD_NET (container for ifnet list head,
rt_tables etc.), which thus has to and will always be initialized
first. The framework will panic if it detects any unresolved
dependencies before completing system initialization. Detection of
unresolved dependencies for vnet modules registered after boot
(kldloaded modules) is not provided.
Note that the fact that each module can specify only a single
prerequisite may become problematic in the long run. In particular,
INET6 depends on INET being already instantiated, due to TCP / UDP
structures residing in INET container. IPSEC also depends on INET,
which will in turn additionally complicate making INET6-only kernel
configs a reality.
The entire registration framework can be compiled out by turning on the
VIMAGE_GLOBALS kernel config option.
Reviewed by: bz
Approved by: julian (mentor)
2009-04-11 05:58:58 +00:00
|
|
|
#endif
|
2008-05-09 20:38:25 +00:00
|
|
|
break;
|
2008-04-07 01:43:30 +00:00
|
|
|
|
2008-05-09 20:38:25 +00:00
|
|
|
case MOD_UNLOAD:
|
|
|
|
printf("loop module unload - not possible for this module type\n");
|
2008-04-07 01:43:30 +00:00
|
|
|
return (EINVAL);
|
|
|
|
|
2004-07-15 08:26:07 +00:00
|
|
|
default:
|
2008-04-07 01:43:30 +00:00
|
|
|
return (EOPNOTSUPP);
|
2008-05-09 20:38:25 +00:00
|
|
|
}
|
2008-04-07 01:43:30 +00:00
|
|
|
return (0);
|
2008-05-09 20:38:25 +00:00
|
|
|
}
|
2001-01-31 07:58:58 +00:00
|
|
|
|
2008-05-09 20:38:25 +00:00
|
|
|
static moduledata_t loop_mod = {
|
|
|
|
"loop",
|
|
|
|
loop_modevent,
|
2001-01-31 07:58:58 +00:00
|
|
|
0
|
2008-05-09 20:38:25 +00:00
|
|
|
};
|
2001-01-31 07:58:58 +00:00
|
|
|
|
2003-10-27 04:16:32 +00:00
|
|
|
DECLARE_MODULE(loop, loop_mod, SI_SUB_PROTO_IFATTACHDOMAIN, SI_ORDER_ANY);
|
1994-05-24 10:09:53 +00:00
|
|
|
|
1999-12-07 17:39:16 +00:00
|
|
|
int
|
2008-04-07 01:43:30 +00:00
|
|
|
looutput(struct ifnet *ifp, struct mbuf *m, struct sockaddr *dst,
|
|
|
|
struct rtentry *rt)
|
1998-06-12 03:48:19 +00:00
|
|
|
{
|
2005-06-26 18:11:11 +00:00
|
|
|
u_int32_t af;
|
2009-01-10 23:50:23 +00:00
|
|
|
#ifdef MAC
|
|
|
|
int error;
|
|
|
|
#endif
|
2005-06-26 18:11:11 +00:00
|
|
|
|
2003-04-08 14:25:47 +00:00
|
|
|
M_ASSERTPKTHDR(m); /* check if we have the packet header */
|
1998-06-12 03:48:19 +00:00
|
|
|
|
2009-01-10 23:50:23 +00:00
|
|
|
#ifdef MAC
|
|
|
|
error = mac_ifnet_check_transmit(ifp, m);
|
|
|
|
if (error) {
|
|
|
|
m_freem(m);
|
|
|
|
return (error);
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
1998-06-12 03:48:19 +00:00
|
|
|
if (rt && rt->rt_flags & (RTF_REJECT|RTF_BLACKHOLE)) {
|
|
|
|
m_freem(m);
|
|
|
|
return (rt->rt_flags & RTF_BLACKHOLE ? 0 :
|
|
|
|
rt->rt_flags & RTF_HOST ? EHOSTUNREACH : ENETUNREACH);
|
|
|
|
}
|
1999-11-22 02:45:11 +00:00
|
|
|
|
1998-06-12 03:48:19 +00:00
|
|
|
ifp->if_opackets++;
|
|
|
|
ifp->if_obytes += m->m_pkthdr.len;
|
2005-06-26 18:11:11 +00:00
|
|
|
|
|
|
|
/* BPF writes need to be handled specially. */
|
|
|
|
if (dst->sa_family == AF_UNSPEC) {
|
|
|
|
bcopy(dst->sa_data, &af, sizeof(af));
|
|
|
|
dst->sa_family = af;
|
|
|
|
}
|
|
|
|
|
1998-06-14 20:58:17 +00:00
|
|
|
#if 1 /* XXX */
|
|
|
|
switch (dst->sa_family) {
|
|
|
|
case AF_INET:
|
2009-03-15 20:17:44 +00:00
|
|
|
if (ifp->if_capenable & IFCAP_RXCSUM) {
|
|
|
|
m->m_pkthdr.csum_data = 0xffff;
|
2009-03-16 10:56:50 +00:00
|
|
|
m->m_pkthdr.csum_flags = LO_CSUM_SET;
|
2009-03-15 20:17:44 +00:00
|
|
|
}
|
2009-03-16 10:56:50 +00:00
|
|
|
m->m_pkthdr.csum_flags &= ~LO_CSUM_FEATURES;
|
1999-11-22 02:45:11 +00:00
|
|
|
case AF_INET6:
|
1998-06-14 20:58:17 +00:00
|
|
|
case AF_IPX:
|
|
|
|
case AF_APPLETALK:
|
1998-06-14 23:53:43 +00:00
|
|
|
break;
|
1998-06-14 20:58:17 +00:00
|
|
|
default:
|
2000-09-04 21:46:27 +00:00
|
|
|
printf("looutput: af=%d unexpected\n", dst->sa_family);
|
1998-06-14 20:58:17 +00:00
|
|
|
m_freem(m);
|
|
|
|
return (EAFNOSUPPORT);
|
|
|
|
}
|
|
|
|
#endif
|
2008-04-07 01:43:30 +00:00
|
|
|
return (if_simloop(ifp, m, dst->sa_family, 0));
|
1998-06-12 03:48:19 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* if_simloop()
|
|
|
|
*
|
|
|
|
* This function is to support software emulation of hardware loopback,
|
|
|
|
* i.e., for interfaces with the IFF_SIMPLEX attribute. Since they can't
|
|
|
|
* hear their own broadcasts, we create a copy of the packet that we
|
|
|
|
* would normally receive via a hardware loopback.
|
|
|
|
*
|
|
|
|
* This function expects the packet to include the media header of length hlen.
|
|
|
|
*/
|
|
|
|
int
|
2008-04-07 01:43:30 +00:00
|
|
|
if_simloop(struct ifnet *ifp, struct mbuf *m, int af, int hlen)
|
1994-05-24 10:09:53 +00:00
|
|
|
{
|
Step 1.5 of importing the network stack virtualization infrastructure
from the vimage project, as per plan established at devsummit 08/08:
http://wiki.freebsd.org/Image/Notes200808DevSummit
Introduce INIT_VNET_*() initializer macros, VNET_FOREACH() iterator
macros, and CURVNET_SET() context setting macros, all currently
resolving to NOPs.
Prepare for virtualization of selected SYSCTL objects by introducing a
family of SYSCTL_V_*() macros, currently resolving to their global
counterparts, i.e. SYSCTL_V_INT() == SYSCTL_INT().
Move selected #defines from sys/sys/vimage.h to newly introduced header
files specific to virtualized subsystems (sys/net/vnet.h,
sys/netinet/vinet.h etc.).
All the changes are verified to have zero functional impact at this
point in time by doing MD5 comparision between pre- and post-change
object files(*).
(*) netipsec/keysock.c did not validate depending on compile time options.
Implemented by: julian, bz, brooks, zec
Reviewed by: julian, bz, brooks, kris, rwatson, ...
Approved by: julian (mentor)
Obtained from: //depot/projects/vimage-commit2/...
X-MFC after: never
Sponsored by: NLnet Foundation, The FreeBSD Foundation
2008-10-02 15:37:58 +00:00
|
|
|
INIT_VNET_NET(ifp->if_vnet);
|
Lock down the network interface queues. The queue mutex must be obtained
before adding/removing packets from the queue. Also, the if_obytes and
if_omcasts fields should only be manipulated under protection of the mutex.
IF_ENQUEUE, IF_PREPEND, and IF_DEQUEUE perform all necessary locking on
the queue. An IF_LOCK macro is provided, as well as the old (mutex-less)
versions of the macros in the form _IF_ENQUEUE, _IF_QFULL, for code which
needs them, but their use is discouraged.
Two new macros are introduced: IF_DRAIN() to drain a queue, and IF_HANDOFF,
which takes care of locking/enqueue, and also statistics updating/start
if necessary.
2000-11-25 07:35:38 +00:00
|
|
|
int isr;
|
1994-05-24 10:09:53 +00:00
|
|
|
|
2003-04-08 14:25:47 +00:00
|
|
|
M_ASSERTPKTHDR(m);
|
2003-10-29 05:40:07 +00:00
|
|
|
m_tag_delete_nonpersistent(m);
|
1998-06-12 03:48:19 +00:00
|
|
|
m->m_pkthdr.rcvif = ifp;
|
2000-05-24 21:16:56 +00:00
|
|
|
|
2009-01-10 23:50:23 +00:00
|
|
|
#ifdef MAC
|
|
|
|
mac_ifnet_create_mbuf(ifp, m);
|
|
|
|
#endif
|
|
|
|
|
2006-09-22 01:31:22 +00:00
|
|
|
/*
|
|
|
|
* Let BPF see incoming packet in the following manner:
|
2008-05-09 20:38:25 +00:00
|
|
|
* - Emulated packet loopback for a simplex interface
|
2006-09-22 01:31:22 +00:00
|
|
|
* (net/if_ethersubr.c)
|
|
|
|
* -> passes it to ifp's BPF
|
|
|
|
* - IPv4/v6 multicast packet loopback (netinet(6)/ip(6)_output.c)
|
|
|
|
* -> not passes it to any BPF
|
|
|
|
* - Normal packet loopback from myself to myself (net/if_loop.c)
|
|
|
|
* -> passes to lo0's BPF (even in case of IPv6, where ifp!=lo0)
|
|
|
|
*/
|
|
|
|
if (hlen > 0) {
|
|
|
|
if (bpf_peers_present(ifp->if_bpf)) {
|
2003-12-28 03:56:00 +00:00
|
|
|
bpf_mtap(ifp->if_bpf, m);
|
2006-09-22 01:31:22 +00:00
|
|
|
}
|
|
|
|
} else {
|
Commit step 1 of the vimage project, (network stack)
virtualization work done by Marko Zec (zec@).
This is the first in a series of commits over the course
of the next few weeks.
Mark all uses of global variables to be virtualized
with a V_ prefix.
Use macros to map them back to their global names for
now, so this is a NOP change only.
We hope to have caught at least 85-90% of what is needed
so we do not invalidate a lot of outstanding patches again.
Obtained from: //depot/projects/vimage-commit2/...
Reviewed by: brooks, des, ed, mav, julian,
jamie, kris, rwatson, zec, ...
(various people I forgot, different versions)
md5 (with a bit of help)
Sponsored by: NLnet Foundation, The FreeBSD Foundation
X-MFC after: never
V_Commit_Message_Reviewed_By: more people than the patch
2008-08-17 23:27:27 +00:00
|
|
|
if (bpf_peers_present(V_loif->if_bpf)) {
|
|
|
|
if ((m->m_flags & M_MCAST) == 0 || V_loif == ifp) {
|
2006-09-22 01:31:22 +00:00
|
|
|
/* XXX beware sizeof(af) != 4 */
|
2008-08-01 09:41:45 +00:00
|
|
|
u_int32_t af1 = af;
|
2006-09-22 01:31:22 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* We need to prepend the address family.
|
|
|
|
*/
|
Commit step 1 of the vimage project, (network stack)
virtualization work done by Marko Zec (zec@).
This is the first in a series of commits over the course
of the next few weeks.
Mark all uses of global variables to be virtualized
with a V_ prefix.
Use macros to map them back to their global names for
now, so this is a NOP change only.
We hope to have caught at least 85-90% of what is needed
so we do not invalidate a lot of outstanding patches again.
Obtained from: //depot/projects/vimage-commit2/...
Reviewed by: brooks, des, ed, mav, julian,
jamie, kris, rwatson, zec, ...
(various people I forgot, different versions)
md5 (with a bit of help)
Sponsored by: NLnet Foundation, The FreeBSD Foundation
X-MFC after: never
V_Commit_Message_Reviewed_By: more people than the patch
2008-08-17 23:27:27 +00:00
|
|
|
bpf_mtap2(V_loif->if_bpf, &af1, sizeof(af1), m);
|
2006-09-22 01:31:22 +00:00
|
|
|
}
|
|
|
|
}
|
1994-05-24 10:09:53 +00:00
|
|
|
}
|
|
|
|
|
1998-06-12 03:48:19 +00:00
|
|
|
/* Strip away media header */
|
1998-07-12 16:46:52 +00:00
|
|
|
if (hlen > 0) {
|
2000-05-26 13:47:02 +00:00
|
|
|
m_adj(m, hlen);
|
2007-02-09 00:09:35 +00:00
|
|
|
#ifndef __NO_STRICT_ALIGNMENT
|
2006-05-12 05:04:46 +00:00
|
|
|
/*
|
|
|
|
* Some archs do not like unaligned data, so
|
|
|
|
* we move data down in the first mbuf.
|
|
|
|
*/
|
2000-05-26 13:47:02 +00:00
|
|
|
if (mtod(m, vm_offset_t) & 3) {
|
2000-06-02 19:06:33 +00:00
|
|
|
KASSERT(hlen >= 3, ("if_simloop: hlen too small"));
|
2008-05-09 20:38:25 +00:00
|
|
|
bcopy(m->m_data,
|
|
|
|
(char *)(mtod(m, vm_offset_t)
|
2000-05-26 13:47:02 +00:00
|
|
|
- (mtod(m, vm_offset_t) & 3)),
|
|
|
|
m->m_len);
|
2004-07-28 06:59:55 +00:00
|
|
|
m->m_data -= (mtod(m,vm_offset_t) & 3);
|
2000-05-26 13:47:02 +00:00
|
|
|
}
|
1998-07-12 16:46:52 +00:00
|
|
|
#endif
|
|
|
|
}
|
1994-05-24 10:09:53 +00:00
|
|
|
|
2000-05-24 21:16:56 +00:00
|
|
|
/* Deliver to upper layer protocol */
|
|
|
|
switch (af) {
|
1994-05-24 10:09:53 +00:00
|
|
|
#ifdef INET
|
|
|
|
case AF_INET:
|
|
|
|
isr = NETISR_IP;
|
|
|
|
break;
|
|
|
|
#endif
|
1999-11-22 02:45:11 +00:00
|
|
|
#ifdef INET6
|
|
|
|
case AF_INET6:
|
|
|
|
m->m_flags |= M_LOOP;
|
|
|
|
isr = NETISR_IPV6;
|
|
|
|
break;
|
|
|
|
#endif
|
1995-10-26 20:31:59 +00:00
|
|
|
#ifdef IPX
|
|
|
|
case AF_IPX:
|
|
|
|
isr = NETISR_IPX;
|
|
|
|
break;
|
|
|
|
#endif
|
1996-05-24 01:35:45 +00:00
|
|
|
#ifdef NETATALK
|
|
|
|
case AF_APPLETALK:
|
2003-03-04 23:19:55 +00:00
|
|
|
isr = NETISR_ATALK2;
|
1996-05-24 01:35:45 +00:00
|
|
|
break;
|
2001-09-10 01:33:03 +00:00
|
|
|
#endif
|
1994-05-24 10:09:53 +00:00
|
|
|
default:
|
2000-05-24 21:16:56 +00:00
|
|
|
printf("if_simloop: can't handle af=%d\n", af);
|
1994-05-24 10:09:53 +00:00
|
|
|
m_freem(m);
|
|
|
|
return (EAFNOSUPPORT);
|
|
|
|
}
|
|
|
|
ifp->if_ipackets++;
|
|
|
|
ifp->if_ibytes += m->m_pkthdr.len;
|
2004-08-27 18:33:08 +00:00
|
|
|
netisr_queue(isr, m); /* mbuf is free'd on failure. */
|
1994-05-24 10:09:53 +00:00
|
|
|
return (0);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* ARGSUSED */
|
1995-12-09 20:47:15 +00:00
|
|
|
static void
|
2008-04-07 01:43:30 +00:00
|
|
|
lortrequest(int cmd, struct rtentry *rt, struct rt_addrinfo *info)
|
1994-05-24 10:09:53 +00:00
|
|
|
{
|
2008-04-07 01:43:30 +00:00
|
|
|
|
2003-10-04 03:44:50 +00:00
|
|
|
RT_LOCK_ASSERT(rt);
|
2005-02-24 01:34:01 +00:00
|
|
|
rt->rt_rmx.rmx_mtu = rt->rt_ifp->if_mtu;
|
1994-05-24 10:09:53 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Process an ioctl request.
|
|
|
|
*/
|
|
|
|
/* ARGSUSED */
|
1999-12-07 17:39:16 +00:00
|
|
|
int
|
2008-04-07 01:43:30 +00:00
|
|
|
loioctl(struct ifnet *ifp, u_long cmd, caddr_t data)
|
1994-05-24 10:09:53 +00:00
|
|
|
{
|
2008-04-07 01:43:30 +00:00
|
|
|
struct ifaddr *ifa;
|
|
|
|
struct ifreq *ifr = (struct ifreq *)data;
|
2009-03-15 20:17:44 +00:00
|
|
|
int error = 0, mask;
|
1994-05-24 10:09:53 +00:00
|
|
|
|
|
|
|
switch (cmd) {
|
|
|
|
case SIOCSIFADDR:
|
2005-08-09 10:20:02 +00:00
|
|
|
ifp->if_flags |= IFF_UP;
|
|
|
|
ifp->if_drv_flags |= IFF_DRV_RUNNING;
|
1994-05-24 10:09:53 +00:00
|
|
|
ifa = (struct ifaddr *)data;
|
1996-02-05 19:34:27 +00:00
|
|
|
ifa->ifa_rtrequest = lortrequest;
|
1994-05-24 10:09:53 +00:00
|
|
|
/*
|
|
|
|
* Everything else is done at a higher level.
|
|
|
|
*/
|
|
|
|
break;
|
|
|
|
|
|
|
|
case SIOCADDMULTI:
|
|
|
|
case SIOCDELMULTI:
|
|
|
|
if (ifr == 0) {
|
|
|
|
error = EAFNOSUPPORT; /* XXX */
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
switch (ifr->ifr_addr.sa_family) {
|
|
|
|
|
|
|
|
#ifdef INET
|
|
|
|
case AF_INET:
|
|
|
|
break;
|
|
|
|
#endif
|
1999-11-22 02:45:11 +00:00
|
|
|
#ifdef INET6
|
|
|
|
case AF_INET6:
|
|
|
|
break;
|
|
|
|
#endif
|
1994-05-24 10:09:53 +00:00
|
|
|
|
|
|
|
default:
|
|
|
|
error = EAFNOSUPPORT;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
1994-08-08 12:09:04 +00:00
|
|
|
case SIOCSIFMTU:
|
1999-08-06 16:46:29 +00:00
|
|
|
ifp->if_mtu = ifr->ifr_mtu;
|
1994-08-08 12:09:04 +00:00
|
|
|
break;
|
|
|
|
|
1998-04-30 19:37:00 +00:00
|
|
|
case SIOCSIFFLAGS:
|
|
|
|
break;
|
|
|
|
|
2009-03-15 20:17:44 +00:00
|
|
|
case SIOCSIFCAP:
|
|
|
|
mask = ifp->if_capenable ^ ifr->ifr_reqcap;
|
|
|
|
if ((mask & IFCAP_RXCSUM) != 0)
|
|
|
|
ifp->if_capenable ^= IFCAP_RXCSUM;
|
|
|
|
if ((mask & IFCAP_TXCSUM) != 0)
|
|
|
|
ifp->if_capenable ^= IFCAP_TXCSUM;
|
|
|
|
if (ifp->if_capenable & IFCAP_TXCSUM)
|
2009-03-16 10:56:50 +00:00
|
|
|
ifp->if_hwassist = LO_CSUM_FEATURES;
|
2009-03-15 20:17:44 +00:00
|
|
|
else
|
|
|
|
ifp->if_hwassist = 0;
|
|
|
|
break;
|
|
|
|
|
1994-05-24 10:09:53 +00:00
|
|
|
default:
|
|
|
|
error = EINVAL;
|
|
|
|
}
|
|
|
|
return (error);
|
|
|
|
}
|