Return to mpd5.8.in CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / mpd / doc

Annotation of embedaddon/mpd/doc/mpd5.8.in, revision 1.1.1.2

1.1       misho       1: .\"
                      2: .\" Written by Archie Cobbs <archie@freebsd.org>
                      3: .\" Copyright (c) 1995-1999 Whistle Communications, Inc. All rights reserved.
                      4: .\" See ``COPYRIGHT.whistle''
                      5: .\"
1.1.1.2 ! misho       6: .Dd 2013-06-11
1.1       misho       7: .Dt MPD5 8
                      8: .Os
                      9: .Sh NAME
                     10: .Nm mpd5
                     11: .Nd netgraph multi-link PPP daemon
                     12: .Sh SYNOPSIS
                     13: .Nm
                     14: .Op Fl bkov
                     15: .Op Fl d Ar directory
                     16: .Op Fl f Ar file
                     17: .Op Fl p Ar pid-file
                     18: .Op Fl s Ar ident
1.1.1.2 ! misho      19: .Op Fl m Ar service
1.1       misho      20: .Op Ar configuration
                     21: .Sh DESCRIPTION
                     22: .Nm
                     23: is a user mode PPP daemon using the
                     24: .Xr netgraph 4
                     25: networking system.
                     26: By using Netgraph,
                     27: .Nm
                     28: combines the robustness and flexibility of a user-mode PPP implementation
                     29: with the speed and reliability of kernel-mode packet forwarding.
                     30: All PPP negotiation is handled in user level code, while all data
                     31: intensive operations such as encryption, compression, and multi-link
                     32: framing are handled strictly in the kernel.
                     33: Mpd supports several link layer types, a fully event-driven modem chat
                     34: scripting language, and other features.
                     35: .Pp
                     36: .Nm
                     37: creates a
                     38: .Xr ng_ppp 4
                     39: netgraph node that is placed between a
                     40: .Xr ng_iface 4
                     41: netgraph interface one or more link layer devices,
                     42: performing multi-link PPP negotiation and encapsulation. In multi-link PPP a
                     43: .Ar bundle
                     44: is a collection of one or more
                     45: .Ar links 
                     46: between two peers. Each link corresponds to some device (e.g.,
                     47: a modem), and each bundle corresponds to one netgraph interface.
                     48: The idea is to use all of the links, together connected to a remote
                     49: peer also performing multi-link PPP, to utilize their combined
                     50: bandwidth.  Packets routed through the netgraph interface travel in
                     51: multi-link fragments over all of the links.
                     52: Each link is a normal PPP link and can deliver complete packets
                     53: as well, so redundancy is another benefit.
                     54: Attempts to connect two links in the same bundle to different peers,
                     55: or to a peer that is not configured for multi-link PPP, will fail.
                     56: .Pp
                     57: In general, everything is controlled by executing commands which are either
                     58: entered via the console command line or read from a configuration file. If
                     59: .Nm
                     60: is running as a background daemon, the console can be made accessible via
                     61: .Xr telnet 1
                     62: Since commands may apply to a single link, the console prompt always shows the
                     63: .Ar current bundle
                     64: or the
                     65: .Ar current link
                     66: in that bundle. 
                     67: .Sh ON-LINE MANUAL
                     68: Mpd is fully documented in the mpd manual, which is available in HTML.
                     69: The manual can be found in the directory
                     70: .Pa @PREFIX@/share/doc/mpd5 .
                     71: .Sh OPTIONS
                     72: Mpd supports the following command options:
                     73: .Pp
                     74: .Bl -tag -width Ds -compact
                     75: .Pp
                     76: .It Fl b
                     77: .It Fl -background
                     78: .Pp
                     79: Detach from the terminal and run as a background deamon.
                     80: .Pp
                     81: .It Fl d Ar dirname
                     82: .It Fl -directory Ar dirname
                     83: .Pp
                     84: Specify a configuration directory other than the default,
                     85: .Pa @PREFIX@/etc/mpd5 .
                     86: .Pp
                     87: .It Fl f Ar file
                     88: .It Fl -file Ar file
                     89: .Pp
                     90: Specify an initial configuration file other than the default,
                     91: .Pa mpd.conf .
                     92: .Pp
                     93: .It Fl o
                     94: .It Fl -one-shot
                     95: .Pp
                     96: Terminate daemon after the last link shutdown.
                     97: .Pp
                     98: .It Fl p Ar file
                     99: .It Fl -pidfile Ar file
                    100: .Pp
                    101: Specify an lock/process ID storage file other than the default
                    102: .Pa /var/run/mpd.pid .
                    103: .Pp
                    104: .It Fl k
                    105: .It Fl -kill
                    106: .Pp
                    107: Kill any existing
                    108: .Nm
                    109: daemon currently running. The same pidfile must be used.
                    110: .Pp
                    111: .It Fl s Ar ident
                    112: .It Fl -syslog-ident Ar ident
                    113: .Pp
                    114: Identifier to use for
                    115: .Xr syslog 3 .
1.1.1.2 ! misho     116: The default -
        !           117: .Pa mpd
        !           118: .Pp
        !           119: .It Fl m Ar service
        !           120: .It Fl -pam-service Ar service
        !           121: .Pp
        !           122: Service name to use for
        !           123: .Xr pam 3 .
        !           124: The default -
        !           125: .Pa mpd
1.1       misho     126: .Pp
                    127: .It Fl v
                    128: .It Fl -version
                    129: .Pp
                    130: Display the program version and exit.
                    131: .Pp
                    132: .It Fl h
                    133: .It Fl -help
                    134: .Pp
                    135: Display invocation usage and exit.
                    136: .El
                    137: .Sh FILES
                    138: .Bl -tag -width /usr/local/share/doc/mpdXX -compact
                    139: .It Pa @PREFIX@/share/doc/mpd5
                    140: Directory containing the mpd manual
                    141: .It Pa @PREFIX@/etc/mpd5
                    142: Default configuration file directory
                    143: .It Pa mpd.conf
                    144: Configuration file
                    145: .It Pa mpd.script
                    146: Modem chat scripts
                    147: .It Pa mpd.secret
                    148: Account name, password pairs
                    149: .It Pa /var/run/mpd.pid
                    150: Stored process ID and lock file
                    151: .El
                    152: .Sh SEE ALSO
                    153: .Xr netgraph 4 ,
                    154: .Xr ngctl 8 ,
                    155: .Xr ng_ppp 4 ,
                    156: .Xr ng_iface 4 ,
1.1.1.2 ! misho     157: .Xr ppp 8 .
1.1       misho     158: .Sh AUTHORS
                    159: .An Archie Cobbs Aq archie@FreeBSD.org
                    160: .An Alexander Motin Aq mav@FreeBSD.org
                    161: .An based on ppp daemon written by Toshiharu OHNO Aq tony-o@iij.ad.jp