.\" -*- nroff -*-
.\" This man page is Copyright (C) 1998 Heiner Eisen. 
.\" Permission is granted to distribute possibly modified copies
.\" of this page provided the header is included verbatim,
.\" and in case of nontrivial modification author and date
.\" of the modification is added to the header.
.\" $Id: x25.7,v 1.1 2000/10/20 13:05:12 ricardo Exp $
.TH X25 7 "01/12/1998" "Linux Man Page" "Manual do Programador Linux" 
.SH NOME
x25, PF_X25 \- X.25 ITU-T / interface do protocolo ISO-8208. 

.SH SINOPSE
.B #include <sys/socket.h>
.br
.B #include <linux/x25.h>
.sp
.B x25_socket = socket(PF_X25, SOCK_SEQPACKET, 0); 

.SH DESCRIÇÃO
Os sockets X25 fornecem uma interface para o protocolo de camada de pacotes X.25.
Isto permite que aplicações se
comuniquem sobre uma rede pública X.25 como padronizada pela
recomendação X.25 da International Telecommunication Union
(X.25 modo DTE-DCE). Os sockets também podem ser usados para comunicação
sem uma rede X.25 intermediária (X.25 modo DTE-DTE) como descrito
na ISO-8208.
.PP
Limites de mensagens são preservados \- um 
.BR read (2) 
de um socket
recuperará a mesma quantidade de dados que o 
.BR write(2) 
correspondente para o socket do peer. Quando necessário, o kernel cuida
da segmentação e remontagem de mensagens longas através do significado do
bit M do X.25. Não há limite superior definido para o
tamanho da mensagem. Porém, a remontagem de uma mensagem longa pode falhar se
houver uma falta temporária de recursos no sistema, ou quando outras limitações
(como limites de memória de sockets ou tamanho de buffer) tornam-se efetivos.
Se isso ocorrer, a conexão X.25 será resetada.
.SH ENDEREÇOS DE SOCKET 
A família de endereços de socket 
.B AF_X25 
usa o 
.B struct sockaddr_x25
para representar endereços de rede, como definido na
recomendação X.121 da ITU-T. 
.PP
.RS
.nf
.ta 4n 18n 32n
struct sockaddr_x25 {
	sa_family_t	sx25_family;	/* deve ser AF_X25 */
	x25_address	sx25_addr;	/* Endereço X.121 */
};
.ta
.fi
.RE
.PP
.I sx25_addr
contém uma matriz de caracteres
.I x25_addr[] 
a ser interpretada como uma string terminada em caractere nulo.
.I sx25_addr.x25_addr[]
consiste de até 15 (não incluindo o 0 terminal) caracteres
ASCII formando o endereço X.121.
Somente os dígitos decimais de '0' a '9' são permitidos.
.SH OPÇÕES DE SOCKET 
As seguintes opções de socket específicas do X.25 podem ser setadas usando-se
.BR setsockopt (2)
e lidas com
.BR getsockopt (2)
com o parâmetro de nível setado em
.BR SOL_X25 .
.TP
.B X25_QBITINCL
Controla se o bit Q do X.25 (Bit de Dados Qualificados) é acessível pelo
usuário. Ele espera um argumento inteiro. Se ele for setado em 0 (padrão),
o bit Q nunca é setado para pacotes de saída, e o bit Q dos
pacotes de entrada é ignorado. Se for setado em 1, um primeiro byte adicional precederá
cada mensagem lida ou escrita no socket. Para dados lidos do
socket, o primeiro byte 0 indica que os bits Q dos pacotes de dados
de entrada correspondentes não foram setados. Um byte com valor 1 indica
que o bit Q dos pacotes de dados de entrada correspondentes foram setados.
Se o primeiro byte dos dados escritos no socket é 1, o bit Q dos pacotes
de dados de saída correspondentes serão setados. Se o primeiro bit é 0,
o bit Q não será setado.
.SH PROBLEMAS
Muitos, pois a implementação do PLP do X.25 é 
.BR CONFIG_EXPERIMENTAL .
.PP
Esta página de manual está incompleta.
.PP
Ainda não há nenhum arquivo-cabeçalho de programador dedicado à
aplicação; você precisa incluir o arquivo-cabeçalho do kernel
.BR <linux/x25.h> .
.B CONFIG_EXPERIMENTAL 
também pode implicar que versões futuras da interface não serão
compatíveis com o binário.
.PP
Os eventos N-Reset do X.25 ainda não são propagados para o processo do usuário. Portanto,
se ocorreu um erro, os dados podem ser perdidos sem notificação.
.SH "VEJA TAMBÉM"
.BR socket (7),
.BR socket (2).
.PP
Jonathan Simon Naylor: 
\(lqA Re-Análise e Re-Implementação do X.25.\(rq
A URL é
.I ftp://ftp.pspt.fi/pub/ham/linux/ax25/x25doc.tgz
.SH VERSÕES
A família de protocolo PF_X25 é uma nova implementação do Linux 2.2.
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWRubens de Jesus Nogueira <darkseid99@usa.net> (tradução)\fR
\&\fR\&\f(CWAndré L. Fassone Canova <lonelywolf@blv.com.br> (revisão)\fR