====== Secrets of /etc/init.d/network.sh ======

===== Introduction =====

SliTaz launches the /etc/init.d/network.sh at startup to initialize the network. It configures the hostname, loopback interface, and internet connection.

It's also possible to call the script when SliTaz is started, and use it to open or close internet connections. For example netbox and any software linking get-wifi-firmware (get-ipw2100-firmware, get-b43-firmware...) use it.

===== Usage =====

By default, /etc/init.d/network.sh uses /etc/network.conf as the conf file. Parameters written in that file are made for the default network connection.

To start the default connection, as when booting:

<code>
# /etc/init.d/network.sh start
</code>

The start arg should be used only at boot. To stop the connection:

<code>
# /etc/init.d/network.sh stop
</code>

To stop and restart:

<code>
# /etc/init.d/network.sh restart
</code>

But, most interestingly, is that ///etc/init.d/network.sh// may also use another config file. It's useful if you're using a laptop, as you can configure multiple connections for multiple access points.

For example, we can create a directory /etc/network, containing some config files, named:

    * Home, for home, using an ethernet connection and a static ip.
    * Desktop, for the desktop, with a wep encryption, and a static ip.
    * Univ, wifi without encryption, and with dhcp.

Now to get connected at Home, later at a Desktop and finally at Univ, before stopping connection, we only have to:

<code>
# /etc/init.d/network.sh restart /etc/network/Home
# /etc/init.d/network.sh restart /etc/network/Desktop
# /etc/init.d/network.sh restart /etc/network/Univ
# /etc/init.d/network.sh stop
</code>

===== Sudo =====

Since /etc/init.d/network.sh/ can only be used by root, if you want a normal user to use it, you should install sudo:

<code>
# tazpkg get-install sudo
</code>

And then configure it:

<code>
# visudo
</code>

For user tux, which must use network.sh from every host; without a password you should add:

<file>
tux  ALL=NOPASSWD: /etc/init.d/network.sh,
</file>

For user tortux, which may only get connected from localhost, and which should use a password each time, you should add:

<file>
tortux my_hostname=PASSWD: /etc/init.d/network.sh,
</file>

If you forgot your hostname, just run:

<code>
$ cat /etc/hostname
</code>

Here is some help to use visudo:

    * i insertion mode (to write).
    * Escape exit insertion mode.
    * :wq record and quit.
    * :q! quit without recording.

===== Openbox =====

All this is not that really user friendly...

That's why I'll give you a perfect treat: A way to integrate all this in an openbox menu! Create a script /usr/lib/openbox/network-menu.sh, and add this to it:

<code bash>
#!/bin/sh
#
# openbox pipe menu to start network connections
# (This script is only useful if sudo is installed, and correctly configured)

echo '<openbox_pipe_menu>'

# for default file:
echo '<item label="Load Default network.conf">'
echo -n '<action name="Execute"><execute>'
echo -n "sudo /etc/init.d/network.sh restart"
echo '</execute></action>'
echo '</item>'

# for other configuration files (you may state a different directory here
# depending on your setup):
# e.g nice for frugal installs:
# ls /home/tux/network/ | while read; do
ls /etc/network/ | while read; do
echo '<item label="'"${REPLY}"'">'
echo -n '<action name="Execute"><execute>'
echo -n "sudo /etc/init.d/network.sh restart '/etc/network/${REPLY}'"
echo '</execute></action>'
echo '</item>'
done

# To stop connections:
echo '<item label="stop Connection">'
echo -n '<action name="Execute"><execute>'
echo -n "sudo /etc/init.d/network.sh stop"
echo '</execute></action>'
echo '</item>'

echo '</openbox_pipe_menu>' 
</code>

Make it executable:

<code sh>
# chmod +x /usr/lib/openbox/network-menu.sh
</code>

And now you only have to add these lines in //~/.config/openbox/menu.xml//:

<file>
 <menu id="network-menu" label="Network" 
	execute="/usr/lib/openbox/network-menu.sh" />
</file>

Then reconfigure openbox:
 
<code>
$ openbox --reconfigure
</code>

Enjoy!

---- 
\\
^  Page Review Section  ^^ 
|Quality| Good  |
|Review| Minor Updates  |
|Priority| Medium |
|Problems| add a [[http://forum.slitaz.org|forum post link]]|
|:::     | OR add a [[http://labs.slitaz.org/issues |lab issue tracker link ]]|
|How to Improve| Suggest briefly|
|::: |  |

\\
----