Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
pump(8)
Edit
PageHistory
Diff
Info
LikePages
PUMP !!!PUMP NAME SYNOPSIS DESCRIPTION COMMAND-LINE OPTIONS LOGGING CONFIG FILE BUGS QUIBBLE ---- !!NAME pump - configure network interface via BOOTP or DHCP protocol !!SYNOPSIS /sbin/pump [[-krRsd?] [[-c ''ARG''] [[-h ''hostname''] [[-i ''iface''] [[-l ''hours''] [[--lookup-hostname] [[--usage] !!DESCRIPTION pump is a daemon that manages network interfaces that are controlled by either the DHCP or BOOTP protocol. While pump may be started manually, it is normally started automatically by the /sbin/ifup script for devices configured via BOOTP or DHCP. Once pump is managing an interface, you can run pump to query the status of that interface. For example, /sbin/pump -i eth0 --status will print the current status of device eth0. !!COMMAND-LINE OPTIONS !!LOGGING Pump logs a good deal of information to syslog, much of it at the DEBUG level. If you're having trouble, it's a good idea to turn up syslog's logging level. !!CONFIG FILE Pump supports a simple configuration file which lets you tune its behavior. By default, it looks at ''/etc/pump.conf'', though the __-c__ option lets you override that. The configuration file is line oriented, and most line contains a directive followed by zero or more arguments. Arguments are handled similar to how shells handle command arguments, allowing the use of quotes and backslash escapes. Comments are allowed, and must begin with a # character, and spaces and tabs are ignored. Directives may be specified at two levels, global and specific. Global directives change pump's behavior for all of the devices which it manages, while specific directives change pump's behavior for a single device. Later directives always override earlier ones. Here is an example /etc/pump.conf: # sample /etc/pump.conf file domainsearch This configuration file tells pump to use a specific DNS search path rather than deriving one from the DHCP or BOOTP server response, to retry each request 3 times (for a total of 4 tries), and not to change any DNS configuration when it's configuring the eth1 device. Here is a complete list of directives: __device__ ''device'' Specify specific directives for the indicated device. This directive must be followed by a {, and the list of specific directives must end with a } on its own line. These directives may not be nested. __domainsearch__ ''searchpath'' Rather then deriving the DNS search path (for /etc/resolv.conf), use the one which is given. As a machine only has a single DNS search path, this directive may only be used globally. __nonisdomain__ Don't set a new NIS domain. Normally __pump__ sets the system's NIS domain if an NIS domain is specified by the dhcp server and the current NIS domain is empty or __localdomain__. This directive may only be used within a __device__ directive. __nodns__ Don't create a new /etc/resolv.conf when this interface is configured. This directive may only be used within a __device__ directive. __nogateway__ Ignore any default gateway suggested by the DHCP server for this device. This can be usefull on machines with multiple ethernet cards. __retries__ ''count'' Retry each phase of the DHCP process ''count'' times. __timeout__ ''count'' Don't let any one step of the DHCP process take more then ''count'' seconds. __script__ ''executable-filename'' When events occur in negotiation with the server, calls the given executable or script. Scripts are called when a lease is granted, when a renewal is negotiated, and when the interface is brought down and the address released. The scripts are called with two or three arguments, depending on the condition, as documented in the table above. !!BUGS Probably limited to Ethernet, might work on PLIP, probably not ARCnet and Token Ring. The configuration file should let you do more things. Submit bug reports at the Bug Track link at http://developer.redhat.com/ !!QUIBBLE A pump, like a boot[[p], is something you wear on your foot. Some of us like the name (I know, hard to believe)! ----
One page links to
pump(8)
:
Man8p
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
