fls/pitiupi

1 Fork 0

Files

T

Gabriel Felipe Souza SantosandCursor baaf7582d3 docs(tp): remove checklists e escopo de TP do repo

Mantém só visão da disciplina e tutorial Ping em docs/tp/;
documentação técnica sem tabelas de verificação para entrega.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-10-27 21:41:48 -03:00

2.6 KiB

Raw Blame History

Apêndice — portas e multicast

Configuração

Nome e porta definidos no diálogo de login (Login).
A mesma porta é usada para UDP (multicast socket) e TCP (ServerSocket).
Preferências persistidas localmente (java.util.prefs).

Multicast

Grupo: 224.0.0.3 (fixo no código do núcleo).
Buffer UDP: 256000 bytes (configuração em SocketUDP).

Todos os peers na mesma LAN devem usar a mesma porta para participar do mesmo grupo lógico de peers (portas diferentes = grupos isolados).

Mesmo computador

Execute duas instâncias com portas diferentes (ex.: 5000 e 5001). Mesmo nome de usuário em duas instâncias pode confundir a lista — use nomes distintos.

Firewall e Wi‑Fi

Bloqueio de multicast em redes de visitantes ou isolamento AP→AP impede descoberta.
Em laboratório, preferir cabo ou Wi‑Fi com multicast habilitado.

WSL2

Executar o Pitiupi no WSL e peers no Windows (ou vice-versa) pode falhar em multicast. Preferir:

todos os peers no mesmo ambiente (Linux nativo ou VMs), ou
dois PCs físicos na mesma sub-rede.

Escolha de interface (multicast)

O núcleo associa o socket multicast à interface de rede preferida: cabo (Ethernet) antes de Wi‑Fi; em cabo com link-local APIPA, prioriza IPv4 169.254.*. Isso não substitui a exigência de mesma sub-rede entre os dois PCs — 169.254.x e 192.168.x ao mesmo tempo em hosts diferentes não compartilham heartbeat.

IP do peer na UI (Windows)

Ao abrir conversa pela lista de presença, o campo de destino usa PeerIpv4: IPv4 pontilhado legível, sem forma IPv6-mapeada (::ffff:…) nem sufixo de zona (%7). Ver decision-register.md (D22).

Dois PCs na mesma Wi‑Fi

Mesma porta no login (ex.: 5000 nos dois). Portas diferentes isolam a sala.
Configurações → Sua conexão: IPs na mesma sub-rede (ex. ambos 192.168.0.x ou 192.168.1.x). Se um for 172.x (WSL/Docker) e outro 192.168.x, o multicast entre esses hosts não cruza.
Firewall: liberar UDP entrada e saída na porta do login (Windows Defender / ufw).
Roteador: desativar isolamento de clientes / AP isolation / Wi‑Fi de visitantes.
Aguardar até ~15 s após abrir os dois apps (heartbeat a cada 5 s).

Sintomas

Sintoma	Verificar
Lista só com Todos, sem peers	Porta igual? Mesma sub-rede? Firewall UDP? AP isolation? WSL num dos PCs?
Plugin não recebe	Desserialização / SPI / JAR em `PITIUPI_HOME/plugins`
TCP falha	Peer visível na lista? IP correto?

2.6 KiB Raw Blame History Unescape Escape