Using catalogs: /etc/sgml/catalog Using stylesheet: /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl#html Working on: /home/jdavila/lucas/doc-manual-linux-wan/doc-manual-linux-wan.xml Gu�a de Programaci�n de PPP S�ncrono y Cisco HDLC

Gu�a de Programaci�n de PPP S�ncrono y Cisco HDLC

Alan Cox


Tabla de contenidos
1. Introducci�n
2. Bugs Conocidos y Suposiciones
3. Funciones P�blicas Suministradas
sppp_input --  recibe y procesa un frame PPP WAN
sppp_close --  cierra un enlace del HDLC de Cisco o de PPP s�ncrono
sppp_open --  abre un enlace del HDLC de Cisco o PPP s�ncrono
sppp_reopen --  notificaci�n de p�rdida de enlace f�sico
sppp_change_mtu --  Cambia el MTU del enlace
sppp_do_ioctl --  Manejador Ioctl para ppp/hdlc
sppp_attach --  vincula el PPP/HDLC s�ncrono a un dispositivo
sppp_detach --  libera los recursos PPP de un dispositivo
4. Sobre la Traducci�n

Cap�tulo 1. Introducci�n

Los controladores syncppp en Linux suministran una implementaci�n bastante completa del HDLC de Cisco y una m�nima implementaci�n de PPP. La meta �ltima es cambiar la capa PPP a la interface gen�rica PPP que es nueva en Linux 2.3.x. La API deber�a de permanecer sin cambios cuando esto haya sido realizado, pero el soporte estar� entonces disponible para IPX, compresi�n y otras caracter�sticas de PPP.


Cap�tulo 2. Bugs Conocidos y Suposiciones


Cap�tulo 3. Funciones P�blicas Suministradas

sppp_input

Nombre

sppp_input --  recibe y procesa un frame PPP WAN

Argumentos

dev

El dispositivo en el que ha llegado

skb

El buffer a procesar

Descripci�n

Puede ser llamado directamente por tarjetas que no tienen restricciones de tiempo, pero normalmente es llamado desde la capa de red despu�s de servir la interrupci�n para procesar frames encolados a trav�s de netif_rx.

Procesamos las opciones en la tarjeta. Si el frame est� destinado para la pila de protocolos entonces reencola el frame al nivel superior del protocolo. Si es un control para �l, entonces es procesado y descargado aqu�.

sppp_close

Nombre

sppp_close --  cierra un enlace del HDLC de Cisco o de PPP s�ncrono

Argumentos

dev

El dispositivo de red de donde tirar el enlace

Descripci�n

Tira la interface l�gica al canal. No es realizado de forma educada ya que asumimos que tambi�n estaremos tirando el DTR. Cualesquiera timeouts pendientes son eliminados.

sppp_open

Nombre

sppp_open --  abre un enlace del HDLC de Cisco o PPP s�ncrono

Argumentos

dev

Dispositivo de red a activar

Descripci�n

Cierra cualquier sesi�n s�ncrona existente y comienza desde el principio. En el caso de PPP esto significa el negociado de LCP/IPCP y compa��a, mientras que para el HDLC de Cisco simplemente necesitamos comenzar a enviar keepalives

sppp_reopen

Nombre

sppp_reopen --  notificaci�n de p�rdida de enlace f�sico

Argumentos

dev

Dispositivo que perdi� el enlace

Descripci�n

Esta funci�n informa al c�digo del protocolo s�ncrono que el enlace subyacente muri� (por ejemplo se tir� el transporte en X.21)

Incrementamos los n�meros m�gicos para asegurarnos de que si el otro extremo fall� en la notificaci�n empezaremos de forma correcta una nueva sesi�n. Esto sucede debido a la naturaleza de los dispositivos de telecomunicaciones en los que puedes perder el transporte en un s�lo extremo.

Habiendo realizado esto volvemos a la negociaci�n. Esta funci�n quiz�s sea llamada desde un contexto de interrupciones.

sppp_change_mtu

Nombre

sppp_change_mtu --  Cambia el MTU del enlace

Argumentos

dev

Dispositivo en el cual cambiamos el MTU

new_mtu

Nuevo MTU

Descripci�n

Cambia el MTU en el enlace. Esto s�lo puede ser llamado con el enlace ca�do. Devuelve un error si el enlace est� activo o si el mtu est� fuera de rango.

sppp_do_ioctl

Nombre

sppp_do_ioctl --  Manejador Ioctl para ppp/hdlc

Argumentos

dev

Dispositivo en el cual se realizar� la operaci�n ioctl

ifr

Bloque de petici�n de la interface del usuario

cmd

Comando que est� siendo emitido

Descripci�n

Esta funci�n maneja las ioctls que quiz�s sean emitidas por el usuario para controlar los par�metros de un enlace PPP/HDLC. Realiza chequeos de seguridad y de si est� ocupado. Esta funci�n est� dise�ada para ser envolvida por llamantes que desean a�adir llamadas ioctls adicionales.

sppp_attach

Nombre

sppp_attach --  vincula el PPP/HDLC s�ncrono a un dispositivo

Argumentos

pd

Dispositivo PPP a inicializar

Descripci�n

Inicializa el soporte PPP/HDLC en una interfaz. En el momento de llamada el elemento dev debe de apuntar al dispositivo de red al cual est� enlazado esta interfaz. La interfaz a�n no deber�a de estar registrada.

sppp_detach

Nombre

sppp_detach --  libera los recursos PPP de un dispositivo

Argumentos

dev

Dispositivo de red a liberar

Descripci�n

Para y libera cualesquiera recursos PPP/HDLC usados por esta interfaz. Debe de ser llamado antes de que el dispositivo sea liberado.


Cap�tulo 4. Sobre la Traducci�n

Este documento es la traducci�n de "Synchronous PPP and Cisco HDLC Programming Guide", documento que acompa�a al c�digo del n�cleo de Linux, versi�n 2.4.18.

Este documento ha sido traducido por Rub�n Melc�n ; y es publicado por el Proyecto Lucas

Versi�n de la traduci�n 0.04 ( Julio de 2002 ).

Si tienes comentarios sobre la traducci�n, ponte en contacto con Rub�n Melc�n

Done.