Revert "Traduzido para o português."
authorThadeu Lima de Souza Cascardo <cascardo@holoscopio.com>
Mon, 7 Dec 2009 05:00:26 +0000 (03:00 -0200)
committerThadeu Lima de Souza Cascardo <cascardo@holoscopio.com>
Mon, 7 Dec 2009 05:00:26 +0000 (03:00 -0200)
This reverts commit 07e42265974da64efdb139647780b3f133590374.

02.a.posix/02.vfs.xml

index a1085c6..8056a1f 100644 (file)
@@ -9,26 +9,26 @@
 </slidesinfo>
 
 <foil>
-<title>Introdução</title>
+<title>Introduction</title>
 <para>
-Dispositivos em sistemas POSIX são arquivos no diretório /dev. Como quaisquer
-outros arquivos no POSIX, eles podem ser abertos, fechados, lidos, escritos,
-posicionados, controlados, entre outros.
+Devices in POSIX Systems are files in /dev directory. As with any files
+in POSIX, they may be opened, closed, read from, written to, seeked,
+ioctl'd, and others.
 </para>
 
 <para>
-Exemplos de arquivos de dispositivos:
+Examples of device files:
 </para>
 
 <itemizedlist>
 <listitem>
 <para>
-/dev/sda - Um dispositivo de bloco SCSI
+/dev/sda - A SCSI block device
 </para>
 </listitem>
 <listitem>
 <para>
-/dev/ttyS0 - Um dispositivo terminal serial
+/dev/ttyS0 - A Serial terminal device
 </para>
 </listitem>
 </itemizedlist>
@@ -36,11 +36,11 @@ Exemplos de arquivos de dispositivos:
 </foil>
 
 <foil>
-<title>Chamandas de Entrada e Saída em POSIX</title>
+<title>POSIX I/O calls</title>
 <para>
-Sistemas POSIX possuem algumas chamadas padrões para E/S. Já que dispositivos
-são arquivos, essas mesmas chamadas são utilizadas para trabalhar com
-dispositivos. Vamos trabalhar com as seguintes chamadas:
+POSIX systems have some standard calls for I/O. Since devices are files,
+these same system calls are used to work with devices. We are gonna work
+with the following calls:
 </para>
 <itemizedlist>
 <listitem><para>
@@ -67,19 +67,19 @@ ioctl
 <foil>
 <title>open</title>
 <para>
-A chamada de systema open abre um arquivo. Quando estivermos trabalhando com
-dispositivo, é quando alguma inicialização deve ser feita. Alguns dispositivos
-só podem ser abertos por um processo de cada vez.
+The open system call opens a file. When working with devices, that's
+when some initialization should be done. Some devices may be opened only
+once at a time.
 </para>
 <para>
 int open (char * filename, int flags);
 </para>
 <para>
-flags podem ser O\_RDONLY, O\_WRONLY, O\_RDWR e muitas outras, algumas menos
-importantes para dispositivos.
+flags may be O\_RDONLY, O\_WRONLY, O\_RDWR and many others, some not
+important for devices.
 </para>
 <para>
-Exemplo:
+Example:
 </para>
 <para>
 fd = open ("/dev/ttyS0", O\_RDWR);
@@ -89,13 +89,13 @@ fd = open ("/dev/ttyS0", O\_RDWR);
 <foil>
 <title>close</title>
 <para>
-A chamada de sistema close fecha um arquivo aberto.
+The close system call closes an open file.
 </para>
 <para>
 int close (int fd);
 </para>
 <para>
-Exemplo:
+Example:
 </para>
 <para>
 close (fd);
@@ -105,18 +105,18 @@ close (fd);
 <foil>
 <title>read</title>
 <para>
-A chamada de sistema read lê de um arquivo aberto para um buffer. Para
-dispositivos, ela lê de um dispositivo.
+The read system call reads data from an open file into a buffer. For
+devices, it reads from the device.
 </para>
 <para>
 int read (int fd, char *buffer, int bsz);
 </para>
 <para>
-read retorna o número de bytes escritos no buffer, que pode ser menor que o
-número de bytes requisitados por diferentes razões.
+Read returns the number of bytes written into the buffer, which may be
+less than the number of bytes requested for any number of reasons.
 </para>
 <para>
-Exemplo:
+Example:
 </para>
 <para>
 c = read (fd, buffer, sizeof (buffer));
@@ -126,18 +126,18 @@ c = read (fd, buffer, sizeof (buffer));
 <foil>
 <title>write</title>
 <para>
-A chamada de sistema write escreve dados de um buffer em um arquivo aberto. Para
-dispositivos, ela escreve no dispositivo.
+The write system call writes data to an open file from a buffer. For
+devices, it writes to the device.
 </para>
 <para>
 int write (int fd, char *buffer, int bsz);
 </para>
 <para>
-write retorna o número de bytes escritos no arquivo, que pode ser menor que o
-número de bytes requisitados por diferentes razões.
+Write returns the number of bytes written to the file, which may be
+less than the number of bytes requested for any number of reasons.
 </para>
 <para>
-Exemplo:
+Example:
 </para>
 <para>
 c = write (fd, buffer, strlen (buffer));
@@ -147,20 +147,20 @@ c = write (fd, buffer, strlen (buffer));
 <foil>
 <title>lseek</title>
 <para>
-A chamada de sistema lseek muda a posição corrente do arquivo, permitindo a
-leitura ou escrita naquela posição. Posicionar em um dispositivo pode ter
-diferentes significados.
+The lseek system call changes the current position of the file, allowing
+to read or write in that position. Seeking on a device may have many
+different meanings.
 </para>
 <para>
 off\_t lseek (int fd, off\_t pos, int whence);
 </para>
 <para>
-O significado da posição depende do valor de whence, que pode ser
-SEEK\_SET (a posição absoluta), SEEK\_CUR (relativa a posição corrente),
-SEEK\_END (relativa ao fim do arquivo).
+The meaning of the position depends on the value of whence, which can be
+SEEK\_SET (the absolute position), SEEK\_CUR (relative to the current
+position), SEEK\_END (relative to the end of the file).
 </para>
 <para>
-Exemplo:
+Example:
 </para>
 <para>
 lseek (fd, 0, SEEK\_END);
@@ -170,20 +170,20 @@ lseek (fd, 0, SEEK\_END);
 <foil>
 <title>ioctl</title>
 <para>
-A chamada de sistema ioctl é uma operação "pega-tudo". Para aquelas operações
-que não se encaixam no modelo leitura/escrita, ioctl permite ao usuário enviar
-um comando com um argumento opcional ao dispositivo. Esse comando pode aceitar
-entrada ou gerar saída.
+The ioctl system call is a catch-all operation. For those operations
+which doesn't fit in the read/write model, the ioctl allows the user to
+send a command with an optional argument to the device. This command may
+accept input or generate output.
 </para>
 <para>
 int ioctl (int fd, int request, char *arg);
 </para>
 <para>
-O último argumento é opcional e depende do tipo de requisição. Todo dispositivo
-ou classe de dispositivo pode ter seu diferente conjunto de ioctl's.
+The last argument is optional and depends on the type of request. Every
+device or device class may have its different set of ioctl's.
 </para>
 <para>
-Exemplo:
+Example:
 </para>
 <para>
 struct ifreq req; ioctl (fd, SIOCGIFFLAGS, \&#38;req);
@@ -191,33 +191,32 @@ struct ifreq req; ioctl (fd, SIOCGIFFLAGS, \&#38;req);
 </foil>
 
 <foil>
-<title>Módulos do Linux</title>
+<title>Linux Modules</title>
 <para>
-Linux é modularizado. Drivers, sistemas de arquivos, protocolos de rede e outros
-podem ser carregados em tempo de execução. Todo módulos tem uma função init e
-uma função exit.
+Linux is modularized. Drivers, filesystems, network protocols and others
+may be loaded at runtime. Every module has an init and an exit
+functions.
 </para>
 <para>
-Módulos podem ter parâmetros. Em tempo de carga, parâmetros, que podem ser
-booleanos, inteiros ou strings, são dados pelo usuário.
+Modules may have parameters. In load time, parameters, which may be
+boolean, integers or strings, are given by the user.
 </para>
 </foil>
 
 <foil>
-<title>Tipos e números de dispositivos</title>
+<title>Device types and numbers</title>
 <para>
-Dispositivos no Linux podem ter diferentes tipos, incluindo dispositivos de
-caractere, dispositivos de bloco e dispositivos de rede. Tanto dispositivos de
-caractere quanto de bloco têm números identificadores, um número maior e um
-número menor.
+Linux devices may be of different types, including character devices,
+block devices or network devices. Both character and block devices have
+identifying numbers, a major and a minor number.
 </para>
 </foil>
 
 <foil>
-<title>Alocação de dispositivos de caractere</title>
+<title>Character devices allocation</title>
 <para>
-No Linux, números maior e menor devem ser requisitados ou alocados. As chamadas
-para fazê-lo para os dispositivos de caractere são:
+In Linux, major and minor numbers have to be requested or allocated. The
+calls to do that for character devices are:
 </para>
 <para>
 int register\_chrdev\_region (dev\_t first, unsigned int count, char