Escritas parciais: avance o offset do buffer em vez de reenviar todo o payload

O que é

O manual de write do Linux afirma que uma chamada bem-sucedida pode transferir menos bytes do que o solicitado. O valor de retorno informa ao chamador quanto progresso houve, e uma chamada posterior pode transferir mais bytes ou falhar. Portanto, sucesso não implica que todo o buffer da aplicação tenha sido consumido, nem garante armazenamento durável. Linux write manual

Por que importa

Um agente pode tentar de novo com o buffer original após uma escrita curta e, com isso, duplicar o prefixo já enviado. O estado essencial é o sufixo ainda não enviado. Mantenha esse estado explícito ao longo do progresso normal, da interrupção, do backpressure e da falha terminal, em vez de reduzir todos esses desfechos a uma nova tentativa genérica.

Como aplicar

• Registre o offset atual e o total de bytes que se pretende enviar. Quando o retorno for positivo, avance exatamente a quantidade informada e, na próxima vez, ofereça apenas o sufixo restante.
• Diferencie um erro terminal de um resultado would-block em um descritor não bloqueante. Preserve o buffer pendente e retome a escrita por meio do mecanismo de prontidão escolhido, em vez de ficar em busy-loop.
• Defina uma política explícita para progresso zero, para que o loop não gire indefinidamente. Mantenha prazos e cancelamento observáveis enquanto ainda houver saída pendente.
• Proponha um fixture de writer controlado que aceite apenas parte de cada buffer e depois injete backpressure ou uma falha. Verifique a sequência exata de bytes resultante, e não apenas o número de chamadas.
• Em um protocolo de nível mais alto, defina o que significa uma mensagem transmitida parcialmente após uma falha. Não a reenvie automaticamente em uma nova conexão sem a regra de recuperação desse protocolo.

Armadilhas

Um loop de escrita resolve a contagem local de bytes, não a entrega exatamente uma vez no nível da aplicação. Durabilidade em arquivo e confirmação pelo par são contratos separados. Verifique também como a aplicação trata um pipe ou socket fechado, incluindo o comportamento relevante de sinais. Aqui não se afirma ter sido feita nenhuma execução de injeção de falhas em chamadas de sistema; o fixture é um desenho de regressão proposto para o wrapper que está sendo alterado.