.\" -*- coding: UTF-8 -*- .\" This man page is Copyright (C) 1998 Alan Cox. .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" $Id: ddp.7,v 1.3 1999/05/13 11:33:22 freitag Exp $ .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ddp 7 "26 Mayo 2023" "Páginas de manual de Linux 6.05.01" .SH NOMBRE ddp \- Implementanción de Linux del protocolo AppleTalk .SH SINOPSIS .nf \fB#include \fP \fB#include \fP .PP \fIddp_socket\fP\fB = socket(AF_APPLETALK, SOCK_DGRAM, 0);\fP \fIraw_socket\fP\fB = socket(AF_APPLETALK, SOCK_RAW, \fP\fIprotocol\fP\fB);\fP .fi .SH DESCRIPCIÓN Linux implementa el protocolo AppleTalk descrito en \fIInside AppleTalk\fP. Únicamente la capa DDP y el AARP se encuentran dentro del núcleo. Están diseñados para ser usados mediante las bibliotecas \fBnetatalk\fP del protocolo. Esta página documenta la interfaz para aquellos que desean o necesitan usar la capa DDP directamente. .PP La comunicación entre AppleTalk y el programa de usuario funciona usando una interfaz de conectores compatible con BSD. Para más información sobre conectores, vea \fBsocket\fP(7). .PP Un conector Appletalk se crea llamando a la función \fBsocket\fP(2) y pasando \fBAF_APPLETALK\fP como familia del conector. Los tipos de conectores válidos son \fBSOCK_DGRAM\fP para abrir un conector \fBddp\fP o \fBSOCK_RAW\fP para abrir un conector \fBraw\fP (directo). \fIprotocol\fP es el protocolo AppleTalk a ser recibido o enviado. Para \fBSOCK_RAW\fP debe especificar \fBATPROTO_DDP\fP. .PP Los conectores directos sólo pueden ser abiertos por un proceso cuyo identificador de usuario efectivo sea 0 o por un proceso que posea la capacidad \fBCAP_NET_RAW\fP. .SS "Formato de las direcciones" La dirección de un conector AppleTalk se define como la combinación de un número de red, un número de nodo y un número de puerto. .PP .in +4n .EX struct at_addr { unsigned short s_net; unsigned char s_node; }; \& struct sockaddr_atalk { sa_family_t sat_family; /* familia de direcciones */ unsigned char sat_port; /* port */ struct at_addr sat_addr; /* red/nodo */ }; .EE .in .PP .\" FIXME . this doesn't make sense [johnl] A \fIsat_family\fP siempre se le asigna el valor \fBAF_APPLETALK\fP. \fIsat_port\fP contiene el puerto. Los números de puerto por debajo de 129 se conocen como \fIpuertos reservados\fP. Sólo los procesos con identificador de usuario efectivo 0 o con la capacidad \fBCAP_NET_BIND_SERVICE\fP pueden enlazar estos conectores mediante \fBbind\fP(2). \fIsat_addr\fP es la dirección del anfitrión (host). El miembro \fInet\fP de \fIstruct at_addr\fP contiene la red del anfitrión expresada en el formato "orden de red" de los bytes. El valor \fBAT_ANYNET\fP es un comodín y también implica \[lq]esta red\[rq]. El miembro \fInode\fP de \fIstruct at_addr\fP contiene el número de nodo del anfitrión. El valor \fBAT_ANYNODE\fP es un comodín y también implica \[lq]este nodo\[rq]. El valor de \fBATADDR_BCAST\fP es la dirección de enlace de difusión local. .SS "Opciones de los conectores" No se soportan opciones de conector específicas del protocolo. .SS "Interfaces /proc" IP soporta un conjunto de interfaces \fI/proc\fP para configurar algunos parámetros AppleTalk globales. Se puede acceder a ellos leyendo o escribiendo los ficheros del directorio \fB/proc/sys/net/atalk\fP. .TP \fIaarp\-expiry\-time\fP El intervalo de tiempo (en segundos) antes de que una entrada de la cache AARP expire. .TP \fIaarp\-resolve\-time\fP El intervalo de tiempo (en segundos) antes de que se resuelva una entrada de la cache AARP. .TP \fIaarp\-retransmit\-limit\fP El número de retransmisiones de una entrada AARP antes de que el nodo sea declarado muerto. .TP \fIaarp\-tick\-time\fP La frecuencia del cronómetro (en segundos) para el cronómetro que controla el AARP. .PP Los valores por defecto coinciden con la especificación y nunca debe ser necesario el cambiarlos. .SS Ioctls .\" FIXME . Add a section about multicasting Todas las ioctls descritas en \fBsocket\fP(7) se aplican también a DDP. .SH ERRORES .TP \fBEACCES\fP El usuario ha intentado ejecutar una operación sin los permisos necesarios. Estos incluyen el enviar a una dirección de difusión sin haber activado la opción de difusión e intentar el enlace a un puerto reservado sin un identificador de usuario efectivo 0 y sin \fBCAP_NET_BIND_SERVICE\fP. .TP \fBEADDRINUSE\fP Se ha intentado el enlace a una dirección ya en uso. .TP \fBEADDRNOTAVAIL\fP Se ha solicitado una interfaz inexistente o la dirección fuente solicitada no es local. .TP \fBEAGAIN\fP La operación se bloquearía sobre un conector bloqueante. .TP \fBEALREADY\fP Ya se está realizando una operación de conexión sobre un conector no bloqueante. .TP \fBECONNABORTED\fP Se ha cerrado la conexión durante un \fBaccept\fP(2). .TP \fBEHOSTUNREACH\fP No existe una entrada en la tabla de enrutamiento que coincida con la dirección de destino. .TP \fBEINVAL\fP Se ha pasado un argumento inválido. .TP \fBEISCONN\fP Se ha llamado a \fBconnect\fP(2) sobre un conector ya conectado. .TP \fBEMSGSIZE\fP El datagrama es mayor que la MTU de DDP. .TP \fBENODEV\fP El dispositivo de red no está disponible o es incapaz de enviar IP. .TP \fBENOENT\fP Se ha llamado a \fBSIOCGSTAMP\fP sobre un conector en donde no han llegado paquetes. .TP \fBENOMEM\fP y \fBENOBUFS\fP No hay suficiente memoria disponible. .TP \fBENOPKG\fP No se ha configurado un subsistema del núcleo. .TP \fBENOPROTOOPT\fP y \fBEOPNOTSUPP\fP Se han pasado opciones de conector inválidas. .TP \fBENOTCONN\fP La operación solo está definida en un conector conectado pero el conector no está conectado. .TP \fBEPERM\fP El usuario no tiene permiso para establecer una prioridad más alta, hacer un cambio a la configuración o enviar señales al proceso o grupo solicitado. .TP \fBEPIPE\fP La conexión ha sido cerrada o cancelada por el otro extremo. .TP \fBESOCKTNOSUPPORT\fP El conector está sin configurar o se ha solicitado un tipo de conector desconocido. .SH VERSIONES El soporte para Appletalk está incluido a partir de la versión 2.0 de Linux. La interfaz \fI/proc\fP existe desde la versión 2.2 de Linux. .SH NOTAS Tenga cuidado con la opción \fBSO_BROADCAST\fP; no es privilegiada en Linux. Es fácil sobrecargar la red sin darse cuenta enviando a la direcciones de difusión. .SS Compatibilidad La interfaz básica de conectores AppleTalk es compatible con \fBnetatalk\fP en los sistemas derivados de BSD. Muchos sistemas BSD fallan al comprobar \fBSO_BROADCAST\fP cuando se envían tramas de difusión. Esto puede conducir a problemas de compatibilidad. .PP El modo de conector directo es único de Linux y existe para soportar más fácilmente el paquete alternativo CAP y las herramientas de monitorización de AppleTalk. .SH ERRORES Hay demasiados valores de error inconsistentes. .PP Las ioctls usadas para configurar las tablas de enrutamiento, dispositivos, tablas AARP y otros dispositivos no se han descrito todavía. .SH "VÉASE TAMBIÉN" \fBrecvmsg\fP(2), \fBsendmsg\fP(2), \fBcapabilities\fP(7), \fBsocket\fP(7) .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Juan Piernas y Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .