Welcome to Linux Knowledge Base and Tutorial
"The place where you learn linux"
UNICEF

 Create an AccountHome | Submit News | Your Account  

Tutorial Menu
Linux Tutorial Home
Table of Contents

· Introduction to Operating Systems
· Linux Basics
· Working with the System
· Shells and Utilities
· Editing Files
· Basic Administration
· The Operating System
· The X Windowing System
· The Computer Itself
· Networking
· System Monitoring
· Solving Problems
· Security
· Installing and Upgrading
· Linux and Windows

Glossary
MoreInfo
Man Pages
Linux Topics
Test Your Knowledge

Site Menu
Site Map
FAQ
Copyright Info
Terms of Use
Privacy Info
Disclaimer
WorkBoard
Thanks
Donations
Advertising
Masthead / Impressum
Your Account

Communication
Feedback
Forums
Private Messages
Surveys

Features
HOWTOs
News Archive
Submit News
Topics
User Articles
Web Links

Google
Google


The Web
linux-tutorial.info

Who's Online
There are currently, 186 guest(s) and 0 member(s) that are online.

You are an Anonymous user. You can register for free by clicking here

  

capiplugin




SYNOPSIS

       pppd [options] plugin capiplugin.so [options for  capiplu­
       gin]
       before pppd 2.4.1:
       pppd  [options]  plugin /usr/lib/pppd/<pppd-version>/capi­
       plugin.so [options for capiplugin]


DESCRIPTION

       The capiplugin provides a method to use PPP over ISDN with
       ISDN  controllers  that  provide a CAPI2.0 interface.  The
       plugin is responsible for the  call  setup  with  CAPI2.0.
       You  can dial out, wait for incoming calls and set up com­
       munication over leased lines. It implements a  feature  to
       reject  an  incoming  call  and callback. This feature can
       also be used when dialing out.  In this  case,  the  party
       called  has  to  reject the call and call back soon.  When
       using dial-on-demand it is possible let both parties setup
       the  connection,  that means while the pppd is in dial-on-
       demand mode not only an outgoing paket but also an  incom­
       ing  call  can trigger the connection setup. This can also
       combined with callback to assign the cost to one side only
       (COSO).


PPPD VERSIONS

       The  plugin  interface of the pppd is binary incompartible
       between different version of the pppd. So you need a  dif­
       ferent  capiplugin for every version of the pppd. The dif­
       ferent    plugins    will    be    in    the     directory
       /usr/lib/ppp/<pppd-version>.   Since  2.4.1 pppd checks if
       the version of the plugin matches and also search the plu­
       gins in these directories. With pppd versions before 2.4.1
       you need to specify the absolut pathname of the plugin.


HOW IT WORKS

       The capiplugin registers a new_phase_notifier and its  own
       options  to  the pppd when loaded. When the pppd goes into
       phase SERIALCONN, the capiplugin set up a  connection  and
       sets the global variable devnam.  The capiplugin will reg­
       ister a timer function that is called every second to han­
       dle  the  CAPI  messages while pppd is running.  To notify
       pppd when CAPI messages arrive, the CAPI file desciptor is
       added to the list of file descriptors which the pppd moni­
       tors for input.  Once the connection is set  up  the  pppd
       will start PPP negotiation on device devnam. When the pppd
       enters the DEAD phase, the connection will be dropped  (if
       it  is still active) When operating in dial-on-demand mode
       with wakeup on incoming calls, in phase DORMANT the plugin
              timeout, protocol and redialdelay.

       dial out with callback
              Call  a  given number, the called party rejects the
              call and then calls back.
              Required options: number and coso remote.
              Recommended options: cli and msn or inmsn.
              Other possible options:  cbwait,  controller,  con­
              nectdelay, dialtimeout, protocol

       dial out on demand
              Initiate  the  connection only on demand, i.e. when
              data traffic is present  and  drop  the  connection
              after a fix amount of idle time.
              Required options: number.
              Required pppd options: demand, connect, idle.
              Recommended options: msn.
              Other  possible options: controller, dialmax, dial­
              timeout, protocol and redialdelay.

       dial out on demand on an incoming phone call
              Initiate the connection only on demand,  i.e.  when
              data  traffic  is present or an incoming phone call
              is detected and drop the  connection  after  a  fix
              amount of idle time. This is usefull if you are not
              at home and ypou want your computer to make an con­
              nection to the internet.
              Required options: number and cli.
              Required options: number, voicecallwakeup and inmsn
              and/or cli.
              Required pppd options: demand, connect, idle.
              Recommended options: msn.  Other possible  options:
              controller,  dialmax,  dialtimeout, protocol, redi­
              aldelay and inmsn.

       wait for dial in
              Wait for calls and accept incoming calls.
              Recommended options: cli and msn or inmsn.
              Possible options: connectdelay,  controller,  dial­
              timeout, protocol

       wait for dial in and call back.
              Wait for calls, reject the call and then call back.
              Required options: cbnumber.
              Recommended options: cli and msn or inmsn.
              Other possible options: cbdelay, connectdelay, con­
              troller, dialtimeout, protocol

       dial on demand and also wait for dial in with COSO.
              Initiate  the  connection only on demand, i.e. when
              data traffic is present or when the other side dial
              in  and  drop  the connection after a fix amount of
              idle time. If option coso local is set,  pppd  will
              reject  an  incoming call from the remote party and
              will callback.  With the option  coso  remote  set,
              the  remote  party  should reject the incoming call
              and call back.
              Required options: number, inmsn  and/or  cli,  coso
              local or coso remote.
              Recommended options: cli and msn or inmsn.
              Other possible options: cbdelay, connectdelay, con­
              troller, dialtimeout, protocol

       leased line
              set up a leased line connection,  with  or  without
              CAPI channel bundling.
              Required   options:   channels.    Other   possible
              options:
              connectdelay, controller, dialtimeout and protocol


OPTIONS

       avmadsl
              make an DSL connection with the Fritz!Card DSL con­
              troller.   The  parameters  for  the DSL connection
              will be loaded from file /etc/drdsl/adsl.conf. This
              file  can  be edited or will be created by the pro­
              gram drdsl.

       cbdelay <seconds>
              Number of seconds to  wait  before  callback,  when
              acting  as  dial-in  server  with callback. Default
              value is 2 seconds.

       cbnumber <phone numbers>
              List of phone numbers for  callback,  separated  by
              commas,  when  acting  as dial-in server with call­
              back.

       cbwait <seconds>
              Time to wait for callback before giving up. Default
              value is 60 seconds.

       channels <channel specification>
              number  is  not set, wait for incoming call, reject
              the call and call back.  This option is optional if
              the cbnumber option is set.

       connectdelay <seconds>
              Number of seconds to wait after a connection is set
              up, before PPP negotiation starts. Default value is
              0  seconds.   This option is useful when connecting
              with protocol modem.  Some Internet access  servers
              will  hang up if they receive data immediatly after
              the connection is established.

       controller <controller specification>
              For point-to-multipoint <controller  specification>
              is  only the CAPI 2.0 controller number, default is
              1.  For point-to-point,  specify  <controller  num­
              ber>,<ddi>,<length of internal numbers>

       coso caller
              No  callback is done, the costs are assigned to the
              caller.

       coso local
              The costs are assigned to the local party.   On  an
              incoming  call  pppd will reject the call and call­
              back.

       coso remote
              The costs are assigned to the remote party.  On  an
              outcoming  call  the  remote  party will reject the
              call and callback.

       dialmax <times>
              Maximum number of times the list of  phone  numbers
              is tried before giving up.  Default value is 4.

       dialtimeout <seconds>
              Time  to  wait for the connection to be established
              or fail before giving up.  Default value is 60 sec­
              onds.

       inmsn <msn>
              List  of  phone numbers to monitor for calls, sepa­
              rated by commas.  If this option is  not  set,  the

       numberprefix <prefix>
              phone number to dial to access an outside line. For
              example, numberprefix 0.

       protocol  hdlc  |  x75  |  v42bis  |  modem  | v110async |
       v120async
              ISDN  protocol to use. With hdlc and adskpppoe, the
              sync option must be added to the pppd.   With  x75,
              v42bis,  modem,  v110async  and  v120async the sync
              option MUST NOT be enabled. Default value is  hdlc.
              Not  all  controllers  support  v42bis,  modem  and
              v120async.  Use capiinfo(8) to view which  features
              your controller supports.

       redialdelay <seconds>
              Number   of  seconds  to  wait  between  redialing.
              Default value is 5 seconds.

       voicewakeup
              With this option a incoming voicecall  can  trigger
              an outgoing connection setup.


EXAMPLE FOR NORMAL DIAL OUT

       Probably  the most common use of pppd is to dial out to an
       ISP.  This can be specified with a command like

              pppd call isp

       where the /etc/ppp/peers/isp file is set up by the  system
       administrator to resemble the following:

              sync
              noauth
              defaultroute
              name USERNAME
              plugin capiplugin.so ®msn MSN
              number PHONENUMBER
              protocol hdlc
              ipcp-accept-local
              ipcp-accept-remote
              /dev/null

       and    where    the    files    /etc/ppp/pap-secrets   and
       /etc/ppp/chap-secrets are set up by the system administra­
       tor to resemble the following:

              noauth
              defaultroute
              name USERNAME
              plugin capiplugin.so
              msn MSN
              number PHONENUMBER
              coso remote
              cli PHONENUMBER
              protocol hdlc
              ipcp-accept-local
              ipcp-accept-remote
              /dev/null

       and    where    the    files    /etc/ppp/pap-secrets   and
       /etc/ppp/chap-secrets are set up by the system administra­
       tor to resemble the following:
       USERNAME * PASSWORD *


EXAMPLE DIAL OUT ON DEMAND

       To  dial out on demand and drop the link after 120 seconds
       idle time on the link add this line  to  the  /etc/inittab
       file:

              isp:23:respawn:/usr/sbin/pppd  call isp demand con­
              nect "" idle 120

       where the /etc/ppp/peers/isp file is set up by the  system
       administrator to resemble the following:

              sync
              noauth
              defaultroute
              name USERNAME
              plugin capiplugin.so ®msn MSN
              number PHONENUMBER
              protocol hdlc
              ipcp-accept-local
              ipcp-accept-remote
              /dev/null

       and    where    the    files    /etc/ppp/pap-secrets   and
       /etc/ppp/chap-secrets are set up by the system administra­
       tor to resemble the following:

              USERNAME * PASSWORD *


EXAMPLE DIAL OUT ON DEMAND AND ON AN INCOMING PHONE CALL

       To  dial  out  on  demand or on an incoming phone call and
       drop the link after 120 seconds idle time on the link  add
       this line to the /etc/inittab file:
              cli VOICEPHONENUMBER
              voicecallwakeup
              protocol hdlc
              ipcp-accept-local
              ipcp-accept-remote
              /dev/null

       and    where    the    files    /etc/ppp/pap-secrets   and
       /etc/ppp/chap-secrets are set up by the system administra­
       tor to resemble the following:

              USERNAME * PASSWORD *


EXAMPLE DIAL OUT ON DEMAND AND ALSO ACCEPT AN INCOMING DATA CALL

       To dial out on demand or on an incoming data call and drop
       the link after 120 seconds idle time on the link add  this
       line to the /etc/inittab file:

              isp:23:respawn:/usr/sbin/pppd  call isp demand con­
              nect "" idle 120

       where the /etc/ppp/peers/isp file is set up by the  system
       administrator to resemble the following:

              sync
              noauth
              defaultroute
              name USERNAME
              plugin capiplugin.so
              msn MSN
              number PHONENUMBER
              inmsn MSN
              protocol hdlc
              ipcp-accept-local
              ipcp-accept-remote
              /dev/null

       and    where    the    files    /etc/ppp/pap-secrets   and
       /etc/ppp/chap-secrets are set up by the system administra­
       tor to resemble the following:

              USERNAME * PASSWORD *


EXAMPLE OF WAIT FOR DIAL IN WITHOUT CLI AUTHENTICATION

       Wait  for incoming calls, accept them according to options
       msn, inmsn, and protocol.

       Do not provide option cli to the capiplugin.  Start a pppd
       for  every  b channel.  Authorization is checked using PAP
       or CHAP and the ip numbers are assigned according  to  the
              plugin capiplugin.so
              inmsn MSN
              protocol hdlc 192.168.0.1:

       with the  files  /etc/ppp/pap-secrets  and  /etc/ppp/chap-
       secrets set up to resemble the following:

              user1 dialinserver PASSWORD1 192.168.0.2
              user2 dialinserver PASSWORD2 192.168.0.3


EXAMPLE OF WAIT FOR DIAL IN WITH CLI AUTHENTICATION

       Wait  for incoming calls, accept them according to options
       msn, inmsn, cli and protocol.

       Start a pppd for every client.  Assume that the server has
       ip  number  192.168.0.1 and the clients are to be assigned
       the ip numbers starting from 192.168.0.2.  Add these three
       lines to the /etc/inittab file:

              p0:23:respawn:/usr/sbin/pppd  call incoming-cli cli
              04711 192.168.0.1:192.168.0.2
              p1:23:respawn:/usr/sbin/pppd call incoming-cli  cli
              04712 192.168.0.1:192.168.0.3
              p2:23:respawn:/usr/sbin/pppd  call incoming-cli cli
              04713 192.168.0.1:192.168.0.4

       where the /etc/ppp/peers/incoming-cli file is  set  up  to
       resemble the following:

              sync
              noauth
              plugin capiplugin.so
              inmsn MSN
              protocol hdlc


EXAMPLE OF WAIT FOR DIAL IN WITH CLI AUTHENTICATION AND CALLBACK

       Wait  for incoming calls, accept them according to options
       msn, inmsn, cli and protocol, reject  incoming  calls  and
       call back.

       Start a pppd for every client.  Assume that the server has
       ip number 192.168.0.1 and the clients are to  be  assigned
       the ip numbers starting from 192.168.0.2.  Add these three
       lines to the /etc/inittab file.

              p0:23:respawn:/usr/sbin/pppd call incoming-cli  cli
              04711 cbnumber 4711 192.168.0.1:192.168.0.2
              p1:23:respawn:/usr/sbin/pppd  call incoming-cli cli
              04712 cbnumber 4712 192.168.0.1:192.168.0.3

       Assume that the server has ip number 192.168.0.1  and  the
       peer  has the ip number 192.168.0.2.  Add this line to the
       /etc/inittab file:

              p0:23:respawn:/usr/sbin/pppd call leased-hdlc  con­
              troller 1 channels 1 192.168.0.1:192.168.0.2

       where  the  /etc/ppp/peers/leased-hdlc  file  is set up to
       resemble the following:

              sync
              noauth
              lcp-echo-interval 5
              lcp-echo-failure 3
              lcp-max-configure 50
              lcp-max-terminate 2
              noccp
              noipx
              persist
              plugin capiplugin.so
              protocol hdlc


EXAMPLE OF A LEASED LINE CONNECTION WITH V42BIS

       Assume that the server has ip number 192.168.0.1  and  the
       peer  has the ip number 192.168.0.2.  Add this line to the
       /etc/inittab file for server 1 (192.168.0.1):

              p0:23:respawn:/usr/sbin/pppd   call   leased-v42bis
              controller 1 channels 1 192.168.0.1:192.168.0.2

       and  this  line  to  the  /etc/inittab  file  for server 1
       (192.168.0.2):

              p0:23:respawn:/usr/sbin/pppd   call   leased-v42bis
              controller 1 channels p1 192.168.0.2:192.168.0.1

       where  the  /etc/ppp/peers/leased-v42bis file is set up to
       resemble the following:

              sync
              noauth
              lcp-echo-interval 5
              lcp-echo-failure 3
              lcp-max-configure 50
              lcp-max-terminate 2
              noccp
              noipx
              persist
              plugin capiplugin.so
              protocol v42bis



DIAGNOSTICS

       Messages  are  sent to the syslog daemon just as in normal
       pppd operation; see the pppd manual page.


SEE ALSO

       pppd(8), capiinfo(8), capiinit(8), capictrl(8)


AUTHORS

       Carsten Paeth (calle@calle.in-berlin.de)
       AVM GmbH Berlin (info@avm.de)

                                                    CAPIPLUGIN(8)
  




Login
Nickname

Password

Security Code
Security Code
Type Security Code


Don't have an account yet? You can create one. As a registered user you have some advantages like theme manager, comments configuration and post comments with your name.

Help if you can!


Amazon Wish List

Did You Know?
You can choose larger fonts by selecting a different themes.


Friends



Tell a Friend About Us

Bookmark and Share



Web site powered by PHP-Nuke

Is this information useful? At the very least you can help by spreading the word to your favorite newsgroups, mailing lists and forums.
All logos and trademarks in this site are property of their respective owner. The comments are property of their posters. Articles are the property of their respective owners. Unless otherwise stated in the body of the article, article content (C) 1994-2013 by James Mohr. All rights reserved. The stylized page/paper, as well as the terms "The Linux Tutorial", "The Linux Server Tutorial", "The Linux Knowledge Base and Tutorial" and "The place where you learn Linux" are service marks of James Mohr. All rights reserved.
The Linux Knowledge Base and Tutorial may contain links to sites on the Internet, which are owned and operated by third parties. The Linux Tutorial is not responsible for the content of any such third-party site. By viewing/utilizing this web site, you have agreed to our disclaimer, terms of use and privacy policy. Use of automated download software ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and are therefore expressly prohibited. For more details on this, take a look here

PHP-Nuke Copyright © 2004 by Francisco Burzi. This is free software, and you may redistribute it under the GPL. PHP-Nuke comes with absolutely no warranty, for details, see the license.
Page Generation: 0.04 Seconds