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.