mbsync - Online na nuvem

PROGRAMA:

NOME

mbsync - sincroniza caixas de correio IMAP4 e Maildir

SINOPSE

mbsync [opções ...] {{canal[:caixa[{,|\n} ...]] |grupo} ... |-a}

DESCRIÇÃO

mbsync é um aplicativo de linha de comando que sincroniza caixas de correio; atualmente Maildir e
Há suporte para caixas de correio IMAP4. Novas mensagens, exclusões de mensagens e alterações de sinalizadores podem ser
propagado em ambos os sentidos; o conjunto de operações pode ser selecionado de maneira refinada.
A sincronização é baseada em identificadores de mensagem únicos (UIDs), portanto, nenhuma identificação
podem ocorrer conflitos (ao contrário de alguns outros sincronizadores de correio). OTOH, mbsync is
suscetível a alterações de validade UID (que rede de apoio social nunca acontecer, mas veja "Compatibilidade" em
o README). O estado de sincronização é mantido em um arquivo de texto local por par de caixa de correio;
várias réplicas de uma caixa de correio podem ser mantidas.

OPÇÕES

-c, --config lima
Leia a configuração de lima. Por padrão, a configuração é lida de
~ / .mbsyncrc.

-a, --tudo
Selecione todos os canais configurados. Quaisquer especificações de canal / grupo no comando
linha são ignorados.

-l, --Lista
Não sincronize nada, mas liste todas as caixas de correio nos canais selecionados e
Saída.

-C[m][s], --Criar[-mestre|-escravo]
Substituir qualquer Crie opções do arquivo de configuração. Veja abaixo.

-X[m][s], --expurgar[-mestre|-escravo]
Substituir qualquer Expurgar opções do arquivo de configuração. Veja abaixo.

{-n|-N|-d|-f|-0|-F}, {--novo|--renovar|--excluir|--bandeiras|--noop|--cheio}
{-L|-H}[n][N][d][f], {--puxar|--Empurre}[-novo|-renovar|-excluir|-bandeiras]

Substituir qualquer sincronização opções do arquivo de configuração. Veja abaixo.

-h, --Socorro
Exibe um resumo das opções de linha de comando.

-v, --versão
Exibir informações da versão.

-V, --verbose
permitir detalhado modo, que exibe o tráfego da rede IMAP4.

-D, --depurar
Habilitar impressão depurar informações.

-q, --quieto
Suprima mensagens informativas. Se especificado duas vezes, suprime as mensagens de aviso como
bem.

CONFIGURAÇÃO

O arquivo de configuração é obrigatório; mbsync não funcionará sem ele. Linhas começando com
uma marca de hash (#) são comentários e são totalmente ignorados. Os itens de configuração são palavras-chave
seguido por um ou mais argumentos; argumentos que contenham espaços devem ser colocados em dobro
citações ("), e aspas duplas literais e barras invertidas () deve ter escape de barra invertida. Tudo
palavras-chave (incluindo aquelas usadas como argumentos) não fazem distinção entre maiúsculas e minúsculas. Casa tipo Bash
expansão de diretório usando o til (~) é compatível com todas as opções que representam
caminhos. Existem algumas opções globais, o resto se aplica a seções específicas. Seções
são iniciados por uma palavra-chave de seção e são encerrados por uma linha em branco ou final de arquivo.
Cada seção define um objeto com um identificador exclusivo dentro dessa classe de objeto.

Existem duas classes básicas de objetos: Lojas e Canais. Uma loja define uma coleção de
caixas de correio; basicamente uma pasta, local ou remota. Um canal conecta duas lojas,
descrevendo a forma como os dois são sincronizados.
Existem duas classes de objetos auxiliares: Contas e Grupos. Uma conta descreve o
parte de conexão de armazenamentos remotos, de modo que uma conexão de servidor pode ser compartilhada entre vários
Lojas. Um grupo agrega vários canais para evitar a digitação na linha de comando.

Locais do sistema de arquivos (em particular, Caminho e Caixa de entrada) usar o caminho interno da Loja
separadores, que podem ser barras, pontos, etc., ou mesmo combinações dos mesmos.
Nomes de caixa de correio, OTOH, sempre usam separadores de caminho canônicos, que são encaminhados do tipo Unix
barras.

Todos Lojas
Essas opções podem ser usadas em todos os tipos de Loja com suporte.
Neste contexto, o termo "remoto" descreve a segunda Loja dentro de um Canal, e não
necessariamente um servidor remoto.
A caixa de correio especial INBOX existe em todas as lojas; sua localização física no sistema de arquivos
é específico do tipo de loja.

Caminho caminho
A localização da Loja no sistema de arquivos (do servidor). Se isso não for absoluto
caminho, o ponto de referência é específico do tipo de loja. Esta string é prefixada ao
nomes de caixa de correio endereçados neste armazenamento, mas não é considerada parte deles; isto é
importante para padrões na seção Canais. Observe que você devo acrescentar uma barra
se você deseja especificar um diretório inteiro. (Padrão: nenhum)

Tamanho máximo tamanho[k|m][b]
Mensagens maiores do que isso não serão propagadas para esta Loja. Isso é útil
para eliminar mensagens com anexos grandes. K e M pode ser anexado ao
tamanho para especificar KiBytes resp. MeBytes em vez de bytes. B é aceito mas
supérfluo. Se tamanho é 0, o tamanho máximo da mensagem é ilimitado. (Predefinição: 0)

Caixa de entrada do mapa caixa de correio
Crie uma caixa de correio virtual (relativa a Caminho) que aliases de INBOX. Faz sentido em
Conjunção com padrões na seção Canais, embora com um escravo Maildir, você
provavelmente quer colocar Caixa de entrada para Caminho em vez de. Esta caixa de correio virtual não
suporte a subpastas.

Aplainar delim
Achatar a hierarquia dentro desta Loja substituindo a hierarquia canônica
delimitador / com delim. Isso pode ser útil quando o MUA usado para acessar a Loja
fornece tratamento subótimo de caixas de correio hierárquicas, como é o caso com Mutt.
Uma escolha comum para o delimitador é ..
Observe que as subpastas achatadas do INBOX sempre acaba embaixo de Caminho, incluindo
a "CAIXA DE ENTRADAdelim"prefixo.

Lixo caixa de correio
Especifica uma caixa de correio (relativa a Caminho) para copiar mensagens excluídas antes de
expurgando. Ver RECOMENDAÇÕES e INERENTE PROBLEMAS abaixo. (Padrão: nenhum)

LixoNovoSomente sim|não
Ao enviar para a lixeira, copie apenas as mensagens ainda não propagadas. Isso faz sentido se o
Loja remota tem um Lixo também (com LixoNovoSomente não) (Predefinição: não)

LixoRemotoNovo sim|não
Ao eliminar o armazenamento remoto, copie as mensagens ainda não propagadas para este armazenamento
Lixo. Ao usar isso, o armazenamento remoto não precisa de um próprio Lixo em tudo, ainda tudo
as mensagens são arquivadas. (Predefinição: não)

maildir Lojas
O ponto de referência para o relativo Caminhos é o diretório de trabalho atual.

As mbsync precisa de UIDs, mas não existe um esquema de armazenamento UID padronizado para Maildir, mbsync
suporta dois esquemas, cada um com seus prós e contras.
A nativo esquema é roubado dos últimos patches Maildir para c-cliente e é, portanto,
compatível com pinheiro. A validade do UID é armazenada em um arquivo denominado .uidvalidity; os UIDs
são codificados nos nomes dos arquivos das mensagens.
A alternativa esquema é baseado no mapeamento UID usado por issync versões 0.8 e 0.9.x.
As partes invariáveis ​​dos nomes dos arquivos das mensagens são usadas como chaves em um Berkeley
banco de dados denominado .isyncuidmap.db, que também mantém a validade do UID.
A nativo esquema é mais rápido, mais eficiente em termos de espaço, independente de endianismo e "humano
legível ", mas será interrompido se uma mensagem for copiada de outra caixa de correio sem
obter um novo nome de arquivo; isso resultaria em UIDs duplicados mais cedo ou mais tarde, que em
por sua vez, resulta em uma alteração de validade UID, fazendo com que a sincronização falhe. o alternativa
esquema falharia se um MUA alterasse o nome do arquivo de uma mensagem em uma parte mbsync considera
invariante; isso seria interpretado como uma exclusão de mensagem e uma nova mensagem, resultando em
tráfego desnecessário.
Mutt é conhecido por funcionar bem com ambos os esquemas.
Use mdconvert para converter caixas de correio de um esquema para outro.

MaildirStore nome
Defina a Loja Maildir nome, abrindo uma seção para seus parâmetros.

AltMap sim|não
Use o alternativa Esquema de armazenamento UID para caixas de correio neste armazenamento. Isso não
afetam as caixas de correio que já possuem um esquema de armazenamento UID; usar mdconvert para alterar
isto. (Predefinição: não)

Caixa de entrada caminho
A localização do INBOX. Isto é não relativo a Caminho, mas é permitido colocar
da INBOX no interior da Caminho. (Predefinição: ~ / Maildir)

IMAP4 Contas
Conta IMAP nome
Defina a conta IMAP4 nome, abrindo uma seção para seus parâmetros.

Proprietário hospedeiro
Especifique o nome DNS ou endereço IP do servidor IMAP.
If Túnel é usado, esta configuração é usada apenas para verificação de certificado de host SSL,
se fornecido.

Porta porta
Especifique o número da porta TCP do servidor IMAP. (Padrão: 143 para IMAP, 993 para
IMAPS)
If Túnel é usado, esta configuração é ignorada.

Utilizador nome de usuário
Especifique o nome de login no servidor IMAP.

Passar senha
Especifique a senha para nome de usuário no servidor IMAP. Observe que esta opção é NÃO
obrigatório. Se nem uma senha nem um comando de senha for especificado no
arquivo de configuração, mbsync solicitará uma senha.

SenhaCmd comando
Especifique um comando shell para obter uma senha em vez de especificar uma senha
diretamente. Isso permite que você use arquivos e agentes de senha. O comando deve
produz exatamente uma linha em stdout; a nova linha final é opcional.

Túnel comando
Especifique um comando a ser executado para estabelecer uma conexão em vez de abrir um TCP
socket. Isso permite que você execute uma sessão IMAP em um túnel SSH, por exemplo.
If Use IMAPS é desativado e o túnel abre uma conexão pré-autenticada,
Requer SSL também precisa ser desativado. Se a conexão não for pré-autenticada,
mas o túnel é seguro, desativando Requer SSL e Use TLSv1 é recomendado.

Requer CRAM sim|não
Se definido para sim, mbsync irá abortar a conexão se nenhuma autenticação CRAM-MD5 for
possível. (Predefinição: não)

Use IMAPS sim|não
Se definido para sim, o padrão para Porta é alterado para 993 e mbsync vai iniciar SSL
negociação imediatamente após estabelecer a conexão com o servidor.
Observe que os servidores modernos suportam SSL na porta regular IMAP 143 via STARTTLS
extensão, que será usada automaticamente por padrão.

Requer SSL sim|não
mbsync irá abortar a conexão se uma sessão TLS / SSL não puder ser estabelecida com
o servidor IMAP. (Predefinição: sim)

Arquivo de certificado caminho
Arquivo contendo certificados X.509 adicionais usados ​​para verificar as identidades do servidor.
Os certificados de mesmo nível com correspondência direta são sempre confiáveis, independentemente da validade.
Observe que o armazenamento de certificados padrão do sistema é sempre usado e não deve ser
especificado aqui.

Use SSLv2 sim|não
Usar SSLv2 para comunicação com o servidor IMAP por SSL?
Observe que esta opção está obsoleta por motivos de segurança. (Predefinição: não)

Use SSLv3 sim|não
Usar SSLv3 para comunicação com o servidor IMAP por SSL? (Predefinição: não)

Use TLSv1 sim|não
Usar TLSv1 para comunicação com o servidor IMAP por SSL? (Predefinição: sim)

Use TLSv1.1 sim|não
Usar TLSv1.1 para comunicação com o servidor IMAP por SSL? (Predefinição: não)

Use TLSv1.2 sim|não
Usar TLSv1.2 para comunicação com o servidor IMAP por SSL? (Predefinição: não)

Profundidade do Pipeline profundidade
Número máximo de comandos IMAP que podem estar simultaneamente em vôo. Configuração
isso para 1 desativa o pipelining. Esta é principalmente uma opção de depuração apenas. (Predefinição:
ilimitado)

IMAP Lojas
O ponto de referência para o relativo Caminhos é o que o servidor gosta que seja; provavelmente o
$ HOME ou $ HOME / Mail do usuário nesse servidor. A localização de INBOX depende do servidor como
bem e geralmente é irrelevante.

Loja IMAP nome
Defina a Loja IMAP4 nome, abrindo uma seção para seus parâmetros.

Conta conta
Especifique qual conta IMAP4 usar. Em vez de definir uma conta e fazer referência
aqui, também é possível especificar todas as opções de conta diretamente no
Seção da loja - isso faz sentido se uma conta for usada para apenas uma loja de qualquer maneira.

Usar Namespace sim|não
Seleciona se o primeiro NAMESPACE "pessoal" do servidor deve ter o prefixo
nomes de caixas de correio. Desativar isso faz sentido para alguns servidores IMAP quebrados. Esse
opção não tem sentido se um Caminho foi especificado. (Predefinição: sim)

Delimitador de caminho delim
Especifique o delimitador de hierarquia do servidor. (Padrão: retirado do primeiro servidor
"pessoal" NAMESPACE)
Do NÃO abuse disso para reinterpretar a hierarquia. Usar Aplainar ao invés.

Canais
Canal nome
Defina o canal nome, abrindo uma seção para seus parâmetros.

{Mestre|Escravo} :loja:[caixa de correio]
Especifique o mestre resp. Slave Store a ser conectada por este canal. Se padrões
são especificados, caixa de correio é interpretado como um prefixo que não corresponde ao
padrões e que não é afetado por substituições de lista de caixa de correio. Caso contrário, se
caixa de correio é omitido, INBOX é assumido.

padrão[s] [!]de cinto de segurança ...
Em vez de sincronizar apenas um par de caixas de correio, sincronize todas as caixas de correio que
combinar com de cinto de segurança(s). Os nomes das caixas de correio são iguais em Master e Slave.
Os padrões são padrões IMAP4, ou seja, * corresponde a qualquer coisa e % corresponde a qualquer coisa até
o próximo delimitador de hierarquia. Anexar ! para um padrão torna uma exclusão.
Vários padrões podem ser especificados (fornecendo vários argumentos ou
utilização padrão várias vezes); as correspondências posteriores têm precedência.
Observe que INBOX não é correspondido por curingas, a menos que resida sob Caminho.
A lista de caixas de correio selecionada por padrões pode ser substituído por uma lista de caixa de correio em um
referência de canal (a Grupo especificação ou a linha de comando).
Exemplo: "padrões % !Lixo"

Tamanho máximo tamanho[k|m][b]
Análogo à opção homônima na seção Lojas, mas se aplica igualmente a
Mestre e escravo. Observe que isso realmente modifica as lojas, então tome cuidado para não
fornecer configurações conflitantes se você usar as lojas em vários canais.

MaxMensagens contar
Define o número máximo de mensagens a serem mantidas em cada caixa de correio Slave. Isso é útil
para caixas de correio onde você mantém um arquivo completo no servidor, mas deseja espelhar
apenas as últimas mensagens (por exemplo, para listas de discussão). As mensagens que foram
o primeiro a chegar na caixa de correio (independentemente da data real do
mensagem) será excluída primeiro. Mensagens sinalizadas (marcadas como importantes)
e (por padrão) as mensagens não lidas não serão excluídas automaticamente. Se contar é 0,
o número máximo de mensagens é ilimitado (Predefinição: 0).

ExpirarNão lido sim|não
Seleciona se as mensagens não lidas devem ser afetadas por MaxMensagens. Normalmente,
mensagens não lidas são consideradas importantes e, portanto, nunca expiram. Isso garante que
você nunca perde novas mensagens, mesmo após uma longa ausência. No entanto, se o seu
arquivo contém grandes quantidades de mensagens não lidas por design, tratando-as como
importante seria praticamente derrotar MaxMensagens. Neste caso, você precisa habilitar
esta opção. (Predefinição: não).

sincronização {nenhum|[Puxe] [Empurrar] [Novo] [Renovar] [Apagar] [Bandeiras]|Todos}
Selecione a (s) operação (ões) de sincronização a realizar:
Puxe - propaga mudanças de Master para Slave.
Empurrar - propaga mudanças de Slave para Master.
Novo - propaga mensagens recém-surgidas.
Renovar - as mensagens recusadas anteriormente são reavaliadas para propagação. Útil depois
sinalizando mensagens afetadas no armazenamento de origem ou ampliando MaxSize no
Loja de destino.
Apagar - propaga exclusões de mensagens. Isso se aplica apenas a mensagens que são
realmente desaparecidos, ou seja, foram eliminados. As mensagens afetadas no armazenamento remoto são
marcados apenas como excluídos, ou seja, eles não serão realmente excluídos até que a Loja seja
expurgado.
Bandeiras - propagar mudanças de sinalizadores. Observe que Deleted / Trashed também é um sinalizador; isto
é particularmente interessante se você usar vira-lata com a opção maildir_trash.
Todos (--cheio na linha de comando) - todas as opções acima. Este é o padrão global.
nenhum (--noop na linha de comando) - não propague nada. Útil se você quiser
para eliminar apenas.

Puxe e Empurrar são sinalizadores de direção, enquanto Novo, Renovar, Apagar e Bandeiras são tipo
bandeiras. As duas classes de sinalizadores formam uma matriz bidimensional (uma tabela). Suas células
são as ações individuais a serem realizadas. Existem dois estilos de afirmação das células:
No primeiro estilo, as bandeiras selecionam linhas / colunas inteiras na matriz. Apenas o
células que são selecionadas horizontalmente e verticalmente são ativadas. Especificando
nenhum sinalizador de uma classe é como especificar todos os sinalizadores dessa classe. Por exemplo,
"sincronização Puxe Novo Bandeiras"irá propagar novas mensagens e sinalizar alterações do Mestre
para o escravo, "sincronização Novo Apagar"irá propagar chegadas e exclusões de mensagens tanto
formas, e "sincronização Empurrar"irá propagar todas as mudanças do Slave para o Master.
No segundo estilo, os sinalizadores de direção são concatenados com sinalizadores de tipo; cada
o sinalizador composto afirma imediatamente uma célula na matriz. Além de pelo menos um
sinalizador composto, os sinalizadores individuais também podem ser usados, mas ao contrário do
primeiro estilo, eles afirmam imediatamente todas as células em suas respectivas linhas / colunas. Para
exemplo, "sincronização PuxeNovo PullDelete Empurrar"propagará as chegadas de mensagens e
exclusões do Master para o Slave e quaisquer alterações do Slave para o
Mestre. Observe que não é permitido afirmar uma célula de duas maneiras, por exemplo
"sincronização PuxeNovo Puxe"E"sincronização PuxeNovo Apagar Empurrar"induzem mensagens de erro.

Crie {nenhum|Mestre|Escravo|Ambos}
Crie automaticamente caixas de correio ausentes [no Master / Slave]. Caso contrário, imprima um
mensagem de erro e pule esse par de caixa de correio se uma caixa de correio não existir. (Global
default: nenhum)

Expurgar {nenhum|Mestre|Escravo|Ambos}
Remova permanentemente todas as mensagens [no Master / Slave] marcadas para exclusão. Ver
RECOMENDAÇÕES abaixo. (Padrão global: nenhum)

CopiarData de chegada {sim|não}
Seleciona se a hora de chegada deve ser propagada junto com as mensagens.
Ativar isso faz sentido para manter a classificação de mensagens com base em carimbo de data / hora
intacta. Observe que o IMAP não garante que o carimbo de data / hora (denominado interno
dados) é na verdade a hora de chegada, mas geralmente é próxima o suficiente. (Predefinição: não)

sincronização, Crie, Expurgar, MaxMensagens e CopiarData de chegada pode ser usado antes de qualquer seção para
um efeito global. As configurações globais são substituídas por opções específicas do canal, que em
turn são substituídos por opções de linha de comando.

Estado de sincronização {*|caminho}
Defina a localização dos arquivos de estado de sincronização deste Canal. * significa que o
o estado deve ser salvo em um arquivo denominado .mbsyncstate na própria caixa de correio do Slave;
isso tem a vantagem de que você não precisa se preocupar com o arquivo de estado se excluir
a caixa de correio, mas funciona apenas com caixas de correio Maildir, obviamente. Caso contrário, este é
interpretado como uma string para preceder o nome da caixa de correio Slave para formar um
caminho.
Esta opção pode ser usada fora de qualquer seção para um efeito global. Neste caso, o
string anexada é feita de acordo com o padrão :dominar:mestre-
caixa_:escravo:caixa escrava.
(Padrão global: ~ / .mbsync /).

Grupos
Grupo nome [canal[:caixa[,...]]] ...
Defina o Grupo nome, abrindo uma seção para seus parâmetros. Observe que embora
Os grupos têm um namespace próprio, eles irão "ocultar" os canais com o mesmo nome no
linha de comando.
Um ou mais canais podem ser especificados na mesma linha.
Se você fornecer um ou mais caixaes para um canal, eles serão usados ​​em vez do que é
especificado nos padrões do canal. O mesmo pode ser feito na linha de comando,
exceto que as novas linhas também podem ser usadas como separadores de nome de caixa de correio.

Canal[s] canal[:caixa[,...]] ...
Adicione os canais especificados ao grupo. Esta opção pode ser especificada em vários
vezes dentro de um Grupo.

Global Opções
FSync sim|não
Seleciona se mbsync realiza limpeza forçada, que determina o nível de dados
segurança após falhas do sistema e quedas de energia. Desativá-lo é razoavelmente seguro para
sistemas de arquivos que são montados com dados = modo ordenado. Ativar é uma sábia
escolha para sistemas de arquivos montados com data = writeback, em particular sistemas modernos
como ext4, btrfs e xfs. O impacto no desempenho em sistemas de arquivos mais antigos pode ser
desproporcional. (Predefinição: sim)

RECOMENDAÇÕES

Certifique-se de que seu servidor IMAP não elimine automaticamente as mensagens excluídas - ele é lento e
semanticamente um tanto questionável. Especificamente, o Gmail precisa ser configurado para não fazer
.

Por padrão, o mbsync não excluirá nenhuma mensagem - as exclusões são propagadas marcando o
mensagens excluídas no armazenamento remoto. Depois de verificar se sua configuração funciona,
você normalmente vai querer definir Expurgar para Ambos, para que as exclusões se tornem efetivas.

mbsynca funcionalidade de lixo embutida do conta com mbsync fazendo a eliminação de excluídos
mensagens. Este é o caso quando ele propaga exclusões de mensagens propagadas anteriormente,
e a lixeira está no armazenamento de destino (normalmente seu servidor IMAP).
No entanto, quando você pretende mbsync para o lixo mensagens que ainda não foram propagadas, o MUA
deve marcar as mensagens como excluídas sem eliminá-las (por exemplo, Mutt's maildir_trash
opção). Observe que a maioria das mensagens são propagadas muito antes de serem excluídas, então
este é um caso secundário para o qual você provavelmente não deseja otimizar. Isso também implica que o
LixoNovoSomente e LixoRemotoNovo as opções normalmente não são muito úteis.

Se o seu servidor oferece suporte para lixo automático (como o Gmail faz), provavelmente é uma boa ideia confiar
nisso em vez de mbsyncfuncionalidade de lixo de. Se você fizer isso, e pretende
sincronize a lixeira como outras caixas de correio, você não deve usar mbsync's Lixo opção em
todos.

INERENTE PROBLEMAS

Mudanças feitas depois mbsync recuperou a lista de mensagens não será sincronizada até
a próxima vez mbsync é invocado.

utilização Lixo em IMAP Stores sem a extensão UIDPLUS (notavelmente, M $ Exchange até em
pelo menos, 2010) tem uma condição de corrida: as mensagens serão perdidas se forem marcadas como excluídas
depois que a lista de mensagens foi recuperada, mas antes de a caixa de correio ser eliminada. Não há risco
contanto que a caixa de correio IMAP seja acessada por apenas um cliente (incluindo mbsync) de uma vez.

Use mbsync online usando serviços onworks.net