Debian Bug report logs - #504064
ip: missing documentation for ip link add|del

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Michael Gebetsroither <gebi@grml.org>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: ip: missing documentation for ip link add|del

Date: Fri, 31 Oct 2008 00:52:18 +0100

Package: iproute
Version: 20080725-2
Severity: normal

hi,

The complete configuration and removing of vlan and veth devices with ip
is undocumented.
This interfaces is especially nice because it does not enforce a fixed
naming convention on vlan interfaces like vconfig (which is already
deprecated by it's developers[0]).

create vlan:
# ip link add link eth0 name dmz100 type vlan id 100

remove vlan:
# ip link del dev dmz100

supported parameters by type=vlan:
# ip link add type vlan help
Usage: ... vlan id VLANID [ FLAG-LIST ]
                          [ ingress-qos-map QOS-MAP ] [ egress-qos-map QOS-MAP ]

VLANID := 0-4095
FLAG-LIST := [ FLAG-LIST ] FLAG
FLAG := [ reorder_hdr { on | off } ]
QOS-MAP := [ QOS-MAP ] QOS-MAPPING
QOS-MAPPING := FROM:TO

there is also a type veth (maybe openvz's veth device?)

Would be nice to have this in the doku of ip link help

[0]: http://www.spinics.net/lists/netdev/msg77014.html

michael

-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (991, 'unstable'), (500, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.23-grml64 (SMP w/2 CPU cores; PREEMPT)
Locale: LANG=en_US.iso885915, LC_CTYPE=en_US.iso885915 (charmap=ISO-8859-15)
Shell: /bin/sh linked to /bin/bash

Versions of packages iproute depends on:
ii  libc6                         2.7-13     GNU C Library: Shared libraries
ii  libdb4.6                      4.6.21-4   Berkeley v4.6 Database Libraries [

Versions of packages iproute recommends:
ii  libatm1                       2.4.1-17.1 shared library for ATM (Asynchrono

Versions of packages iproute suggests:
pn  iproute-doc                   <none>     (no description available)

-- no debconf information

Message #10 received at 504064@bugs.debian.org (full text, mbox, reply):

From: Andreas Henriksson <andreas@fatal.se>

To: Michael Gebetsroither <gebi@grml.org>, 504064@bugs.debian.org

Subject: Re: Bug#504064: ip: missing documentation for ip link add|del

Date: Fri, 31 Oct 2008 07:56:54 +0100

tags 504064 + fixed-upstream
thanks 

On fre, 2008-10-31 at 00:52 +0100, Michael Gebetsroither wrote:
[...]
> Would be nice to have this in the doku of ip link help

This is fixed in upstream git. 
http://git.kernel.org/?p=linux/kernel/git/shemminger/iproute2.git;a=commitdiff;h=750a405a5a6f6cdae7d14609b49051e59738177e
(Updated manpages and additional documentation is still missing though.
Any help with documentation is very welcome. There are several things
listed at http://bugs.debian.org/iproute for places where documentation
can be improved for anyone willing to help.)


Please also see (and feel free to help out with)
http://bugs.debian.org/501402




-- 
Regards,
Andreas Henriksson

Message #19 received at 504064-close@bugs.debian.org (full text, mbox, reply):

From: Andreas Henriksson <andreas@fatal.se>

To: 504064-close@bugs.debian.org

Subject: Bug#504064: fixed in iproute 20090115-1

Date: Mon, 02 Mar 2009 11:32:12 +0000

Source: iproute
Source-Version: 20090115-1

We believe that the bug you reported is fixed in the latest version of
iproute, which is due to be installed in the Debian FTP archive:

iproute-dev_20090115-1_amd64.deb
  to pool/main/i/iproute/iproute-dev_20090115-1_amd64.deb
iproute-doc_20090115-1_all.deb
  to pool/main/i/iproute/iproute-doc_20090115-1_all.deb
iproute_20090115-1.diff.gz
  to pool/main/i/iproute/iproute_20090115-1.diff.gz
iproute_20090115-1.dsc
  to pool/main/i/iproute/iproute_20090115-1.dsc
iproute_20090115-1_amd64.deb
  to pool/main/i/iproute/iproute_20090115-1_amd64.deb
iproute_20090115.orig.tar.gz
  to pool/main/i/iproute/iproute_20090115.orig.tar.gz



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 504064@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Andreas Henriksson <andreas@fatal.se> (supplier of updated iproute package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.8
Date: Wed, 20 Aug 2008 23:01:17 +0200
Source: iproute
Binary: iproute iproute-doc iproute-dev
Architecture: source all amd64
Version: 20090115-1
Distribution: unstable
Urgency: low
Maintainer: Debian iproute maintainers <ah-iproute@debian.org>
Changed-By: Andreas Henriksson <andreas@fatal.se>
Description: 
 iproute    - networking and traffic control tools
 iproute-dev - networking and traffic control tools - development files
 iproute-doc - networking and traffic control tools - documentation
Closes: 492196 497011 497278 504064
Changes: 
 iproute (20090115-1) unstable; urgency=low
 .
   [ Andreas Henriksson ]
   * debian/rules: Make stamp-doc target depend on patch target.
     - package fails to build binary-indep because of missing txt target
       in doc/Makefile if invoked manually. Reported by Dean Gaudet.
   * New upstream release v2.6.27 (aka 081027, tagged but no tarballs).
     - old ipv4 abbrevation compatibility restored. (Closes: #497011)
     - make it possible to use tunnel names matching "help", if specified
       with explicit "name" parameter before name. (Closes: #497278)
     - add new ip link parameters in usage text when running on
       a kernel that supports them. (Closes: #504064)
     - only print "Nothing to flush" when told to show stats. (Closes: #492196)
   * New upstream release v2.6.28 (aka 090115).
Checksums-Sha1: 
 3987be4e455da7bc7f4e64bbee55cabd2ec4ac7c 1413 iproute_20090115-1.dsc
 e796a123da02961671af7da0da98d0dab380dd63 441487 iproute_20090115.orig.tar.gz
 f09438f2411e53304c76d586b5939b46c6fe2230 26857 iproute_20090115-1.diff.gz
 193067d92f1bbf130a4d18d045a6468a67211066 702210 iproute-doc_20090115-1_all.deb
 2ad9feb96d11d7fe2374510cf0e3d011fffe36fa 399832 iproute_20090115-1_amd64.deb
 324c7f4d847df1fc72b9516496dc826257fa9975 17084 iproute-dev_20090115-1_amd64.deb
Checksums-Sha256: 
 011b55e90485d289f79c2e2c0ca0889ce3fecb0c2d1de8d503dd47ab08f10fc5 1413 iproute_20090115-1.dsc
 ae1475b2f7c791cf2586298d6a4fe4db9a3ecd3b396a5808adc92be879bddc38 441487 iproute_20090115.orig.tar.gz
 340f919798536906a32f8712dbac6eaaab0161df8c18be912c7e78c50cea17f7 26857 iproute_20090115-1.diff.gz
 28ff70226d3b88cc6738213605252fadce756e32a353e973432a99e36d2cb2c6 702210 iproute-doc_20090115-1_all.deb
 1526a7b6d838576c45d3327e069b8a7108f2e3b77d36d9a46f40dbc6ab87bda4 399832 iproute_20090115-1_amd64.deb
 6a1411fe68c7b2ab9daeac22ad67d3121efa05135dc9e89b5707996f5a515995 17084 iproute-dev_20090115-1_amd64.deb
Files: 
 7e0a3bf930446e43f86c57bc6cf84d3f 1413 net optional iproute_20090115-1.dsc
 8c801213111d3f45e24fc8ecd4bc968e 441487 net optional iproute_20090115.orig.tar.gz
 032a5f2cceba78ec0a517254be117e74 26857 net optional iproute_20090115-1.diff.gz
 a782c5541b46602510949e72f28a6d69 702210 doc optional iproute-doc_20090115-1_all.deb
 0e0c9679945c7a851f7487f941e80a92 399832 net important iproute_20090115-1_amd64.deb
 0b583a3e2b83f90ed0c3722b07c635da 17084 libdevel optional iproute-dev_20090115-1_amd64.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkmrw3IACgkQcgQ2cL3l8e7ybgCcDo1CXzX6GruPOZE7orMKJQbO
fXYAmwWVBP10QGXXhqVv1hFM9fS+abgd
=1iLN
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.