[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#616197: Man page wrong on ip=... parameter



Package: live-boot
Version: 2.0.15-1

The man page of live-boot says this regarding the ip=... parameter:

  ip=[CLIENT_IP]:[SERVER_IP]:[GATEWAY_IP]:[NETMASK]:[HOST-
  NAME]:[DEVICE]:[AUTOCONF]  [,[CLIENT_IP]:[SERVER_IP]:[GATEWAY_IP]:[NET-
  MASK]:[HOSTNAME]:[DEVICE]:[AUTOCONF]]
      Let  you  specify  the  name(s) and the options of the interface(s)
      that should be configured at boot time. Do not specify this if  you
      want  to use dhcp (default). It will be changed in a future release
      to  mimick  official  kernel   boot   param   specification   (e.g.
      ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp).

(Taken from
http://manpages.debian.net/cgi-bin/man.cgi?locale=en&query=live-boot&manpath=Debian+6.0+squeeze)

However, live-bottom/23networking parses the parameter as follows.

  [...]
  if [ -z "${NETBOOT}" -a -n "${STATICIP}" -a "${STATICIP}" != "frommedia" ]
  then
  	parsed=$(echo "${STATICIP}" | sed -e 's/,/ /g')
  
  	for ifline in ${parsed}
  	do
  		ifname="$(echo ${ifline} | cut -f1 -d ':')"
  		ifaddress="$(echo ${ifline} | cut -f2 -d ':')"
  		ifnetmask="$(echo ${ifline} | cut -f3 -d ':')"
  		ifgateway="$(echo ${ifline} | cut -f4 -d ':')"
  [...]

E.g., the interface name, not the IP adress is the first parameter; the
others are in different positions as well.

The line in my grub.cfg (used with FAI 3.4.7) thus reads

  linux /boot/vmlinuz boot=live FAI_ACTION=install FAI_FLAGS="verbose,sshd" ip=eth0:192.168.1.10:255.255.255.0:192.168.1.1 hostname=server

which works for me.

Is this a bug in the documentation, or in the actual behavior?

(Furthermore, the last sentence of the man page's description does not make
sense to me, considering that the format documented seems to be consistent
with the kernel boot parameter specification. If this a problem with my
understanding of English, I apologize.)



Reply to: