[PATCH] Documentation: sandbox.rst: added dhcp network configuration

[PATCH] Documentation: sandbox.rst: added dhcp network configuration

[Neeraj Pal]

Hello Ahmad,

I have added the DHCP network configuration as discussed
(http://lists.infradead.org/pipermail/barebox/2021-April/035795.html)
Please confirm and let me know if needs any modifications.

Thanks,
Neeraj

diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst
index e9e518365..7016312e9 100644
--- a/Documentation/boards/sandbox.rst
+++ b/Documentation/boards/sandbox.rst
@@ -74,3 +74,79 @@ Available sandbox invocation options include:

 To terminate barebox and return to the calling shell, the poweroff command is
 suitable.
+
+Network configuration for Sandbox
+-------------------------------------------------
+
+After running the sanbox, the following steps are required to configure network
+through dhcp.
+Following configuration tested on Ubuntu 20.04 focal LTS
+
+* On host
+
+  * virbr0: virtual bridge interface created by Qemu (easy method)
+
+  * if Qemu virtual bridge (virbr0) is not available then manually
create and configure one bridge like "br0"
+
+    .. code-block:: console
+
+        $ ip link show
+        1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state
UNKNOWN mode DEFAULT group default qlen 1000
+            link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
+        2: enp0s31f6: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500
qdisc fq state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+        3: wlp4s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc
noqueue state UP mode DORMANT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+        4: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc
noqueue state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+        5: virbr0-nic: <BROADCAST,MULTICAST> mtu 1500 qdisc fq master
virbr0 state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+        6: barebox: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state
DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+
+    .. code-block:: console
+
+        $ sudo apt install bridge-utils
+        $ sudo ifconfig barebox up
+        $ sudo brctl addif virbr0 barebox
+        $ sudo ip link set barebox master virbr0
+        $ sudo dhclient -v virbr0
+
+* On Sandbox
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ devinfo eth0
+        Parent: tap0
+        Parameters:
+          ethaddr: 00:00:00:00:00:00 (type: MAC)
+          gateway: 0.0.0.0 (type: ipv4)
+          ipaddr: 0.0.0.0 (type: ipv4)
+          linux.bootargs:  (type: string)
+          linux.devname:  (type: string)
+          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
+          netmask: 0.0.0.0 (type: ipv4)
+          serverip:  (type: string)
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ dhcp eth0
+        WARNING: eth0: No MAC address set. Using random address
c2:2c:a1:17:b8:47
+        T eth0: DHCP client bound to address 192.168.122.21
+        barebox@Sandbox:/ ping google.com
+        PING google.com (172.217.167.46)
+        host google.com is alive
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ devinfo eth0
+        Parent: tap0
+        Parameters:
+          ethaddr: c2:2c:a1:17:b8:47 (type: MAC)
+          gateway: 192.168.122.1 (type: ipv4)
+          ipaddr: 192.168.122.21 (type: ipv4)
+          linux.bootargs:  (type: string)
+          linux.devname:  (type: string)
+          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
+          netmask: 255.255.255.0 (type: ipv4)
+          serverip: 192.168.122.1 (type: string)

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

Re: [PATCH] Documentation: sandbox.rst: added dhcp network configuration

[Ahmad Fatoum]

Hello Neeraj,

On 20.04.21 20:17, Neeraj Pal wrote:
> Hello Ahmad,
> 
> I have added the DHCP network configuration as discussed
> (http://lists.infradead.org/pipermail/barebox/2021-April/035795.html)
> Please confirm and let me know if needs any modifications.
> 
> Thanks,
> Neeraj

Thanks.
Please send this as Git patch, i.e. with a commit message. This is most
easily done, by using git send-email. Write something in the commit message
that explains the change, e.g.:

  Network configuration on sandbox requires some extra steps on the host
  OS. Document these.

And don't forget your Signed-off-by. You should also mark the patch as v2
(pass -v2 to git send-email if you use that).

Some more comments inline.

> 
> diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst
> index e9e518365..7016312e9 100644
> --- a/Documentation/boards/sandbox.rst
> +++ b/Documentation/boards/sandbox.rst
> @@ -74,3 +74,79 @@ Available sandbox invocation options include:
> 
>  To terminate barebox and return to the calling shell, the poweroff command is
>  suitable.
> +
> +Network configuration for Sandbox
> +-------------------------------------------------

I am not sure Sphinx likes it when the line is longer than the
text. Please adjust and while at it you could drop the "for Sandbox"
part. The whole file (and resulting page) is about sandbox.

> +
> +After running the sanbox, the following steps are required to configure network

s/sanbox/sandbox/. Do you do do these steps while sandbox is running?
If so, it might be better written as While sandbox is running, ... etc.

> +through dhcp.
> +Following configuration tested on Ubuntu 20.04 focal LTS

I think you can safely omit this line, but it doesn't hurt.

> +
> +* On host
> +
> +  * virbr0: virtual bridge interface created by Qemu (easy method)
> +
> +  * if Qemu virtual bridge (virbr0) is not available then manually
> create and configure one bridge like "br0"
> +
> +    .. code-block:: console
> +
> +        $ ip link show
> +        1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state
> UNKNOWN mode DEFAULT group default qlen 1000
> +            link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
> +        2: enp0s31f6: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500
> qdisc fq state DOWN mode DEFAULT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> +        3: wlp4s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc
> noqueue state UP mode DORMANT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> +        4: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc
> noqueue state DOWN mode DEFAULT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff

You could delete the interfaces that are irrelevant, but that's just a nitpick.

> +        5: virbr0-nic: <BROADCAST,MULTICAST> mtu 1500 qdisc fq master
> virbr0 state DOWN mode DEFAULT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> +        6: barebox: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state
> DOWN mode DEFAULT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> +
> +    .. code-block:: console
> +
> +        $ sudo apt install bridge-utils
> +        $ sudo ifconfig barebox up
> +        $ sudo brctl addif virbr0 barebox
> +        $ sudo ip link set barebox master virbr0
> +        $ sudo dhclient -v virbr0
> +
> +* On Sandbox
> +
> +    .. code-block:: console
> +
> +        barebox@Sandbox:/ devinfo eth0
> +        Parent: tap0
> +        Parameters:
> +          ethaddr: 00:00:00:00:00:00 (type: MAC)
> +          gateway: 0.0.0.0 (type: ipv4)
> +          ipaddr: 0.0.0.0 (type: ipv4)
> +          linux.bootargs:  (type: string)
> +          linux.devname:  (type: string)
> +          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
> +          netmask: 0.0.0.0 (type: ipv4)
> +          serverip:  (type: string)
> +
> +    .. code-block:: console
> +
> +        barebox@Sandbox:/ dhcp eth0
> +        WARNING: eth0: No MAC address set. Using random address
> c2:2c:a1:17:b8:47
> +        T eth0: DHCP client bound to address 192.168.122.21
> +        barebox@Sandbox:/ ping google.com
> +        PING google.com (172.217.167.46)
> +        host google.com is alive
> +
> +    .. code-block:: console
> +
> +        barebox@Sandbox:/ devinfo eth0
> +        Parent: tap0
> +        Parameters:
> +          ethaddr: c2:2c:a1:17:b8:47 (type: MAC)
> +          gateway: 192.168.122.1 (type: ipv4)
> +          ipaddr: 192.168.122.21 (type: ipv4)
> +          linux.bootargs:  (type: string)
> +          linux.devname:  (type: string)
> +          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
> +          netmask: 255.255.255.0 (type: ipv4)
> +          serverip: 192.168.122.1 (type: string)

The rest looks fine.

Cheers,
Ahmad

-- 
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
31137 Hildesheim, Germany                  | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

Re: [PATCH] Documentation: sandbox.rst: added dhcp network configuration

[Neeraj Pal]

Hello Ahmad,

On Wed, Apr 21, 2021 at 5:02 PM Ahmad Fatoum <a.fatoum@pengutronix.de> wrote:
> Please send this as Git patch, i.e. with a commit message. This is most
> easily done, by using git send-email. Write something in the commit message
> that explains the change, e.g.:
>
>   Network configuration on sandbox requires some extra steps on the host
>   OS. Document these.
>
> And don't forget your Signed-off-by. You should also mark the patch as v2
> (pass -v2 to git send-email if you use that).

Thank you for sharing the information. I didn't use git send-email
before but good to know about it.

>
> I am not sure Sphinx likes it when the line is longer than the
> text. Please adjust and while at it you could drop the "for Sandbox"
> part. The whole file (and resulting page) is about sandbox.
>
> s/sanbox/sandbox/. Do you do do these steps while sandbox is running?
> If so, it might be better written as While sandbox is running, ... etc.
>
> > +through dhcp.
> > +Following configuration tested on Ubuntu 20.04 focal LTS
>
> I think you can safely omit this line, but it doesn't hurt.
>
> The rest looks fine.
>
> Cheers,
> Ahmad

I have made the necessary changes as per your suggestions. Sending a
complete patch through git send-email.

Thanks and regards,
Neeraj

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

[PATCH v2] Documentation: some extra steps requires for DHCP network configuration for sandbox on the host OS

[Neeraj Pal]

Signed-off-by: Neeraj Pal <neerajpal09@gmail.com>
---
 Documentation/boards/sandbox.rst | 66 ++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst
index e9e518365..925dfc808 100644
--- a/Documentation/boards/sandbox.rst
+++ b/Documentation/boards/sandbox.rst
@@ -74,3 +74,69 @@ Available sandbox invocation options include:
 
 To terminate barebox and return to the calling shell, the poweroff command is
 suitable.
+
+Network configuration
+---------------------
+
+While running the sandbox, the following steps are required
+
+* On host
+
+  * virbr0: virtual bridge interface created by Qemu (easy method)
+
+  * if Qemu virtual bridge (virbr0) is not available then manually create and configure one bridge like "br0"
+
+    .. code-block:: console
+
+        $ ip link show
+        4: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+        6: barebox: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+
+    .. code-block:: console
+
+        $ sudo apt install bridge-utils
+        $ sudo ifconfig barebox up
+        $ sudo brctl addif virbr0 barebox
+        $ sudo ip link set barebox master virbr0
+        $ sudo dhclient -v virbr0
+
+* On Sandbox
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ devinfo eth0
+        Parent: tap0
+        Parameters:
+          ethaddr: 00:00:00:00:00:00 (type: MAC)
+          gateway: 0.0.0.0 (type: ipv4)
+          ipaddr: 0.0.0.0 (type: ipv4)
+          linux.bootargs:  (type: string)
+          linux.devname:  (type: string)
+          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
+          netmask: 0.0.0.0 (type: ipv4)
+          serverip:  (type: string)
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ dhcp eth0
+        WARNING: eth0: No MAC address set. Using random address c2:2c:a1:17:b8:47
+        T eth0: DHCP client bound to address 192.168.122.21
+        barebox@Sandbox:/ ping google.com
+        PING google.com (172.217.167.46)
+        host google.com is alive
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ devinfo eth0
+        Parent: tap0
+        Parameters:
+          ethaddr: c2:2c:a1:17:b8:47 (type: MAC)
+          gateway: 192.168.122.1 (type: ipv4)
+          ipaddr: 192.168.122.21 (type: ipv4)
+          linux.bootargs:  (type: string)
+          linux.devname:  (type: string)
+          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
+          netmask: 255.255.255.0 (type: ipv4)
+          serverip: 192.168.122.1 (type: string)
-- 
2.25.1


_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

Re: [PATCH v2] Documentation: some extra steps requires for DHCP network configuration for sandbox on the host OS

[Oleksij Rempel]

Hi,

thank you for your patch!

Am 21.04.21 um 20:08 schrieb Neeraj Pal:
> Signed-off-by: Neeraj Pal <neerajpal09@gmail.com>
> ---
>  Documentation/boards/sandbox.rst | 66 ++++++++++++++++++++++++++++++++
>  1 file changed, 66 insertions(+)
>
> diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst
> index e9e518365..925dfc808 100644
> --- a/Documentation/boards/sandbox.rst
> +++ b/Documentation/boards/sandbox.rst
> @@ -74,3 +74,69 @@ Available sandbox invocation options include:
>
>  To terminate barebox and return to the calling shell, the poweroff command is
>  suitable.
> +
> +Network configuration
> +---------------------
> +
> +While running the sandbox, the following steps are required
> +
> +* On host
> +
> +  * virbr0: virtual bridge interface created by Qemu (easy method)
> +
> +  * if Qemu virtual bridge (virbr0) is not available then manually create and configure one bridge like "br0"
> +
> +    .. code-block:: console
> +
> +        $ ip link show
> +        4: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN mode DEFAULT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> +        6: barebox: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
> +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> +
> +    .. code-block:: console
> +
> +        $ sudo apt install bridge-utils
> +        $ sudo ifconfig barebox up
> +        $ sudo brctl addif virbr0 barebox
> +        $ sudo ip link set barebox master virbr0
> +        $ sudo dhclient -v virbr0

bridge-utils and ifconfig are deprecated tools. Please use ip utils instead. Usual bridge
configuration with ip utils looks like:

# create bridge interface with name br0
ip l a name br0 type bridge
# bring up bridge interface

ip l s dev br0 up
# link existing eth0 interface to the bridge br0
ip l s eth0 master br0
ip l s dev eth0 up
ip l s eth1 master br0
ip l s dev eth1 up



In case you wont to assign static address to the bridge interface:
ip a a 172.17.1.1/24 dev br0


> +
> +* On Sandbox
> +
> +    .. code-block:: console
> +
> +        barebox@Sandbox:/ devinfo eth0
> +        Parent: tap0
> +        Parameters:
> +          ethaddr: 00:00:00:00:00:00 (type: MAC)
> +          gateway: 0.0.0.0 (type: ipv4)
> +          ipaddr: 0.0.0.0 (type: ipv4)
> +          linux.bootargs:  (type: string)
> +          linux.devname:  (type: string)
> +          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
> +          netmask: 0.0.0.0 (type: ipv4)
> +          serverip:  (type: string)
> +
> +    .. code-block:: console
> +
> +        barebox@Sandbox:/ dhcp eth0
> +        WARNING: eth0: No MAC address set. Using random address c2:2c:a1:17:b8:47
> +        T eth0: DHCP client bound to address 192.168.122.21
> +        barebox@Sandbox:/ ping google.com
> +        PING google.com (172.217.167.46)
> +        host google.com is alive
> +
> +    .. code-block:: console
> +
> +        barebox@Sandbox:/ devinfo eth0
> +        Parent: tap0
> +        Parameters:
> +          ethaddr: c2:2c:a1:17:b8:47 (type: MAC)
> +          gateway: 192.168.122.1 (type: ipv4)
> +          ipaddr: 192.168.122.21 (type: ipv4)
> +          linux.bootargs:  (type: string)
> +          linux.devname:  (type: string)
> +          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
> +          netmask: 255.255.255.0 (type: ipv4)
> +          serverip: 192.168.122.1 (type: string)
>


--
Regards,
Oleksij

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

Re: [PATCH v2] Documentation: some extra steps requires for DHCP network configuration for sandbox on the host OS

[Neeraj Pal]

Hi Oleksij,

Thank you for your inputs.

I will modify the patch as per your suggestions and share it again.

The issue is I already have Qemu virbr0 bridge, so it is very easy to
setup but in case of no already configured bridge available then I am
facing some issues to setup bridge manually, I followed lots of blogs
and tutorials but none of them working for my conditions and none of
them allocates IP address to barebox, tried both dhcp (dhclient -v
br0) and statically allocate to bridge.

However, this are no issues with barebox in this case, it is something
either I am missing or misunderstanding. So, that is  why I have used
Qemu virbr0 bridge and also suggested in the documents.

Also tried the steps suggested by you but in case of virbr0 it is
working fine and easy to setup but when creating manually bridge then
it is not allocating any IP.

Please share some inputs to help me to configure manually without Qemu
so I can also document them in the docs.


Thanks and regards,
Neeraj

On Thu, Apr 22, 2021 at 10:06 AM Oleksij Rempel <linux@rempel-privat.de> wrote:
>
> Hi,
>
> thank you for your patch!
>
> Am 21.04.21 um 20:08 schrieb Neeraj Pal:
> > Signed-off-by: Neeraj Pal <neerajpal09@gmail.com>
> > ---
> >  Documentation/boards/sandbox.rst | 66 ++++++++++++++++++++++++++++++++
> >  1 file changed, 66 insertions(+)
> >
> > diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst
> > index e9e518365..925dfc808 100644
> > --- a/Documentation/boards/sandbox.rst
> > +++ b/Documentation/boards/sandbox.rst
> > @@ -74,3 +74,69 @@ Available sandbox invocation options include:
> >
> >  To terminate barebox and return to the calling shell, the poweroff command is
> >  suitable.
> > +
> > +Network configuration
> > +---------------------
> > +
> > +While running the sandbox, the following steps are required
> > +
> > +* On host
> > +
> > +  * virbr0: virtual bridge interface created by Qemu (easy method)
> > +
> > +  * if Qemu virtual bridge (virbr0) is not available then manually create and configure one bridge like "br0"
> > +
> > +    .. code-block:: console
> > +
> > +        $ ip link show
> > +        4: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN mode DEFAULT group default qlen 1000
> > +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> > +        6: barebox: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
> > +            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
> > +
> > +    .. code-block:: console
> > +
> > +        $ sudo apt install bridge-utils
> > +        $ sudo ifconfig barebox up
> > +        $ sudo brctl addif virbr0 barebox
> > +        $ sudo ip link set barebox master virbr0
> > +        $ sudo dhclient -v virbr0
>
> bridge-utils and ifconfig are deprecated tools. Please use ip utils instead. Usual bridge
> configuration with ip utils looks like:
>
> # create bridge interface with name br0
> ip l a name br0 type bridge
> # bring up bridge interface
>
> ip l s dev br0 up
> # link existing eth0 interface to the bridge br0
> ip l s eth0 master br0
> ip l s dev eth0 up
> ip l s eth1 master br0
> ip l s dev eth1 up
>
>
>
> In case you wont to assign static address to the bridge interface:
> ip a a 172.17.1.1/24 dev br0
>
>
> > +
> > +* On Sandbox
> > +
> > +    .. code-block:: console
> > +
> > +        barebox@Sandbox:/ devinfo eth0
> > +        Parent: tap0
> > +        Parameters:
> > +          ethaddr: 00:00:00:00:00:00 (type: MAC)
> > +          gateway: 0.0.0.0 (type: ipv4)
> > +          ipaddr: 0.0.0.0 (type: ipv4)
> > +          linux.bootargs:  (type: string)
> > +          linux.devname:  (type: string)
> > +          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
> > +          netmask: 0.0.0.0 (type: ipv4)
> > +          serverip:  (type: string)
> > +
> > +    .. code-block:: console
> > +
> > +        barebox@Sandbox:/ dhcp eth0
> > +        WARNING: eth0: No MAC address set. Using random address c2:2c:a1:17:b8:47
> > +        T eth0: DHCP client bound to address 192.168.122.21
> > +        barebox@Sandbox:/ ping google.com
> > +        PING google.com (172.217.167.46)
> > +        host google.com is alive
> > +
> > +    .. code-block:: console
> > +
> > +        barebox@Sandbox:/ devinfo eth0
> > +        Parent: tap0
> > +        Parameters:
> > +          ethaddr: c2:2c:a1:17:b8:47 (type: MAC)
> > +          gateway: 192.168.122.1 (type: ipv4)
> > +          ipaddr: 192.168.122.21 (type: ipv4)
> > +          linux.bootargs:  (type: string)
> > +          linux.devname:  (type: string)
> > +          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
> > +          netmask: 255.255.255.0 (type: ipv4)
> > +          serverip: 192.168.122.1 (type: string)
> >
>
>
> --
> Regards,
> Oleksij

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

[PATCH v3] Documentation: boards: sandbox: some extra steps requires for DHCP network configuration for sandbox on the host OS

[Neeraj Pal]

Signed-off-by: Neeraj Pal <neerajpal09@gmail.com>
---
 Documentation/boards/sandbox.rst | 65 ++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst
index e9e518365..2272dc32c 100644
--- a/Documentation/boards/sandbox.rst
+++ b/Documentation/boards/sandbox.rst
@@ -74,3 +74,68 @@ Available sandbox invocation options include:
 
 To terminate barebox and return to the calling shell, the poweroff command is
 suitable.
+
+Network configuration
+---------------------
+
+While running the sandbox, the following steps are required
+
+* On host
+
+  * virbr0: virtual bridge interface created by Qemu (easy method)
+
+  * if Qemu virtual bridge (virbr0) is not available then manually create and configure one bridge like "br0"
+
+    .. code-block:: console
+
+        $ ip link show
+        4: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+        6: barebox: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
+            link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
+
+    .. code-block:: console
+
+        $ install iproute2 package, if not installed: sudo apt-get install iproute2
+        $ sudo ip l s dev barebox up
+        $ sudo ip l s barebox master virbr0
+        $ sudo dhclient -v virbr0
+
+* On Sandbox
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ devinfo eth0
+        Parent: tap0
+        Parameters:
+          ethaddr: 00:00:00:00:00:00 (type: MAC)
+          gateway: 0.0.0.0 (type: ipv4)
+          ipaddr: 0.0.0.0 (type: ipv4)
+          linux.bootargs:  (type: string)
+          linux.devname:  (type: string)
+          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
+          netmask: 0.0.0.0 (type: ipv4)
+          serverip:  (type: string)
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ dhcp eth0
+        WARNING: eth0: No MAC address set. Using random address c2:2c:a1:17:b8:47
+        T eth0: DHCP client bound to address 192.168.122.21
+        barebox@Sandbox:/ ping google.com
+        PING google.com (172.217.167.46)
+        host google.com is alive
+
+    .. code-block:: console
+
+        barebox@Sandbox:/ devinfo eth0
+        Parent: tap0
+        Parameters:
+          ethaddr: c2:2c:a1:17:b8:47 (type: MAC)
+          gateway: 192.168.122.1 (type: ipv4)
+          ipaddr: 192.168.122.21 (type: ipv4)
+          linux.bootargs:  (type: string)
+          linux.devname:  (type: string)
+          mode: dhcp (type: enum) (values: "dhcp", "static", "disabled")
+          netmask: 255.255.255.0 (type: ipv4)
+          serverip: 192.168.122.1 (type: string)
-- 
2.25.1


_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox