inetutils-ifconfig(1) [debian man page]

IFCONFIG(1)							   User Commands						       IFCONFIG(1)

NAME

       ifconfig - configure network interfaces

SYNOPSIS

       ifconfig [OPTION...]

DESCRIPTION

	      NAME [ADDR] [broadcast BRDADDR] [pointopoint|dstaddr DSTADDR]

	      [netmask MASK] [metric N] [mtu N] [txqueuelen N] [up|down] [FLAGS]

       Configure network interfaces.

       -a, --all
	      display all available interfaces

       -A, --address=ADDR
	      set interface address to ADDR

       -B, -b, --broadcast=ADDR, --brdaddr=ADDR
	      set broadcast address to ADDR

       -d, -p, --dstaddr=ADDR, --peer=ADDR
	      set destination (peer) address to ADDR

       --down shut the interface down

       --format=FORMAT
	      select output format (or set back to default)

       -F, --flags=FLAG[,FLAG...] set interface flags

       -i, --interface=NAME
	      configure network interface NAME

       -m, --netmask=MASK
	      set netmask to MASK

       --metric=N
	      set metric of interface to N

       -M, --mtu=N
	      set mtu of interface to N

       -s, --short
	      short output format

       --up   activate the interface (default if address is given)

       -v, --verbose
	      output information when configuring interface

	      Linux-specific options

       -T, --txqlen=N
	      set transmit queue length to N

       -?, --help
	      give this help list

       --usage
	      give a short usage message

       -V, --version
	      print program version

       Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

       Known flags are: allmulti, automedia, debug, loopback, multicast, portsel, running, trailers, up

AUTHOR

       Written by Marcus Brinkmann.

REPORTING BUGS

       Report bugs to <bug-inetutils@gnu.org>.

COPYRIGHT

       Copyright (C) 2011 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       The  full  documentation  for ifconfig is maintained as a Texinfo manual.  If the info and ifconfig programs are properly installed at your
       site, the command

	      info ifconfig

       should give you access to the complete manual.

GNU inetutils 1.9						   December 2011						       IFCONFIG(1)

Interface::Simple(3pm)					User Contributed Perl Documentation				    Interface::Simple(3pm)

NAME

       IO::Interface::Simple - Perl extension for access to network card configuration information

SYNOPSIS

	use IO::Interface::Simple;

	my $if1   = IO::Interface::Simple->new('eth0');
	my $if2   = IO::Interface::Simple->new_from_address('127.0.0.1');
	my $if3   = IO::Interface::Simple->new_from_index(1);

	my @interfaces = IO::Interface::Simple->interfaces;

	for my $if (@interfaces) {
	   print "interface = $if
";
	   print "addr =      ",$if->address,"
",
		 "broadcast = ",$if->broadcast,"
",
		 "netmask =   ",$if->netmask,"
",
		 "dstaddr =   ",$if->dstaddr,"
",
		 "hwaddr =    ",$if->hwaddr,"
",
		 "mtu =       ",$if->mtu,"
",
		 "metric =    ",$if->metric,"
",
		 "index =     ",$if->index,"
";

	   print "is running
"     if $if->is_running;
	   print "is broadcast
"   if $if->is_broadcast;
	   print "is p-to-p
"	    if $if->is_pt2pt;
	   print "is loopback
"    if $if->is_loopback;
	   print "is promiscuous
" if $if->is_promiscuous;
	   print "is multicast
"   if $if->is_multicast;
	   print "is notrailers
"  if $if->is_notrailers;
	   print "is noarp
"	    if $if->is_noarp;
	 }

DESCRIPTION

       IO::Interface::Simple allows you to interrogate and change network interfaces. It has overlapping functionality with Net::Interface, but
       might compile and run on more platforms.

   Class Methods
       $interface = IO::Interface::Simple->new('eth0')
	   Given an interface name, new() creates an interface object.

       @iflist = IO::Interface::Simple->interfaces;
	   Returns a list of active interface objects.

       $interface = IO::Interface::Simple->new_from_address('192.168.0.1')
	   Returns the interface object corresponding to the given address.

       $interface = IO::Interface::Simple->new_from_index(2)
	   Returns the interface object corresponding to the given numeric index. This is only supported on BSD-ish platforms.

   Object Methods
       $name = $interface->name
	   Get the name of the interface. The interface object is also overloaded so that if you use it in a string context it is the same as
	   calling name().

       $index = $interface->index
	   Get the index of the interface. This is only supported on BSD-like platforms.

       $addr = $interface->address([$newaddr])
	   Get or set the interface's address.

       $addr = $interface->broadcast([$newaddr])
	   Get or set the interface's broadcast address.

       $addr = $interface->netmask([$newmask])
	   Get or set the interface's netmask.

       $addr = $interface->hwaddr([$newaddr])
	   Get or set the interface's hardware address.

       $addr = $interface->mtu([$newmtu])
	   Get or set the interface's MTU.

       $addr = $interface->metric([$newmetric])
	   Get or set the interface's metric.

       $flags = $interface->flags([$newflags])
	   Get or set the interface's flags. These can be ANDed with the IFF constants exported by IO::Interface or Net::Interface in order to
	   interrogate the state and capabilities of the interface. However, it is probably more convenient to use the broken-out methods listed
	   below.

       $flag = $interface->is_running([$newflag])
       $flag = $interface->is_broadcast([$newflag])
       $flag = $interface->is_pt2pt([$newflag])
       $flag = $interface->is_loopback([$newflag])
       $flag = $interface->is_promiscuous([$newflag])
       $flag = $interface->is_multicast([$newflag])
       $flag = $interface->is_notrailers([$newflag])
       $flag = $interface->is_noarp([$newflag])
	   Get or set the corresponding configuration parameters. Note that the operating system may not let you set some of these.

AUTHOR

       Lincoln Stein <lstein@cshl.org>

       This module is distributed under the same license as Perl itself.

SEE ALSO

       perl, IO::Socket, IO::Multicast), IO::Interface, Net::Interface

perl v5.14.2							    2007-01-22						    Interface::Simple(3pm)