Esta documentação é de uma versão antiga do Python que não é mais atualizada. Você deveria atualizar e ler a documentação do Python para versão estável atual.

# `posix` — As chamadas de sistema mais comuns do POSIX

Este módulo fornece acesso à funcionalidade do sistema operacional padronizada pelo padrão C e pelo padrão POSIX (uma interface Unix levemente disfarçada).

Não importe este módulo diretamente. Em vez disso, importe o módulo `os`, que fornece uma versão portátil dessa interface. No Unix, o módulo `os` fornece um superconjunto da interface `posix`. Em sistemas operacionais não Unix, o módulo `posix` não está disponível, mas um subconjunto está sempre disponível na interface `os`. Uma vez que `os` é importado, seu uso não causa penalidade de desempenho em comparação com `posix`. Além disso, `os` fornece algumas funcionalidades adicionais, como chamar automaticamente `putenv()` quando uma entrada em `os.environ` é alterada.

Erros são relatados como exceções. As exceções usuais são dadas para erros de tipo, enquanto os erros relatados pelas chamadas do sistema aumentam `OSError`.

## Suporte a arquivos grandes

Vários sistemas operacionais (incluindo AIX, HP-UX, Irix e Solaris) fornecem suporte a arquivos maiores que 2 GiB a partir de um modelo de programação C em que `int` e `long` são valores de 32 bits. Isso geralmente é realizado definindo o tamanho relevante e os tipos de deslocamento como valores de 64 bits. Esses arquivos às vezes são chamados de arquivos grandes.

O suporte a arquivos grandes é ativado no Python quando o tamanho de um `off_t` é maior que a `long` e `long long` é pelo menos tão grande quanto um :c:tipo:`off_t`. Pode ser necessário configurar e compilar o Python com certos sinalizadores do compilador para ativar esse modo. Por exemplo, ele é ativado por padrão nas versões recentes do Irix, mas com o Solaris 2.6 e 2.7 você precisa fazer algo como:

    CFLAGS="`getconf LFS_CFLAGS`" OPT="-g -O2 $CFLAGS" \
            ./configure

Em sistemas Linux com capacidade para arquivos grandes, isso pode funcionar:

    CFLAGS='-D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64' OPT="-g -O2 $CFLAGS" \
            ./configure

## Conteúdo notável do módulo

Além de muitas funções descritas na documentação do módulo `os`, `posix` define o seguinte item de dados:

`posix.``environ`

  Um dicionário que representa o ambiente de strings no momento em que o interpretador foi iniciado. Chaves e valores são bytes no Unix e str no Windows. Por exemplo, `environ[b'HOME']` (`environ['HOME']` no Windows) é o nome do caminho do diretório inicial, equivalente a `getenv("HOME")` em C .

  A modificação deste dicionário não afeta o ambiente de strings passado por `execv()`, `popen()` ou `system()`. Se você precisar alterar o ambiente, passe `environ` para `execve()` ou adicione atribuições de variável e instruções de exportação para a string de comando para `system()` ou `popen()`.

  Alterado na versão 3.2: No Unix, chaves e valores são bytes.

  Nota

  O módulo `os` fornece uma implementação alternativa de `environ` que atualiza o ambiente ao ocorrerem modificações. Observe também que a atualização de `os.environ` tornará este dicionário obsoleto. O uso do módulo `os` é recomendado sobre o acesso direto ao módulo `posix`.