RESUMO
- Desenvolvimento próprio. O OpenMacFUSE é um servidor NFSv4.0 incorporado ao processo do driver que expõe a API FUSE 2.x. São cerca de 17.000 linhas de C, implementadas a partir das RFCs 7530, 5531 e 4506 e publicadas sob a licença MIT. É uma das poucas implementações FUSE de código aberto para macOS que dispensam extensão de kernel.
- Velocidade. A diferença é maior em cargas com muitas operações de metadados: calcular a soma de verificação de todos os arquivos de um volume leva 23 s, contra 797 s no FUSE-T, e apagar 10.000 arquivos pequenos é de 6 a 9 vezes mais rápido. Leituras e gravações sequenciais de arquivos grandes em discos USB reais não mostram diferença mensurável.
- Memória. O processo do driver usa de 45 a 51 MB de memória física, independentemente do número de arquivos ou do tempo de atividade.
- Confiabilidade. Se a energia do USB é cortada durante uma gravação, o driver desmonta o volume e encerra em até 0,5 s. Quando a energia volta, o volume monta normalmente e nenhum arquivo fica com conteúdo corrompido; as únicas perdas são gravações concluídas aproximadamente no último segundo.
- Manutenção. A camada de protocolo, a interface FUSE e o motor NTFS ficam no mesmo código-fonte, então um problema na camada de montagem pode ser rastreado e corrigido diretamente, sem esperar o ciclo de lançamentos de terceiros.
23 s vs. 797 s
381 MB com o FUSE-T
medido em um SSD USB
todas aprovadas no macOS 12
1 Contexto2 Arquitetura3 Desempenho4 Memória5 Comportamento no macOS6 Tratamento de falhas7 Metodologia8 Limitações9 ConclusãoPerguntas frequentes
1Contexto
Desde o macOS 11, carregar uma extensão de kernel exige iniciar o Mac no modo de recuperação do macOS e mudar para Segurança Reduzida. Para um software voltado ao público em geral, esse caminho deixou de ser viável. Há duas formas principais de ficar fora do kernel: o FSKit da Apple (disponível a partir do macOS 15.4 e usado pelo "Driver 2" do NTFSTool) e o cliente NFS integrado ao macOS. A segunda abordagem executa um servidor NFS na própria máquina, converte as operações do sistema de arquivos em chamadas a um driver no espaço do usuário e monta o resultado com mount_nfs. O FUSE-T segue essa abordagem e é a implementação mais madura dela; por isso é a referência de todas as comparações deste artigo.
Decidimos implementar essa camada por conta própria por três motivos de engenharia:
- Instalação. O FUSE-T é um componente separado. Ele precisa ser instalado no primeiro uso, com a senha de administrador, o que acrescenta uma etapa e mais um ponto que pode falhar.
- Correção de problemas. Uma camada de montagem de terceiros é distribuída como binário. Conseguimos reproduzir problemas nela, como listagens lentas de diretórios grandes ou uso crescente de memória, mas só o autor pode corrigi-los.
- Comportamento do sistema de arquivos. Uma camada de montagem genérica não conhece o NTFS. Regras de maiúsculas e minúsculas, os atributos de oculto e somente leitura e o local onde ficam os atributos estendidos só podem ser tratados corretamente junto com o motor do sistema de arquivos.
2Arquitetura
O OpenMacFUSE é vinculado ao driver como biblioteca estática. Ao iniciar, o driver escuta em um endpoint local dentro do próprio processo e depois chama o mount_nfs do sistema. Cada requisição COMPOUND do cliente NFS do kernel é decodificada, enviada aos callbacks do FUSE e respondida dentro desse único processo. Não há segundo processo, nem cópia extra, nem troca de contexto pelo caminho.
Transporte e opções de montagem
O macOS 26 e posteriores usam um socket de domínio Unix (proto=ticotsord). Nenhuma porta é aberta, e outros usuários da máquina não conseguem se conectar. O cliente do kernel no macOS 12 falha em gravações grandes nesse transporte, então as versões anteriores do macOS recorrem a TCP em 127.0.0.1, com duas verificações no servidor de que a conexão vem da montagem local. Estas são as opções que o sistema informou após uma montagem no macOS 27:
$ nfsstat -m <mount point> NFS parameters: vers=4.0,ticotsord,port=/var/folders/…/openmacfuse.P1wAL0/s,hard,intr, noresvport,nocallback,negnamecache,nonamedattr,noacl,noaclonly,locks,noquota, rsize=262144,wsize=262144,readahead=16,dsize=32768,nordirplus,nodumbtimer, timeo=10,maxgroups=16,…,deadtimeout=60
nonamedattr é o padrão do cliente do sistema e define como os atributos estendidos são tratados na seção 5. nordirplus foi escolha nossa; o custo dela é tratado na seção 8.Decisões de implementação
- Uma tabela de nós com limite. Um identificador de arquivo não é um ponteiro para um objeto na memória. A tabela de nós tem limite de tamanho, e um identificador cujo nó foi removido é resolvido de novo pelo caminho no próximo uso. Nos testes, reduzimos o limite para 64 entradas e renomeamos 301 vezes seguidas; todos os 7.839 acessos por identificadores antigos foram recuperados e nenhum retornou
NFS4ERR_STALE. É por isso que a memória não cresce com o número de arquivos. - Cache de requisições duplicadas. O cliente reenvia uma requisição após um timeout. Em operações não idempotentes, como CREATE, REMOVE e RENAME, o servidor guarda as respostas recentes e responde ao reenvio a partir desse cache, sem executar a operação de novo. Nos testes, descartamos uma resposta de cada um dos seis tipos de operação; cada operação foi executada exatamente uma vez.
- Sem atributos nomeados. Os atributos nomeados do NFSv4 são a correspondência natural do protocolo para atributos estendidos, mas o cliente NFS do kernel do macOS tem um defeito nesse caminho que derruba o sistema. Nós o encontramos durante o desenvolvimento no macOS 27.0.1 e no 12.7.6. Por isso o OpenMacFUSE permanece no caminho mais usado pelo cliente, e os atributos nomeados ficam desativados.
3Desempenho
O OpenMacFUSE é de 6 a 35 vezes mais rápido que o FUSE-T 1.0.49 em cargas com muitos metadados e equivalente em leituras e gravações sequenciais em discos USB reais. Método: a mesma máquina, a mesma imagem de volume e o mesmo código-fonte do motor NTFS, compilado uma vez com o OpenMacFUSE e outra com o FUSE-T 1.0.49. A imagem fica no SSD interno e a E/S passa pelo cache de páginas do sistema, então a Figura 3 mede a sobrecarga da camada de montagem mais o motor, não o disco. Os resultados em discos reais estão separados na Tabela 1.
OpenMacFUSE
FUSE-T 1.0.49| Tabela 1 · Discos USB reais | OpenMacFUSE | FUSE-T |
|---|---|---|
| SSD, gravação sequencial de 4,5 GB | 293–313 MB/s | 300 MB/s |
| SSD, leitura a frio | 245–251 MB/s | 236–241 MB/s |
| SSD, percurso da árvore de diretórios | 0,25–0,30 s | 4,1–4,6 s |
| SSD, apagar 2.000 arquivos pequenos | 0,82–0,86 s | 8,4–9,7 s |
| Disco rígido, gravação / leitura sequencial | 70 / 97 MB/s | 74 / 93 MB/s |
SSD medido em um Apple M2 / macOS 27; disco rígido em um Intel i7 / macOS 12.7. A velocidade sequencial é limitada pela conexão USB e pelo próprio disco; as diferenças estão dentro da margem de erro das medições.
Um resultado omitido: criação de arquivos pequenos. Depois desses testes, a política padrão de flush do OpenMacFUSE foi tornada mais conservadora (seção 6), o que deixou a criação de arquivos pequenos cerca de duas vezes mais lenta. A comparação em discos reais com o FUSE-T não foi repetida com a nova política, e não citaremos os números antigos até que seja.
4Memória
O OpenMacFUSE se mantém em 45–51 MB de memória física, independentemente da carga ou do tempo de atividade; o FUSE-T usou de 200 MB a 1 GB nos mesmos testes. Todos os valores são a pegada de memória física, a mesma medida da coluna Memória no Monitor de Atividade. No OpenMacFUSE, é o único processo do driver; no FUSE-T, é o processo do driver mais o processo do servidor NFS. Ambos incluem cerca de 35 MB de cache de blocos que pertencem ao motor NTFS.
5Comportamento no macOS
O OpenMacFUSE mantém os arquivos ._ fora do disco e converte os atributos do NTFS nos equivalentes do macOS.
._.AppleDouble
Por padrão, o cliente NFS do macOS não usa atributos nomeados. Ele empacota os atributos estendidos, a resource fork e as informações do Finder de um arquivo em um arquivo AppleDouble chamado ._nome-do-arquivo e o envia ao servidor com operações OPEN e WRITE comuns. Se o servidor simplesmente guarda o que recebe, esses arquivos vão parar no disco, onde aparecem como arquivos soltos no Windows.
Isso ficou mais evidente com o macOS 26: o sistema anexa um atributo com.apple.provenance a cada arquivo novo, então cada arquivo ganha um arquivo ._ correspondente. Gravar um conjunto de 40.000 arquivos pequenos pelo FUSE-T deixou 40.048 arquivos ._ a mais no disco. Um repositório git no volume mostrou 48 arquivos não rastreados, e o git fsck relatou 67 erros.
O OpenMacFUSE detecta no servidor o acesso a arquivos ._, interpreta o conteúdo AppleDouble e grava cada atributo em um fluxo de dados alternativo (alternate data stream) do NTFS no arquivo principal. Na leitura, ele reconstrói o arquivo AppleDouble sob demanda. Nenhum arquivo separado é criado no disco e nenhum aparece nas listagens de diretório. Em um disco que já contém arquivos ._, eles ficam ocultos e cada um é movido para o fluxo de dados na próxima vez que o arquivo principal for modificado.
O custo é a filtragem durante a listagem do diretório: a primeira listagem de um diretório com 40.000 entradas passa de 1,4 s para 3,6 s. Consideramos a troca justa.
Outros comportamentos
| Recurso | Comportamento do OpenMacFUSE | Observado com o FUSE-T |
|---|---|---|
| Maiúsculas e minúsculas nos nomes | Não diferencia maiúsculas de minúsculas, mas preserva a grafia, como no Windows. Se o volume já tem nomes que diferem apenas em maiúsculas e minúsculas, a montagem passa automaticamente a diferenciá-las | Diferencia maiúsculas de minúsculas |
| Normalização Unicode | As formas NFC e NFD de um nome chegam ao mesmo arquivo (letras acentuadas, coreano) | Não testado |
| Atributo oculto | O bit HIDDEN do NTFS e o sinalizador de oculto do Finder são convertidos nos dois sentidos | Não convertido |
| Atributo somente leitura | O bit READONLY do NTFS impede a gravação do arquivo no macOS | Não refletido |
| Data de criação | stat -f %B retorna a data de criação gravada no disco | Sempre 0 |
| Bloqueios de intervalo de bytes | Compatível; bancos de dados SQLite podem ser abertos direto no volume | Não testado |
6Tratamento de falhas
Discos externos são desconectados sem aviso. Isso é uso normal, não um caso raro, e o OpenMacFUSE tem três mecanismos que removem a montagem quando acontece. Uma camada de montagem baseada em NFS traz um risco inerente: a montagem é hard, então, quando o servidor para de responder, qualquer processo que acessa o volume entra em uma espera ininterruptível e o Finder deixa de responder. A camada de montagem precisa garantir que algo sempre remova o ponto de montagem:
- Detecção de perda do dispositivo. Um erro de dispositivo em uma operação de E/S é tratado na hora; quando ocioso, o nó do dispositivo é verificado pelo IOKit uma vez por segundo. Confirmada a perda, as requisições pendentes falham com erro, o volume é desmontado à força e o processo encerra.
- Watchdog. Se há uma requisição em andamento e nada avança por 30 segundos, o driver é considerado travado; ele desmonta o volume e encerra do mesmo modo.
- Processo guardião. Se o próprio driver falha ou é encerrado à força, um pequeno processo separado remove o ponto de montagem. Sem ele, o sistema só faz a limpeza sozinho após cerca de 70 segundos (
deadtimeout), e até lá os processos que acessam o volume não podem ser interrompidos.
== corte de energia: B-write1 (carga: gravação, após as mudanças, NTFSTOOL_DRIVER_FSYNC=bounded) - após o corte: erro na gravação em 0,19 s; ponto de montagem removido em 0,21 s; driver encerrado em 0,45 s; processos ininterruptíveis: 0 [pass] do corte de energia à recuperação completa: 0,45 s (limite: 10 s) - 303 arquivos com fsync; do último retorno de fsync à detecção da perda do dispositivo: 0,081 s [pass] monta após o corte sem ntfsfix (0,33 s)
Consistência após queda de energia
Depois de um corte de energia durante uma gravação, o volume agora monta sem ferramenta de reparo em todas as execuções de teste, e nenhum arquivo volta com conteúdo errado. A camada de montagem influencia duas coisas: se o volume monta sem ferramenta de reparo quando a energia volta e quantas das gravações já confirmadas ao aplicativo sobrevivem. O OpenMacFUSE faz três mudanças aqui:
- Ordem de gravação. Os dados do arquivo chegam ao dispositivo antes dos metadados que se referem a eles. Sem ordenação, quatro de cinco execuções com corte de energia produziram arquivos com conteúdo errado; com ordenação, nenhuma produziu.
- Flush de cache com limite de tempo. Na política padrão, o
fsyncretorna assim que os dados foram gravados no dispositivo, e uma thread em segundo plano esvazia o cache de gravação do próprio disco em até um segundo. Fazer o flush de forma síncrona a cada chamada reduz a perda a no máximo um arquivo por execução, mas deixa a gravação de arquivos pequenos de 13 a 23 vezes mais lenta; essa opção continua disponível. - Autorreparo na montagem. Um resultado comum de queda de energia é a divergência entre
$MFTe$MFTMirr, caso em que a especificação determina que a montagem seja recusada. O OpenMacFUSE verifica e repara isso durante a montagem, então ninguém precisa executar uma ferramenta de reparo antes.
| SSD USB, corte de energia durante uma gravação | Antes das mudanças | Depois (política padrão) |
|---|---|---|
| Monta sem ferramenta de reparo quando a energia volta | 3 de 5 execuções falharam por divergência em $MFTMirr | Todas as execuções |
| Arquivos confirmados perdidos por execução | 12–19 | 1–27, todos gravados aproximadamente no último segundo |
| Arquivos com conteúdo errado | Alguns arquivos voltaram só com zeros | 0 |
"Antes das mudanças" é o comportamento do motor antes deste trabalho; o mesmo motor montado pelo FUSE-T deu os mesmos resultados. Nenhum sistema de arquivos consegue garantir os dados do último instante quando um disco portátil sem bateria perde energia no meio de uma gravação. O objetivo aqui é limitar a perda às gravações mais recentes e manter a estrutura do volume intacta.
7Metodologia
| Item | Detalhes |
|---|---|
| Hardware | MacBook Pro (Intel i7-4770HQ, 16 GB, macOS 12.7.6); Mac (Apple M2, 24 GB, macOS 27.0.1); SSD USB de 120 GB, disco rígido USB de 1 TB, pen drive USB |
| Comparação | Mesma máquina, mesma imagem, mesmo código-fonte do motor NTFS; só a camada de montagem muda. FUSE-T versão 1.0.49 |
| Medição de tempo | Os tempos de gravação incluem o sync; as leituras sequenciais rodam depois de desmontar e montar de novo, para evitar o cache do cliente |
| Memória | ri_phys_footprint de proc_pid_rusage, em intervalos de 0,2 s |
| Desconexão e queda de energia | Um relé corta a alimentação USB de 5 V sem desmontar antes. Quando a energia volta, a estrutura do volume é verificada em modo somente leitura; depois o volume é montado sem reparo e todos os arquivos são comparados |
| Correção | 300 s de comparação aleatória de leitura e gravação (692.000 operações, 0 divergências); 8 gravadores simultâneos mais 2 listagens recursivas; estrutura do volume verificada após cada execução |
| Regressão | 15 suítes de scripts com 869 verificações, cobrindo leitura e gravação em NTFS, comportamento no macOS, volumes ext, exFAT e BitLocker, além de injeção de falhas: desconexão, encerramento forçado, travamento e timeout do handshake de montagem |
07:29:09 [pass] montado 07:29:10 [pass] arquivo grande gravado 07:29:12 [pass] arquivos pequenos gravados 07:29:13 [pass] MD5 do arquivo grande confere 07:29:13 [pass] MD5 de todos os arquivos pequenos conferem 07:29:13 [pass] renomear / acrescentar / truncar / apagar 07:29:13 [pass] abertura sem diferenciar maiúsculas de minúsculas 07:29:13 [pass] nenhum arquivo ._ na listagem 07:29:13 [pass] leitura e gravação de atributos estendidos 07:29:15 [pass] desmontagem normal 07:29:15 [pass] driver encerrado 07:29:15 [pass] processo guardião encerrado
8Limitações
- Versões do macOS cobertas pelos testes de regressão. A suíte completa de regressão automatizada roda hoje no macOS 12.7 (Intel) e no macOS 27 (Apple Silicon); outras versões ainda estão sendo incluídas. A primeira rodada de regressão no macOS 27 encontrou três problemas que não ocorrem no macOS 12; todos já foram corrigidos.
- Alcance da comparação. Todos os números do FUSE-T vêm das nossas duas máquinas e apenas da versão 1.0.49. "Não testado" não significa que o recurso não seja compatível.
- Defeitos do cliente do kernel não têm contorno no espaço do usuário. Esse tipo de montagem só pode ser tão estável quanto o cliente NFS do macOS. Evitamos os dois caminhos que sabemos que falham (atributos nomeados e reconexão após timeout do handshake de montagem), mas não podemos descartar outros.
- O macOS trata esses volumes como volumes de rede. Não há Lixeira, e o Spotlight não os indexa. O mesmo vale para o FUSE-T; é inerente à abordagem.
- Diretórios muito grandes. O Finder leva cerca de 74 s para abrir pela primeira vez um diretório com mais de 40.000 entradas. O gargalo é o modo como o Finder busca os atributos entrada por entrada, e é igual nas duas camadas de montagem.
- A ordem de gravação ao apagar arquivos ainda não recebeu o mesmo tratamento que as gravações. Depois de uma queda de energia, há uma pequena chance de que novos dados gravados no espaço liberado por um arquivo recém-apagado sejam afetados.
9Conclusão
O OpenMacFUSE é a camada de montagem padrão do Driver 1 no NTFSTool Pro; volumes NTFS, ext, exFAT e BitLocker são todos montados por ele. Manter a camada de montagem no nosso próprio código-fonte traz quatro vantagens:
- Desenvolvimento próprio. RPC, XDR, a máquina de estados do NFSv4.0 e a interface FUSE são implementação nossa. Não há componente de montagem de terceiros nem nada extra para instalar.
- Desempenho. As requisições são concluídas dentro de um único processo. As operações de metadados são de 6 a 35 vezes mais rápidas que com o FUSE-T, e o uso de memória é de um sexto a um vigésimo.
- Confiabilidade. Um disco desconectado, um driver travado e um processo encerrado à força têm, cada um, seu próprio mecanismo de saída, e o volume monta normalmente após uma queda de energia.
- Manutenção. 869 verificações automatizadas cobrem os caminhos normais e a injeção de falhas, então um problema pode ser reproduzido, rastreado, corrigido e testado contra regressões em um único código-fonte.
Perguntas frequentes
- O que é o OpenMacFUSE?
- OpenMacFUSE é a camada de montagem de código aberto, executada no espaço do usuário, desenvolvida pela NTFSTool e integrada ao NTFSTool Pro. Ela monta volumes NTFS, ext, exFAT e BitLocker no macOS. É um servidor NFSv4.0 que roda dentro do processo do driver e não usa extensão de kernel.
- Preciso instalar o macFUSE ou o FUSE-T para usar o NTFSTool Pro?
- Não. O OpenMacFUSE, a camada de montagem própria da NTFSTool, já vem dentro do NTFSTool Pro. Ele não depende do macFUSE, do FUSE-T nem de qualquer extensão de kernel, e você nunca precisa iniciar o Mac no modo de recuperação do macOS e reduzir a segurança.
- Como o OpenMacFUSE se compara ao FUSE-T em desempenho?
- No mesmo Mac e com o mesmo motor NTFS, calcular a soma de verificação de todos os arquivos de um volume leva 23 s com o OpenMacFUSE contra 797 s com o FUSE-T, e apagar 10.000 arquivos pequenos é de 6 a 9 vezes mais rápido. Leituras e gravações sequenciais de arquivos grandes em discos USB reais são equivalentes. O uso de memória do OpenMacFUSE fica em 45 a 51 MB, contra 200 MB a 1 GB do FUSE-T.
- O que acontece se eu desconectar um disco no meio de uma gravação?
- O driver do OpenMacFUSE desmonta o volume e encerra sozinho em cerca de 0,5 s, então o Finder e outros apps não travam. O volume monta normalmente quando o disco é reconectado. Gravações concluídas aproximadamente no último segundo antes da queda de energia podem não estar lá; o conteúdo dos demais arquivos não é afetado.
- Por que a NTFSTool criou a própria camada de montagem em vez de usar um componente de código aberto ou de terceiros?
- A camada de montagem determina a velocidade, o uso de memória e o que acontece quando algo falha. Com uma implementação própria, a NTFSTool consegue rastrear e corrigir problemas em um único código-fonte, e o comportamento específico do NTFS (diferenciação de maiúsculas e minúsculas, atributos de oculto e somente leitura, atributos estendidos) é tratado junto com o motor do sistema de arquivos.
- O OpenMacFUSE é de código aberto?
- Sim. O OpenMacFUSE é de código aberto sob a licença MIT, e o código está no GitHub em ntfstool/openmacfuse. Qualquer sistema de arquivos FUSE 2.x pode ser vinculado a ele.
Todos os dados deste artigo foram medidos pela equipe de engenharia da NTFSTool; a metodologia está na seção 7. O FUSE-T é um projeto do seu autor e não tem vínculo com a NTFSTool. O OpenMacFUSE é um projeto independente e não tem vínculo com o macFUSE nem com seus autores.