Difference between revisions of "Netplug"

From CBLFS
Jump to navigationJump to search
 
(8 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
!Download Source:
 
!Download Source:
 
|-
 
|-
| http://www.red-bean.com/~bos/netplug/netplug-1.2.9.tar.bz2
+
| http://www.red-bean.com/~bos/netplug/netplug-{{NetPlug-Version}}.tar.bz2
 
|-
 
|-
 
!Download Patches:
 
!Download Patches:
 
|-
 
|-
| http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-1.2.9-gcc4-1.patch
+
| http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-{{NetPlug-Version}}-gcc4-1.patch
 
|-
 
|-
| http://svn.cross-lfs.org/svn/repos/patches/netplug-1.2.9/netplug-1.2.9-ignore-wireless-1.patch
+
| http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-{{NetPlug-Version}}-ignore-wireless-1.patch
 
|-
 
|-
| http://svn.cross-lfs.org/svn/repos/patches/netplug-1.2.9/netplug-1.2.9-remove-nest-1.patch
+
| http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-{{NetPlug-Version}}-remove-nest-1.patch
 
|}
 
|}
  
 
----
 
----
  
== Introduction to Netplug ==
+
{{Package-Introduction|'''Netplug''' is a Linux daemon that brings up/down network interfaces in response to network cables being plugged in and out.  This application is mostly useful for a laptop or computer (used for lan parties?) that is often relocated to different LANs.
  
'''Netplug''' is a Linux daemon that brings up/down network interfaces in response to network cables being plugged in and out.  This application is mostly useful for a laptop or computer (used for lan parties?) that is often relocated to different LANs.
+
The netplugd rc script shared below replaces the clfs-bootscripts network script.  If you remove the network script and symlinks in the rc#.d directories, and later decide you want them, then merely reinstall from the clfs-bootscripts.}}
 
 
The netplugd rc script shared below replaces the clfs-bootscripts network script.  If you remove the network script and symlinks in the rc#.d directories, and later decide you want them, then merely reinstall from the clfs-bootscripts.
 
  
 
== Dependencies ==
 
== Dependencies ==
 
=== Required ===
 
* [[Dhcpcd]]
 
* or other dhcp client
 
  
 
== Configuration Information ==
 
== Configuration Information ==
Line 33: Line 27:
  
 
== Non-Multilib ==
 
== Non-Multilib ==
 
Much of this, including the patches were ripped from the Gentoo ebuild.  These instructions did successfully install the application onto a pentium-m based x86 laptop.
 
  
 
Modify the Makefile:
 
Modify the Makefile:
Line 43: Line 35:
 
  sed -i '/bk_root/,$d' Makefile
 
  sed -i '/bk_root/,$d' Makefile
  
Apply patches:
+
Compile the package:
  
  patch -Np0 -i ../netplug-1.2.9-gcc4-1.patch
+
  patch -Np0 -i ../netplug-{{NetPlug-Version}}-gcc4-1.patch &&
  patch -Np1 -i ../netplug-1.2.9-remove-nest-1.patch
+
  patch -Np1 -i ../netplug-{{NetPlug-Version}}-remove-nest-1.patch &&
  patch -Np1 -i ../netplug-1.2.9-ignore-wireless-1.patch
+
  patch -Np1 -i ../netplug-{{NetPlug-Version}}-ignore-wireless-1.patch &&
 +
make
  
Compile and install the package:
+
Install the package:
  
make
 
 
  make install
 
  make install
  
Line 65: Line 57:
  
 
== Multilib ==
 
== Multilib ==
'''''AFAICT this package does not provide any libraries so only one installation is needed.'''''
+
'''''This package does not install any libraries so only one installation is needed.'''''
  
 
=== 32Bit ===
 
=== 32Bit ===
  
'''''Must be tested and any instructions should be included by others'''''
+
Modify the Makefile:
 +
 
 +
remove=" -ggdb3 "
 +
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
 +
sed -i -e "s/${remove}/ /" Makefile
 +
sed -i '/bk_root/,$d' Makefile
 +
 
 +
Compile the package:
 +
 
 +
patch -Np0 -i ../netplug-{{NetPlug-Version}}-gcc4-1.patch &&
 +
patch -Np1 -i ../netplug-{{NetPlug-Version}}-remove-nest-1.patch &&
 +
patch -Np1 -i ../netplug-{{NetPlug-Version}}-ignore-wireless-1.patch &&
 +
make CC="gcc ${BUILD32}"
 +
 
 +
Install the package:
 +
 
 +
make install
  
 
=== N32 ===
 
=== N32 ===
  
'''''Must be tested and any instructions should be included by others'''''
+
Modify the Makefile:
 +
 
 +
remove=" -ggdb3 "
 +
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
 +
sed -i -e "s/${remove}/ /" Makefile
 +
sed -i '/bk_root/,$d' Makefile
 +
 
 +
Compile the package:
 +
 
 +
patch -Np0 -i ../netplug-{{NetPlug-Version}}-gcc4-1.patch &&
 +
patch -Np1 -i ../netplug-{{NetPlug-Version}}-remove-nest-1.patch &&
 +
patch -Np1 -i ../netplug-{{NetPlug-Version}}-ignore-wireless-1.patch &&
 +
make CC="gcc ${BUILDN32}"
 +
 
 +
Install the package:
 +
 
 +
make install
  
 
=== 64Bit ===
 
=== 64Bit ===
  
'''''Must be tested and any instructions should be included by others'''''
+
Modify the Makefile:
 +
 
 +
remove=" -ggdb3 "
 +
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
 +
sed -i -e "s/${remove}/ /" Makefile
 +
sed -i '/bk_root/,$d' Makefile
 +
 
 +
Compile the package:
 +
 
 +
patch -Np0 -i ../netplug-{{NetPlug-Version}}-gcc4-1.patch &&
 +
patch -Np1 -i ../netplug-{{NetPlug-Version}}-remove-nest-1.patch &&
 +
patch -Np1 -i ../netplug-{{NetPlug-Version}}-ignore-wireless-1.patch &&
 +
make CC="gcc ${BUILD64}"
 +
 
 +
Install the package:
 +
 
 +
make install
  
 
== Configuring ==
 
== Configuring ==
Line 84: Line 124:
 
as necessary for your system.  Create the netplugd script:
 
as necessary for your system.  Create the netplugd script:
  
  cat > /etc/rc.d/init.d/netplugd << "EOF
+
  cat > /etc/rc.d/init.d/netplugd << EOF
 
  #!/bin/sh
 
  #!/bin/sh
 
  ########################################################################
 
  ########################################################################
 
  # Begin $rc_base/init.d/netplugd
 
  # Begin $rc_base/init.d/netplugd
 
  #
 
  #
  # Description : Netplugd-1.2.9
+
  # Description : Netplugd-{{NetPlug-Version}}
 
  #
 
  #
 
  # Authors    : Harvey Muller
 
  # Authors    : Harvey Muller
Line 159: Line 199:
 
  EOF
 
  EOF
  
The clfs-bootscripts network rc script is no longer necessary.  You may remove the network script and symlinks with these commands:
+
The [[bootscripts]] network rc script is no longer necessary.  You may remove the network script and symlinks with these commands:
  
 
  rm -rf /etc/rc.d/init.d/network
 
  rm -rf /etc/rc.d/init.d/network
Line 186: Line 226:
 
  ln -sf /etc/sysconfig/network-devices/ifup /sbin/ifup
 
  ln -sf /etc/sysconfig/network-devices/ifup /sbin/ifup
 
  ln -sf /etc/sysconfig/network-devices/ifdown /sbin/ifdown
 
  ln -sf /etc/sysconfig/network-devices/ifdown /sbin/ifdown
 
And finally modify ifconfig.etho/dhcpcd changing ONBOOT=yes to ONBOOT=no, using your favorite editor, or use the following sed script:
 
 
sed -i -e '/ONBOOT/s/yes/no/' /etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd
 
  
 
= Contents =
 
= Contents =
Line 206: Line 242:
  
 
netplugd: a daemon which automatically brings your network interface up/down based on cable insertion/removal.
 
netplugd: a daemon which automatically brings your network interface up/down based on cable insertion/removal.
 +
 +
[[Category:Network Utilities]]

Latest revision as of 17:18, 19 March 2009

Download Source:
http://www.red-bean.com/~bos/netplug/netplug-1.2.9.tar.bz2
Download Patches:
http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-1.2.9-gcc4-1.patch
http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-1.2.9-ignore-wireless-1.patch
http://svn.cross-lfs.org/svn/repos/patches/netplug/netplug-1.2.9-remove-nest-1.patch

Introduction to Netplug

Netplug is a Linux daemon that brings up/down network interfaces in response to network cables being plugged in and out. This application is mostly useful for a laptop or computer (used for lan parties?) that is often relocated to different LANs.

The netplugd rc script shared below replaces the clfs-bootscripts network script. If you remove the network script and symlinks in the rc#.d directories, and later decide you want them, then merely reinstall from the clfs-bootscripts.

Project Homepage: Unknown

Dependencies

Configuration Information

This package does not use a configure script. Any additional configuration must be made within the Makefile.

Non-Multilib

Modify the Makefile:

remove=" -ggdb3 "
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
sed -i -e "s/${remove}/ /" Makefile
sed -i '/bk_root/,$d' Makefile

Compile the package:

patch -Np0 -i ../netplug-1.2.9-gcc4-1.patch &&
patch -Np1 -i ../netplug-1.2.9-remove-nest-1.patch &&
patch -Np1 -i ../netplug-1.2.9-ignore-wireless-1.patch &&
make

Install the package:

make install

Command Explanations

remove...
[[ "$C...
sed -i...: These commands remove -O3 (if you are using another optimization) and debugging from the Makefile.

sed -i '/bk_root/,$d' Makefile: This removes the bitkeeper stuff, you might omit this if you are using it.

Multilib

This package does not install any libraries so only one installation is needed.

32Bit

Modify the Makefile:

remove=" -ggdb3 "
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
sed -i -e "s/${remove}/ /" Makefile
sed -i '/bk_root/,$d' Makefile

Compile the package:

patch -Np0 -i ../netplug-1.2.9-gcc4-1.patch &&
patch -Np1 -i ../netplug-1.2.9-remove-nest-1.patch &&
patch -Np1 -i ../netplug-1.2.9-ignore-wireless-1.patch &&
make CC="gcc ${BUILD32}"

Install the package:

make install

N32

Modify the Makefile:

remove=" -ggdb3 "
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
sed -i -e "s/${remove}/ /" Makefile
sed -i '/bk_root/,$d' Makefile

Compile the package:

patch -Np0 -i ../netplug-1.2.9-gcc4-1.patch &&
patch -Np1 -i ../netplug-1.2.9-remove-nest-1.patch &&
patch -Np1 -i ../netplug-1.2.9-ignore-wireless-1.patch &&
make CC="gcc ${BUILDN32}"

Install the package:

make install

64Bit

Modify the Makefile:

remove=" -ggdb3 "
[[ " ${CFLAGS} " == *" -O"[0-9]" "* ]] && remove="${remove}-O3 "
sed -i -e "s/${remove}/ /" Makefile
sed -i '/bk_root/,$d' Makefile

Compile the package:

patch -Np0 -i ../netplug-1.2.9-gcc4-1.patch &&
patch -Np1 -i ../netplug-1.2.9-remove-nest-1.patch &&
patch -Np1 -i ../netplug-1.2.9-ignore-wireless-1.patch &&
make CC="gcc ${BUILD64}"

Install the package:

make install

Configuring

The rc script below is customized for a CLFS system. Feel free to modify this as necessary for your system. Create the netplugd script:

cat > /etc/rc.d/init.d/netplugd << EOF
#!/bin/sh
########################################################################
# Begin $rc_base/init.d/netplugd
#
# Description : Netplugd-1.2.9
#
# Authors     : Harvey Muller
#
# Version     : 00.02
#
# Notes       : Still beta
#
########################################################################

. /etc/sysconfig/rc
. ${rc_functions}

if [ ! -x /sbin/netplugd ]; then
	echo "/sbin/netplugd missing, or needs to be installed ..."
	exit 1
fi

# Use netplugd if present, it supplies NETPLUGDARGS if needed.
if [ -f /etc/sysconfig/netplugd ]; then
	. /etc/sysconfig/netplugd
fi

if [ `id -u` != "0" ] && [ "$1" = "start" -o "$1" = "stop" ] ; then
  echo "You must be root to start, stop or restart netplugd."
  exit 1
fi

case "${1}" in
	start)
		boot_mesg "Starting network plug daemon..."
		loadproc /sbin/netplugd ${NETPLUGDARGS} -p /var/run/netplugd.pid
		RETVAL=$?
		echo
		[ $RETVAL -eq 0 ] && touch /var/lock/subsys/netplugd
	;;

	stop)
		boot_mesg "Stopping network plug daemon..."
		killproc netplugd
		RETVAL=$?
		echo
		[ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/netplugd
	;;

	restart|reload)
		${0} stop
		${0} start
	;;

	status)
		statusproc netplugd
		RETVAL=$?
	;;

	condrestart)
		[ -f /var/lock/subsys/netplugd ] && restart || :
	;;

	*)
		echo "Usage: ${0} {start|stop|reload|restart|status|condrestart}"
		exit 1
	;;
esac

exit $RETVAL

# End $rc_base/init.d/netplugd
EOF

The bootscripts network rc script is no longer necessary. You may remove the network script and symlinks with these commands:

rm -rf /etc/rc.d/init.d/network
rm -rf /etc/rc.d/rc*.d/{S2,K8}0network

Create symlinks to netplugd script:

ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc0.d/K80netplugd
ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc1.d/K80netplugd
ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc2.d/S20netplugd
ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc3.d/S20netplugd
ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc4.d/S20netplugd
ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc5.d/S20netplugd
ln -sf /etc/rc.d/init.d/netplugd /etc/rc.d/rc6.d/K80netplugd

If you have configured your wired interface through udev (or other means) to be named eth0, and you only have one wired interface, then we may as well configure netplug to use it only:

sed -i 's/eth\*/eth0/' /etc/netplug/netplugd.conf

Netplug requires the /var/lock/subsys directory be present, and the Makefile doesn't create it:

[ -d /var/lock/subsys ] || install -d -m755 /var/lock/subsys

You could just modify the policy agent to reflect the CLFS locations, but let's make links in /sbin for ifup and ifdown:

ln -sf /etc/sysconfig/network-devices/ifup /sbin/ifup
ln -sf /etc/sysconfig/network-devices/ifdown /sbin/ifdown

Contents

Installed Programs: /sbin/netplugd

Installed Libraries: none

Installed Directories: /etc/netplug, /etc/netplug.d, /var/lock/subsys

Installed Scripts: /etc/netplug.d/netplug, /etc/rc.d/init.d/netplugd

Installed Documentation: /usr/share/man/man8/netplugd.8

Short Descriptions

netplugd: a daemon which automatically brings your network interface up/down based on cable insertion/removal.