82 lines
2.1 KiB
ReStructuredText
82 lines
2.1 KiB
ReStructuredText
|
networking
|
||
|
==========
|
||
|
|
||
|
barebox has IPv4 networking support. Several protocols such as
|
||
|
:ref:`command_dhcp`, :ref:`filesystems_nfs`, :ref:`command_tftp` are
|
||
|
supported.
|
||
|
|
||
|
Network configuration
|
||
|
---------------------
|
||
|
|
||
|
The first step for networking is configuring the network device. The network
|
||
|
device is usually ``eth0``. The current configuration can be viewed with the
|
||
|
:ref:`command_devinfo` command:
|
||
|
|
||
|
.. code-block:: sh
|
||
|
|
||
|
barebox@Genesi Efika MX Smartbook:/ devinfo eth0
|
||
|
Parameters:
|
||
|
ipaddr: 192.168.23.197
|
||
|
serverip: 192.168.23.1
|
||
|
gateway: 192.168.23.1
|
||
|
netmask: 255.255.0.0
|
||
|
ethaddr: 00:1c:49:01:03:4b
|
||
|
|
||
|
The configuration can be changed on the command line with:
|
||
|
|
||
|
.. code-block:: sh
|
||
|
|
||
|
eth0.ipaddr=172.0.0.10
|
||
|
|
||
|
The :ref:`command_dhcp` command will change the settings based on the answer
|
||
|
from the DHCP server.
|
||
|
|
||
|
This low level configuration of the network interface is often not necessary. Normally
|
||
|
the network settings should be edited in ``/env/network/eth0``, then the network interface
|
||
|
can be brought up using the :ref:`command_ifup` command.
|
||
|
|
||
|
Network filesystems
|
||
|
-------------------
|
||
|
|
||
|
barebox supports NFS and TFTP as filesystem implementations. See :ref:`filesystems_nfs`
|
||
|
and :ref:`filesystems_tftp` for more information. After the network device has been
|
||
|
brought up a network filesystem can be mounted with:
|
||
|
|
||
|
.. code-block:: sh
|
||
|
|
||
|
mount -t tftp 192.168.2.1 /mnt
|
||
|
|
||
|
or
|
||
|
|
||
|
.. code-block:: sh
|
||
|
|
||
|
mount -t nfs 192.168.2.1:/export none /mnt
|
||
|
|
||
|
**NOTE** This can often be hidden behind the :ref:`command_automount` command to make
|
||
|
mounting transparent to the user.
|
||
|
|
||
|
Network console
|
||
|
---------------
|
||
|
|
||
|
barebox has a udp based network console. If enabled in the config, you will see
|
||
|
something like this during startup:
|
||
|
|
||
|
registered netconsole as cs1
|
||
|
|
||
|
By default the network console is disabled during runtime to prevent security
|
||
|
risks. It can be enabled using:
|
||
|
|
||
|
.. code-block:: sh
|
||
|
|
||
|
cs1.ip=192.168.23.2
|
||
|
cs1.active=ioe
|
||
|
|
||
|
This will send udp packets to 192.168.23.2 on port 6666. On 192.168.23.2 the
|
||
|
scripts/netconsole script can be used to control barebox:
|
||
|
|
||
|
.. code-block:: sh
|
||
|
|
||
|
scripts/netconsole <board IP> 6666
|
||
|
|
||
|
The netconsole can be used just like any other console.
|