# O Manual do &kpf;

## Introdução

O &kpf; oferece a partilha simples de ficheiros usando o &HTTP; (o Hyper Text Transfer Protocol) que é o mesmo protocolo usado pelos 'sites' Web para fornecer dados ao seu navegador Web. O &kpf; é estritamente um servidor de ficheiros público, o que significa que não existem restrições de acesso aos ficheiros partilhados. O que quer que seleccione para partilhar fica disponível para todos.

O &kpf; está desenhado para ser usado para partilhar ficheiros com amigos, não para actuar como um servidor Web completo como o Apache. O &kpf; foi concebido em primeiro lugar como uma forma simples de partilhar os ficheiros com os amigos enquanto se conversa no IRC (Internet Relay Chat, ou em salas de conversação.)

Utilização típica: o &kpf; está configurado para servir os ficheiros da pasta `public_html` da sua pasta pessoal. Você deseja tornar um ficheiro disponível para algumas pessoas que estão a falar consigo 'online'. Em vez de lhes enviar um e-mail com o ficheiro em anexo (alguns até poderão nem estar interessados), você copia o ficheiro para a sua pasta `public_html` e anunciar a eles que o seu ficheiro está disponível em http://www.a-minha-maquina.net:8001/o_ficheiro.

## Utilizar o &kpf;

### Básico do &kpf;

O &kpf; corre como uma 'applet' dentro do &kicker;. Isto significa que ele ocupa muito pouco espaço do seu ecrã e que o seu estado é sempre visível. Para iniciar a 'applet' do &kpf; applet, carregue com o botão direito no &kicker; e escolha Adicionar 'Applet'Servidor Público de Ficheiros.

O &kpf; aplica o conceito de pastas partilhadas. Você poderá escolher uma ou mais pastas para tornar públicas, para que todos os ficheiros dessas pastas (e as respectivas subpastas) fiquem partilhados.

Por favor seja extremamente cauteloso com as pastas que partilha. Lembre-se que todos os ficheiros e subpastas da pasta indicada, incluindo os ficheiros escondidos (os que começam por um ponto, tecnicamente) ficarão disponíveis para toda a gente, por isso tenha cuidado em não partilhar informação importante, como senhas, chaves de cifra, o seu livro de endereços, documentos privados para a sua organização, &etc;.

Logo que o &kpf; esteja a correr, você irá ver uma 'applet' quadrada com um relevo afundado que mostra um balão de ar quente. O balão está visível quando não existirem pastas a ser partilhadas.

Para partilhar uma pasta, carregue com o botão direito no ícone do balão para que apareça um menu que contém apenas um item, o Novo Servidor.... Se seleccionar este item fará com que apareça um assistente, o qual lhe irá perguntar algumas questões simples. Se completar as perguntas terá uma pasta para partilhar.

Existe uma alternativa para usar a 'applet' directamente quando desejar partilhar uma pasta. O &kpf; está integrado com o &konqueror;.

Com o &konqueror; aberto e a mostrar uma pasta, carregue com o botão direito no fundo e faça aparecer a janela de Propriedades. Na instalação, o &kpf; adicionou uma página de Partilha a esta janela. Você terá a opção de iniciar o &kpf;, se não estiver já em execução. Se escolher Ok irá notificar a 'applet' do &kpf;, pedindo-lhe para adicionar uma nova partilha.

## Configuração da partilha

### Porto de espera

Para cada pasta partilhada pelo &kpf;, é aberto um novo porto de rede. Um porto é apenas um número que é usado para identificar univocamente um serviço da rede. Quando alguém usa um programa (⪚ um navegador Web) para se ligar a uma máquina, é direccionado para o serviço se indicar o endereço da máquina e o porto no qual o serviço está a correr.

O conceito do porto permite a uma máquina correr mais do que um serviço de rede. Os serviços que você poderá usar todos os dias incluem o &HTTP; (a Web,) normalmente ligado ao porto 80, o SMTP (para o envio de correio), normalmente no porto 25, e o POP3 (recepção de correio), o qual está normalmente no porto 110.

Normalmente, quando você se liga a um servidor de rede, você não precisa de indicar a que porto se deseja ligar. Isto acontece porque os portos estão normalizados, por isso toda a gente que se liga ao porto 80 de uma máquina da rede está à espera de encontrar um servidor de &HTTP; (Web).

O &kpf; não é um serviço padrão, por isso o 8001 foi escolhido como sendo o porto por omissão.

A segunda pasta que você partilhar irá estar à espera de pedidos no porto 8002, com o número a incrementar-se de cada vez que você inicia uma nova partilha.

Dentro de certos limites, você tem a liberdade de escolher qual o número de porto que deseja para uma partilha.

É normal os números de portos abaixo de 1000 estarem reservados para os serviços do sistema, &ie; aqueles que se encontram sob o controlo do administrador da máquina, como tal, você poderá chegar à conclusão que, se tentar algo abaixo de 1000, não irá resultar.

O &kpf; tenta avisá-lo sempre que não conseguir atender pedidos num dado porto. Ele faz isto mostrando um ícone de ligação quebrada por cma do canto superior esquerdo do gráfico. O &kpf; tentá-lo-á impedir de atribuir mais do que uma partilha para o mesmo porto, mas não o impedirá de definir uma partilha para atender os pedidos num porto que já esteja ocupado por outro serviço, como por exemplo o seu servidor Web real.

Se você vir o ícone de ligação quebrada, carregue com o botão direito no gráfico da largura de banda e escolha Configurar... Agora, tente alterar o porto de atendimento e carregue em Ok. Assumindo que, desta vez, você escolheu um porto livre, você deverá ver que o ícone da ligação quebrada desapareceu e que deverá ser capaz de se ligar à partilha.

### Limite de largura de banda

O termo largura de banda refere-se à quantidade de dados que poderão ser transmitidos através de uma dada ligação durante um período de tempo. Os técnicos poderão estar fartos de ouvir que o seu canal está atestado. A analogia é apta.

O &kpf; permite-lhe definir um limite da largura de banda que será usada por uma dada partilha. Isto é útil se você quiser evitar que a sua ligação de rede fique saturada pelas pessoas a transferir coisas das suas partilhas. Se você estiver num modem, por exemplo, você só terá alguns quilobytes por segundo para si. Se limitar a largura de banda usada pelas suas partilhas do &kpf;, poderá manter uma parte da largura de banda para o seu uso pessoal.

Tal como foi dito, o &kpf; mede a largura de banda em quilobytes por segundo, ou kB/s para abreviar. Um modem típico transfere cerca de 5kB/s em média, por isso limitar o uso total de todas as partilhas do &kpf; para um valor inferior a este será inteligente, dependendo do modo como você está a usar o &kpf;.

### Seguir as ligações simbólicas

Uma ligação simbólica é um ficheiro especial que faz referência a outro ficheiro (ou pasta) do seu sistema de ficheiros. Se seguir a ligação, você acede ao ficheiro ou à pasta em questão - a ligação é normalmente transparente.

Por omissão, uma partilha do &kpf; não permite o seguimento de ligações simbólicas. Isto significa que, por exemplo, se você tiver uma partilha a apontar para `/a/sua/pasta/pessoal/public_html` e tiver uma ligação dentro de `public_html` que aponte para a `/tmp`, então toda a gente que peça a `/tmp` irá ver o conteúdo da sua pasta `/tmp`.

De um modo geral, é uma má ideia permitir o seguimento de ligações simbólicas desta forma. A razão principal pela qual isto é permitido é que você poderá ter ligações simbólicas dentro da pasta partilhada que apontem para outro local dentro da pasta partilhada. Isto poderá ser útil se você estiver a servir um 'site' Web - o qual foi mencionado anteriormente como não sendo o uso pretendido pelo &kpf;.

Basta ter cuidado para não ligar nada com o seu sistema de ficheiros que possa conter informação importante (ou que tenha uma ligação dentro dele que aponte para dados importantes!)

## Perguntas e Respostas

Porque é que o &kpf; não inclui nenhuns mecanismos de segurança?

Na verdade, o &kpf; inclui várias medidas desenhadas para evitar que o utilizador permita o acesso acidental a informações importantes. Não existe nenhuma protecção com senha nem nenhuma cifra. Foi assim que foi desenhado, e será explicado em seguida.

Quanto mais medidas de segurança forem adicionadas a um serviço, mais seguras as pessoas se sentem ao usá-lo. Infelizmente, para garantir uma segurança real, o utilizador precisa de ter uma compreensão boa dos problemas envolvidos. Por exemplo, se fornecer uma protecção com senha não servirá de muito se o utilizador não souber escolher uma boa senha. Por isso, foi tomada a decisão de não oferecer nenhuma segurança, na esperança que o utilizador consiga perceber o que isto significa mais facilmente do que gastar meses ou anos a aprender as complexidades da segurança em redes.

O conceito é simples. Se você indicar que uma dada pasta está partilhada, ela está partilhada para o mundo inteiro. Se não a quiser partilhar para todos, não a partilhe de todo.

## Créditos e Licença

&kpf;

Programa copyright 2002 Rik Hemsley rik@kde.org

Documentação copyright 2002 por Rik Hemsley rik@kde.org

&underFDL;

O &kpf; é distribuído segundo a licença MIT.

## Instalação

### Como obter o &kpf;

&install.intro.documentation;
&documentation.index;