Antes dos números
A exclusão é de melhor esforço. Ela vale nos peers que seguem o protocolo. Um peer que já recebeu uma chave de entrada pode guardá-la, e cópias antigas de um disco ainda podem guardar uma chave excluída. Veja Exclusão.
O Kolo só aceita IPv4: endereços IPv6 são recusados, incluindo a forma v4-mapped. Todas as bibliotecas são experimentais.
kolo-id
| Limite | Valor |
|---|---|
| Seed | exatamente 32 bytes |
| Arquivo de chave | arquivo regular de exatamente 32 bytes |
| Contexto de assinatura | de 1 a 255 bytes |
Chave pública para Verify | 32 bytes |
Chaves de ordem pequena recusadas por Verify | todas as 14 codificações |
| Modo do arquivo de chave | 0600 |
| Modo de um novo diretório pai | 0700 |
| Frase de recuperação | exatamente 24 palavras da lista em inglês do BIP-39, só ASCII; ParsePhrase lê no máximo 1024 bytes |
| Certificado | no máximo 256 bytes, ou 514 com um pai aprovador |
| Oferta de certificado | no máximo 450 bytes, 192 sem pai |
| Revogação | no máximo 472 bytes, 182 quando a chave da pessoa ou o próprio dispositivo assina |
| Arquivo de certificado | de 1 a 514 bytes, modo 0600 |
| Cadeia de certificados | no máximo 2 certificados (pessoa, aprovador, dispositivo); um aprovador não pode emitir outro aprovador |
| Número de série de um certificado | pelo menos 1 |
Contextos que começam com kolo-id/device- | recusados por Sign (ErrInvalidContext) e por VerifyDevice |
Trabalho de um VerifyDevice | no máximo 4 assinaturas de certificado e 1 assinatura de mensagem, mais um trabalho linear na lista de revogações |
Veja kolo-id, Bom saber.
kolo-codec
| Limite | Valor |
|---|---|
| Varint | no máximo 10 bytes, 64 bits |
Bytes(max), String(max) | tamanho de no máximo max, verificado antes da alocação |
UvarintMax(max) | valor de no máximo max |
| Bool | um byte, 0 ou 1 |
Veja kolo-codec, Bom saber.
kolo-log
| Limite | Valor |
|---|---|
| Tamanho da entrada, 64 bits | cerca de 254 GiB |
| Tamanho da entrada, 32 bits | cerca de 512 MiB |
| Menor entrada com preenchimento | 256 bytes (entradas de até 254 bytes) |
| Entrada em disco | um frame de 256 bytes e 296 bytes de texto cifrado guardado para entradas de até 254 bytes |
| Preenchimento das entradas maiores | Padmé, no máximo cerca de 6% a mais |
| Memória por entrada | cerca de 64 bytes de hashes da árvore e 144 bytes de registro, seja qual for o tamanho da entrada |
| ID do log | 32 bytes, aleatório |
| Hash da árvore | 32 bytes (BLAKE2b-256) |
| Caminho de prova | no máximo 65 hashes |
| Entrada JSON | no máximo 4 KiB, 8 KiB para provas |
| Logs graváveis por (chave do autor, ID do log) | 1 por processo (ErrLogOpen) |
Logs por Storage | 1: New e NewReplica retornam ErrStorageNotEmpty para um armazenamento que já guarda uma entrada |
AddKeys | no máximo MaxAddKeys, 32.768 chaves por chamada; mais é ErrTooManyKeys |
EntrySecret (chaves derivadas) | 32 bytes aleatórios uniformes |
Veja kolo-log, Bom saber.
kolo-store
| Limite | Valor |
|---|---|
| Diretório do store | criado com modo 0700, acesso do grupo ou de outros recusado |
| Modo dos arquivos do Pebble | 0600 para todo arquivo que o Pebble cria no diretório |
PebbleOptions.MemTableSize | 0 (os 4 MiB do Pebble) ou de 1 MiB a 1 GiB, senão ErrInvalidOptions; memória de até o dobro do tamanho |
| Logs abertos por ID de log | 1 por backend em um processo (ErrLogInUse) |
| Logs por ID de log em um store | 1, seja quem for o dono; um ID guardado para outro dono retorna kololog.ErrBadLogHeader |
| Memória por log ou réplica aberta | cerca de 250 bytes por entrada, seja qual for o tamanho da entrada |
Lote de um Adopt | menos de 2 GiB (1 GiB em 32 bits), contado como o Pebble conta um lote; ErrTooLarge a partir de 2 GiB. Ele retém as entradas que adiciona, e o Pebble uma segunda cópia |
| Lote do Pebble | menos de 4 GiB - 1 bytes (2 GiB - 1 em 32 bits); ErrTooLarge caso contrário |
| Registro, head ou marcador de exclusão guardado | no máximo 1024 bytes |
| Chave de entrada guardada | exatamente 32 bytes; ausente em uma entrada excluída e em uma entrada de réplica recebida sem a sua chave (só uma entrada viva de um log próprio sem a sua chave é ErrCorrupt) |
| Head de atualização de uma réplica | no máximo 1024 bytes |
| Prova de atualização de uma réplica | no máximo 65 hashes |
| Versão do valor de entrada guardado | 3 (versões 1 e 2 recusadas) |
Veja kolo-store, Bom saber.
kolo-sync
| Limite | Valor |
|---|---|
MaxMessageSize | 4 MiB, prefixo de tamanho verificado antes da alocação |
| Entrada cujo texto cifrado com preenchimento não cabe em uma mensagem | não pode ser sincronizada nem buscada com Fetch (ErrTooLarge), excluída ou não, e o log não sincroniza além dela |
MaxStreams | 16 por conexão, de pull ou de fetch, os outros recebem “ocupado” |
ServerOptions.MaxTotalStreams | 256 (DefaultMaxTotalStreams) somando todas as conexões, os outros recebem “ocupado” (ErrBusy no cliente) |
ServerOptions.MaxAnswerBytes | 256 MiB (DefaultMaxAnswerBytes), pelo menos 2 x MaxMessageSize, somando todas as conexões; uma resposta conta o dobro do seu tamanho, e a que não cabe recebe “ocupado” |
Timeout | 60s para abrir um stream, para o início de cada leitura ou escrita de mensagem, e por espera de uma requisição; uma mensagem de n bytes pode levar outros n a MinRate |
MinRate | 16 KiB/s, a velocidade média mínima de uma mensagem |
| Resposta a uma requisição de entradas | cerca de 1 MiB; uma entrada maior vai sozinha, até MaxMessageSize |
PullOptions.InFlight | de 1 a 8 (MaxInFlight); qualquer outro valor é ErrInvalidArgument. Com um peer que envia em streaming, o máximo de pedidos de crédito que um pull mantém esperando, 8 se for 0; com um peer mais antigo, as respostas pedidas e ainda não guardadas, 3 (DefaultInFlight) se for 0 |
| Crédito de um pull em streaming | 2 MiB por pedido, de 2 pedidos até InFlight esperando; um servidor guarda no máximo 64 MiB de crédito por stream |
| Respostas que um pull retém sem guardar ainda | 6 MiB no máximo; um commit guarda as respostas que esperam até 4 MiB |
| Entradas que uma resposta STATE olha | no máximo 32.768 (MaxMessageSize / 128), depois quem faz o pull pede o resto; ela lê só marcadores de exclusão e chaves, nunca um texto cifrado |
| Head, cabeçalho, registro, marcador ou prova na rede | no máximo 4 KiB cada |
| Chave de entrada na rede | 0 ou 32 bytes |
Memória do Fetch | o intervalo pedido, no máximo uma mensagem a mais |
Veja kolo-sync, Bom saber.
kolo-kv
| Limite | Valor |
|---|---|
MaxKeySize | 32 KiB (a chave vazia é válida) |
MaxValueSize | 1 MiB |
| Valores de uma chave | quando uma chave tem 65.536 valores desde a sua última exclusão, o próximo Put primeiro exclui esses valores |
| Entradas listadas por uma entrada de exclusão | de 1 a 65.536 |
| Destruição das entradas listadas | um único Log.Delete, uma única gravação durável |
| Memória | o índice (cada chave viva e o número da sua entrada); os valores são lidos do armazenamento quando pedidos |
Veja kolo-kv, Bom saber.
kolo-braid
Um campo zerado recebe o seu padrão. Um valor fora da sua faixa retorna ErrInvalidConfig para GroupConfig, fixado pela entrada genesis, ou ErrInvalidArgument para os Limits locais.
| Limite | Valor |
|---|---|
GroupConfig.MaxMembers | 64, de 2 a 1024 |
GroupConfig.MaxSettlers | 7 ou MaxMembers se for menor, de 1 a 64 |
GroupConfig.MinSettlers | 4 ou MaxSettlers se for menor, de 1 a MaxSettlers |
GroupConfig.MaxBody | 1 MiB, de 1 KiB a 3 MiB |
GroupConfig.CheckpointEvery | 1024 posições assentadas, de 64 a 2^20 |
Limits.MaxTail | 2048 entradas, de 64 a 2^20 |
Limits.MaxPendingBytes | 16 MiB, de 1 MiB a 1 GiB; um strand guarda no máximo MaxPendingBytes / MaxMembers deles, uma entrada sempre cabe |
Limits.MaxForks | 4, de 1 a 64: os segundos históricos de um strand que um peer guarda; as entradas do próximo são recusadas e deixam de ser buscadas |
Limits.PulseGap | 500 ms, de 10 ms a 1 min |
Limits.PivotWait | 3 s, de 100 ms a 5 min |
Limits.AnnounceGap | 100 ms, de 10 ms a 10 s |
Limits.ConfirmWait | 10 s, de 1 s a 5 min |
Limits.MaxEvents | 1024, de 16 a 2^16 |
| Chave e valor da visão | 32 KiB e 1 MiB |
| Escritas de uma entrada | 16 x MaxBody, e cada operação custa a sua chave e o seu valor mais 256 bytes |
| Tag do app | de 1 a 64 bytes de UTF-8 |
| Pedido de entrada e welcome | 64 KiB e 1 MiB |
| Mensagem de stream | 4 MiB |
| Pulls ao mesmo tempo | 16, um por strand |
| Resposta a um pedido, chave desconhecida | 60 s, depois a conexão é fechada |
| Disco por entrada | cerca de 600 bytes em cada peer; o histórico nunca é podado |
O pacote devices recebe devices.Options. Os três primeiros são limites do apply, então todos os peers de um grupo devem usar os mesmos valores.
| Limite | Valor |
|---|---|
MaxCertsPerPerson | 1024, de 1 a 2^20: os certificados de uma pessoa em uma visão |
PersonCertReserve | um oitavo de MaxCertsPerPerson (128), de 0 a MaxCertsPerPerson, -1 para nenhum: vagas reservadas para certificados emitidos pela chave da pessoa |
MaxRevocationsPerDevice | 64, de 1 a 2^16: revogações de aprovador de uma chave de dispositivo |
MaxDevices | nenhum por padrão (as vagas MaxMembers do grupo são o único limite); um teto opcional de dispositivos de uma pessoa que Admit deixa entrar, ErrTooManyDevices acima dele |
| Certificado, oferta, revogação | 514, 450 e 472 bytes, as codificações da kolo-id |
| Pedido de entrada com prova | 64 KiB; uma prova tem menos de 700 bytes |
Veja kolo-braid, Bom saber.
kolo-transport
| Limite | Valor |
|---|---|
Network | só "udp4" |
MaxConns | 100, de 1 a 10000 |
MaxConnsPerIP | 4 (ou MaxConns, se for menor), de 1 a MaxConns |
MaxDialed | 32, de 1 a 10000 |
MaxIncomingStreams | 16 de cada tipo por conexão, de 1 a 1000 |
HandshakeTimeout | 10s, de 1s a 60s (também a validade de um token de Retry) |
IdleTimeout | 30s, de 1s a 10m |
| Tempo de inatividade do peer, considerado no mínimo | 5s |
KeepAlivePeriod | 5s (ou IdleTimeout/2, se for menor), de 500ms até abaixo de IdleTimeout |
MaxStreamReceiveWindow | 256 KiB, de 64 KiB a 16 MiB |
MaxConnReceiveWindow | 512 KiB, de 64 KiB a 64 MiB |
MaxMemory | 1 GiB, de 64 MiB a 64 GiB |
CongestionControl | "reno" (padrão), "cubic" ou "bbr"; qualquer outro valor é ErrInvalidConfig |
WindowGrowth | desligado; ligado, Conn.AllowWindowGrowth deixa as janelas de uma conexão crescerem |
MaxGrownStreamReceiveWindow | 4 MiB, de MaxStreamReceiveWindow a 16 MiB (só com WindowGrowth) |
MaxGrownConnReceiveWindow | 8 MiB, de MaxConnReceiveWindow a 64 MiB (só com WindowGrowth) |
MaxGrownMemory | 64 MiB, de 1 MiB a 64 GiB, compartilhado pelas conexões de um Listener (só com WindowGrowth) |
| Amostras do BBR | no máximo 40000 números de pacote, cerca de 5,5 MiB por conexão BBR; as amostras mais antigas são descartadas |
| Fila de accept | 32 conexões |
MaxPacketSize (datagramas que não são QUIC) | 1200 bytes |
| Fila de datagramas que não são QUIC | 32 datagramas |
MaxCode | 2^62-1 |
Mensagem de CloseWithError | no máximo 256 bytes |
Saída de ExportKey | 32 bytes |
| Validade de um token NEW_TOKEN | 1ns |
Listener.Close em uma conn que ignora deadlines | 1s |
Datagramas de ListenConn | no mínimo 1280 bytes; acima de 1452, truncados |
Veja kolo-transport, Bom saber.
kolo-secure
| Limite | Valor |
|---|---|
HandshakeTimeout | 10s depois do handshake QUIC, de 1s a 60s |
MaxPending | 64 por listener, de 1 a 1000 |
| Mensagem do handshake | corpo de 1 a 256 bytes, tamanho de no máximo 2 bytes |
| Maior mensagem real do handshake | 98 bytes |
Chave remote | 32 bytes |
| Codificações de ordem pequena recusadas | 14 |
| Outras chaves que quem tem uma chave consegue provar | até 7 |
| Valor do exporter | 32 bytes |
| Código de close de um handshake que falha | 1 |
Veja kolo-secure, Bom saber.
kolo-dht
| Limite | Valor |
|---|---|
MaxRecords | 65536 por servidor, de 16 a 1.000.000 |
MaxRecordsPerTopic | 512, de 1 a 65536 (um dezesseis avos por /24 IPv4) |
MaxRecordsPerIP | 256, de 1 a 65536 |
MaxAnnouncements | 16, de 1 a 256 |
MaxInflight | 160, de 8 a 4096 |
MaxRelays | 64, de 1 a 4096 |
MaxPunches | 16, de 1 a 256 (conexões de birthday punch: 4 por /24) |
MaxRequestsPerIP | 50/s, de 1 a 10.000 |
MaxRequestsPerPrefix | 200/s por /24, de MaxRequestsPerIP a 100.000 |
MaxRequests | 10.000/s, de MaxRequestsPerPrefix a 1.000.000 |
| ANNOUNCE que custam uma verificação (por segundo: por endereço IPv4, por /24, no total) | 20, 100, 1000, ou os limites de requisições acima, se menores |
RequestTimeout | 1s, de 100ms a 10s |
| Requisições com falha antes de uma entrada da tabela ser descartada | 4 seguidas |
PunchTimeout | 45s, de 1s a 2m |
MaxRandomPunches | 1, de 1 a 16 |
MaxRandomPunchesPerTarget, MaxRandomPunchesPerRequester | 1, de 1 a MaxRandomPunches |
RandomPunchInterval | 20s, de 1s a 10m |
RandomPunchCooldown | 1m, de 1s a 1h, dobra até chegar a 16 vezes esse valor |
MaxRandomPunchesPerMinute | 4, de 1 a 64 |
MaxPunchSockets | 256 ou metade do limite flexível de RLIMIT_NOFILE, de 1 a 16384 |
KeepAlivePeriod das conexões feitas por punch | 5s, a não ser que IdleTimeout seja de 5s ou menos |
Fila de Accept | Secure.MaxPending, 64 por padrão |
| Datagrama | no máximo 1200 bytes |
| Resposta | no máximo 20 nós e 16 registros |
| Tabela de roteamento | 256 buckets de 20; por /24, 2 em um bucket e 10 no total |
| Registro | renovado a cada 15s, descartado 20 minutos depois da última renovação |
| Busca | 10 servidores ao mesmo tempo, 100 no total, 160 verificações de assinatura |
Relays por Connect | 3 |
Endereços de Bootstrap | 64 |
| Token de ida e volta | aceito por 40 a 80s |
| IDs de nó por endereço IPv4 | 8 |
Veja kolo-dht, Bom saber.
kolo-swarm
| Limite | Valor |
|---|---|
MaxPeers | 64, de 1 a 1024 |
MaxInbound | MaxPeers/2 arredondado para cima (32), de 1 a MaxPeers |
MaxTopics | 16, de 1 a 32 |
| Topics por hello | 32 |
MaxConnecting | 3, de 1 a 16 |
| Conexões em abertura por relays ao mesmo tempo | até MaxConnecting, contadas à parte das chamadas a Connect do kolo-dht |
Config.Relays | vazia por padrão, no máximo 16 relays |
| Primeiro contato por um relay | depois de até 3 x PunchTimeout do kolo-dht (135s), e então no máximo 60s por relay tentado |
MaxHandshakes | 16, de 1 a 256 |
MaxHandshakesPerIP | 4 (ou MaxHandshakes, se for menor), de 1 a MaxHandshakes |
| Hellos ao mesmo tempo por chave | 2 |
MaxCandidates | 1024, de 16 a 32768 |
MaxEvents | 64, de 16 a 4096 |
HelloTimeout | 10s, de 1s a 60s (2s por etapa) |
LookupInterval | 10m mais até um quinto disso ao acaso, de 1s a 1h |
RetryMin | 1s, de 100ms a 1m |
RetryMax | 10m, de RetryMin a 1h |
| Conexão que zera a contagem de falhas | dura 15s |
| Conexões em abertura ao mesmo tempo por host | 2 |
| HELLO, REPLY | no máximo 1026 e 1044 bytes |
BootstrapNodes | vazia por padrão, o que significa os nós de entrada públicos embutidos; no máximo 16 entradas (o mesmo limite do kolo-node) |
| Endereços por nome de bootstrap, no total | 8 por nome, 64 no total |
| Resolver um nome de bootstrap | 5s por nome, em paralelo, dentro do ctx |
Arquivo do LoadNodes | um arquivo regular de no máximo 64 KiB |
Veja kolo-swarm, Bom saber.
kolo-relay
| Limite | Valor |
|---|---|
MaxReservations | 64, de 1 a 100000 |
MaxSessions | 16, de 1 a 10000 |
MaxSessionsPerPeer | 4 (ou MaxSessions, se for menor) |
MaxSessionsPerTarget | 8 (ou MaxSessions, se for menor) |
ReservationLifetime | 1h, de 1s a 24h |
MaxSessionDuration | 1h, de 1s a 24h |
MaxSessionBytes | 1 GiB em cada sentido, de 64 KiB a 1 TiB |
SessionIdleTimeout | 60s, de 1s a 10m |
ConnectTimeout | 15s, de 1s a 60s |
ControlTimeout (relay) | 15s, de 1s a 60s |
RateBytes | 1 MiB por segundo por conexão de cliente, de 16 KiB a 1 GiB |
RateBurst | 256 KiB, de 16 KiB a 64 MiB |
FlushInterval | 1ms, de 100µs a 100ms |
Listener do relay com Secure nil | MaxConns 128, MaxConnsPerIP 4, MaxDialed 1, MaxIncomingStreams 2, janelas de 64 KiB e 256 KiB |
ControlTimeout (cliente) | 20s, de 1s a 60s |
MaxPending (cliente) | 16, de 1 a 256 |
SendQueue (cliente) | 512 pacotes, de 8 a 1024 |
HandshakeTimeout em Peer quando zerado | 10s |
| Espera do alvo por um peer anunciado | 40s com os padrões |
| Mensagem de controle | no máximo 64 bytes |
| Frame de pacote | no máximo 1452 bytes |
| Buffer de cópia | 64 KiB por sentido |
| Pacotes internos | 1280 bytes |
Reservation.Close, Conn.Close | cerca de 2s |
Server.Close por iniciador | até 1s |
Veja kolo-relay, Bom saber.
kolo-invite
| Limite | Valor |
|---|---|
Campo de Options zerado ou negativo | zerado usa o valor padrão, negativo é ErrInvalidArgument |
Timeout | 30s |
| Fechamento de uma conexão ociosa que é só de convite | entre Timeout e 1,25 vezes Timeout |
MaxData | 64 KiB, no máximo 1 GiB |
MaxPending | 1024 |
MaxPendingPerSource | 16 |
PendingTTL | nenhum; um pedido Manual que esperou esse tempo é retirado, como se quem pediu tivesse ido embora |
MaxPendingDevices | 4 pedidos pendentes de vincular um dispositivo, somando todos os convites de dispositivo; os outros recebem ErrBusy |
MaxDeviceName | 64 bytes, de 1 a MaxData |
DevicePendingTTL | 2 minutos; depois o pedido é retirado e o código é queimado |
DeviceOptions.TTL | 5 minutos, quanto tempo um código de dispositivo dura |
DeviceJoinOptions.MaxName, MaxPayload | 64 bytes e 4096 bytes no dispositivo novo |
MaxStreams | 8 por conexão |
SourceRate | 60 por minuto por origem, rajadas de até 60 |
InviteRate | 600 por minuto por convite, rajadas de até 600 |
MaxSources | 4096 |
MaxEvents | 1024 |
JoinOptions.MaxPayload | 1 MiB |
CreateOptions.TTL | zerado nunca expira |
CreateOptions.MaxUses | zerado quer dizer 1, sem limite superior |
CreateOptions.Payload | no máximo 1 GiB, vazio com Manual |
| Carga útil e dados de entrada | no máximo 1 GiB |
| Frames OPEN e CHALLENGE | no máximo 64 bytes |
| Outros frames | no máximo max(512, Padmé(n + 256)) + 256 bytes, n é MaxData ou MaxPayload |
| Texto claro preenchido | pelo menos 512 bytes, Padmé acima disso |
| Respostas de um mesmo tamanho | carga útil de até 508 bytes |
| Código | 92 caracteres, prefixo koloinv0, todo em minúsculas ou todo em maiúsculas |
| Impressão digital, segredo, soma de verificação | 16, 32 e 4 bytes |
| Desafio | 32 bytes por stream |
Linger | 5 minutos |
Nova tentativa de Announce | espera que cresce de 1s até 1 minuto |
| Topics de convite | dividem o MaxTopics do swarm (16, no máximo 32) |
Pedidos encerrados que Approve e Deny lembram | os últimos MaxPending |
| Registro de convite | cerca de 100 bytes mais a carga útil |
| Espera de quem entra com os padrões da kolo-swarm | até uns 12 minutos |
Veja kolo-invite, Bom saber.
kolo-moq
Um campo em zero assume o padrão, e um valor fora da faixa é ErrInvalidConfig.
| Limite | Valor |
|---|---|
SetupTimeout, RequestTimeout | 10s cada um, de 1s a 10m |
MaxRequests, MaxSubscriptions | 1000 cada um, de 1 a 1000000; os que passam desse número recebem EXCESSIVE_LOAD |
MaxObjectSize (um payload recebido do peer) | 16 MiB, de 1 KiB a 1 GiB |
MaxControlMessageSize | 65535, de 8192 a 65535 |
MaxNamespaceFields, MaxNameLength | 32 campos, 4096 bytes: os limites do draft, que só podem ser baixados |
MaxBufferedGroups (uma assinatura, nos dois lados) | 64, de 1 a 1000000 |
MaxBufferedBytes (uma assinatura, nos dois lados) | 32 MiB, ou MaxObjectSize se for maior, até 64 GiB |
MaxNamespaces (uma assinatura de namespaces) | 1000, de 1 a 1000000 |
MaxFetchBytes | MaxBufferedBytes, de MaxObjectSize a 64 GiB; um FETCH além dele é recusado com EXCESSIVE_LOAD, um preenchimento é pulado e um FETCH repassado é reiniciado |
OriginConfig.MaxTracks | 1000, de 1 a 1000000 |
OriginConfig.MaxObjectSize (um payload escrito no origin) | 16 MiB, de 1 KiB a 1 GiB |
TrackOptions.Priority | 128 (DefaultPriority), de 0 a 255; menor é mais urgente |
TrackOptions.CacheGroups, CacheBytes | 16 grupos, 32 MiB; de 1 a 1000000 grupos, de 1 KiB a 64 GiB |
| Timeouts de entrega | nenhum; um valor abaixo de 1 ms é arredondado para cima, para 1 ms |
RelayConfig.MaxTracks | 1000, de 1 a 1000000 |
RelayConfig.MaxSessionTracks | MaxTracks dividido por 10, no mínimo 1; os que passam desse número recebem EXCESSIVE_LOAD |
RelayConfig.MaxSessionFetches | 16, de 1 a 1000000; os que passam desse número recebem EXCESSIVE_LOAD |
RelayConfig.Resume | 0 (desligado), de 1s a 1h: quanto tempo um relay guarda os anúncios de um publicador cuja conexão foi perdida ou que chamou Session.Suspend |
RelayConfig.MaxResumeHeld | 10000, de 1 a 1000000: anúncios guardados ao mesmo tempo para sessões encerradas; um que não cabe é retirado com a sua sessão |
RelayConfig.MaxPeerResumeHeld | o MaxRequests da sessão (1000), ou MaxResumeHeld se for menor, de 1 a MaxResumeHeld: anúncios guardados para uma chave de peer |
NewGroupRequestInterval | 1s por assinatura entre duas chamadas a RequestNewGroup; uma mais cedo é ErrNewGroupTooSoon; um track avisa em TrackWriter.NewGroupRequests no máximo uma vez a cada 1s, qualquer que seja o número de assinaturas |
RelayConfig.CacheGroups, CacheBytes | como em TrackOptions, para cada track repassado |
KeyringConfig.Retain, RetainMax | 450 ms, até 1 m; Retain mais 400 ms, de Retain a 2 m. Por quanto tempo uma chave substituída ainda abre objetos |
KeyringConfig.MaxSenders | 64, de 1 a 1024; mais chamadas a Receive falham com ErrTooManySenders |
KeyringConfig.MaxKeyRate | 64 mensagens de chave por namespace e segundo, de 1 a 1024; as demais são descartadas e contadas |
KeyringConfig.ReplayGroups, ReplayObjects | 64 grupos e 8192 entradas por Opener, de 1 a 1000000 |
SenderConfig.MaxTracks | 1024, de 1 a 1000000; mais um track faz a rotação da chave |
| Texto claro selado com uma chave de track | 2^24 unidades de 16 KiB, e depois o Sender faz a rotação |
| Object ID de um objeto selado, namespace de um broadcast protegido | menor que 2^32; de 1 a 31 campos, com o nome completo do track de chaves dentro de 4096 bytes |
Frase de motivo e PeerImplementation de um peer | no máximo 1024 bytes, escapados; o motivo nunca vai em Error() |
Custo de um objeto para o MaxBufferedBytes e o cache | o payload, 48 bytes por propriedade e 64 bytes |
| Payload de mais de 64 KiB | lido conforme chega |
| IDs de pedido conferidos contra repetição | os últimos 65536 números; os mais antigos contam como repetidos |
| Stream sem avanço | reiniciado depois de RequestTimeout |
MaxIncomingStreams da kolo-transport | 16 por padrão, de 1 a 1000; aumente até as assinaturas que você espera |
Veja kolo-moq, Bom saber.
kolo-media
Um campo em zero de uma config assume o padrão.
| Limite | Valor |
|---|---|
CatalogLimits.MaxTracks | 1024 |
CatalogLimits.MaxNameLen | 4096 bytes |
CatalogLimits.MaxConfigLen | 65508 bytes, a maior config que cabe em uma propriedade de objeto |
| Tamanho do catálogo | precisa caber no MaxObjectSize do origin, 16 MiB na kolo-moq; senão, ErrInvalidCatalog |
| Tracks de mídia de um origin padrão | 999, porque o track de catálogo conta para o MaxTracks do origin; depois, ErrTooManyTracks |
CatalogPriority, AudioPriority, VideoPriority | 28, 48, 68; um número menor é enviado antes |
MediaGroupTimeout | 30s |
PlayoutConfig.MinDelay | 100 ms |
PlayoutConfig.MaxDelay | 400 ms, ou MinDelay se for maior |
PlayoutConfig.MaxBehind | 50 ms |
PlayoutConfig.MaxFrames | 8192 por track |
PlayoutConfig.MaxBytes | 16 MiB por track |
| Objetos de vídeo retidos | os mesmos dois limites de novo, contados à parte: até o dobro de cada um, 32 MiB por padrão |
Tracks de áudio em um Playout | 1 |
| Janela da referência | as últimas 2 s de chegadas, no máximo 8192 |
| Frame adiantado em relação à referência | descartado se estiver mais de 2 s adiantado |
| Espera de um objeto protegido pela sua chave | MaxDelay, 400 ms por padrão |
| Objetos retidos de um track protegido | os mesmos dois limites de novo, até três vezes cada um com o montador de grupos e o playout, 48 MiB por padrão |
Objeto de catálogo retido de um Watch protegido | 1, até chegar a chave dele ou uma versão mais nova o substituir |
| Custo extra de um objeto de áudio protegido | 24 bytes, 9,6 kbit/s a 50 objetos por segundo; menos de 1 por cento no vídeo |
| Memória de um participante remoto protegido com áudio e vídeo | até 80 MiB na kolo-media, mais o MaxBufferedBytes da kolo-moq para cada uma das suas assinaturas |
| Primeiro frame com um timestamp muito adiantado | o track fica em silêncio por 2 a 3 s e depois toca |
Pedidos de keyframe (WatchOptions.RequestKeyframes) | após 500 ms sem frames, depois 1 s, 2 s, 4 s e 8 s; após cinco pedidos por silêncio, nenhum até 30 frames seguidos ou uma perda. Um pedido sem resposta é repetido após 1 s, 2 s, 4 s e 8 s, e cinco seguidos encerram os pedidos até um frame tocar |
Veja kolo-media, Bom saber.
kolo-audio
Um valor fora do intervalo retorna ErrInvalidConfig, ErrInvalidArgument ou ErrUnsupportedFormat.
| Limite | Valor |
|---|---|
Format.SampleRate | 48000 Hz por padrão, de 8000 a 384000 Hz |
Format.Channels | 1 por padrão, de 1 a 254 |
Config.Period | 10 ms, pelo menos um frame e no máximo Buffer |
Config.Buffer | 120 ms, de Period a 2 s |
Config.StallTimeout | 12 s, maior que Period |
| Taxa de amostragem do Opus | 8000, 12000, 16000, 24000 ou 48000 Hz |
| Canais do Opus | 1 ou 2 |
| Bitrate do Opus | de 500 a 512000 bit/s, 0 deixa a libopus escolher |
| Complexidade do Opus | de 1 a 10, 0 mantém o padrão da libopus, 9 |
| Perda de pacotes do Opus | de 0 a 100 por cento |
CBR do Opus | ligado ou desligado; cada pacote tem (bitrate * duração do frame + 4) / 8 bytes, pelo menos 1 |
| Duração do frame do Opus | 2,5, 5, 10, 20, 40 ou 60 ms, 20 ms por padrão |
opus.PacketBufferSize | 4000 bytes |
opus.MaxPacketDuration | 120 ms |
| Maior pacote Opus aceito | 61296 bytes; um maior é ErrInvalidPacket |
DecodeLost, DecodeFEC | um múltiplo de 2,5 ms, no máximo 120 ms |
| Módulo da libopus | 1 MiB de memória e uma pilha de 256 KiB, para cada codificador ou decodificador |
| Módulo do resampler | 512 KiB de memória |
| Memória de um par codificador e decodificador | cerca de 0,8 a 0,9 MB |
| PulseAudio | cada requisição, conexão e escrita 30 s; frames de até 16 MiB; no máximo 32 canais; versões do protocolo de 21 a 32 |
| WASAPI | 5 novas tentativas após uma troca de rota, de 100 ms a 1600 ms, 3,1 s no total |
| ALSA | a reprodução é mantida cheia até 3 períodos |
RequestAccess | sem timeout próprio: o aviso espera a pessoa, o ctx de quem chama limita a espera e ctx.Err() é retornado quando ele termina |
Veja kolo-audio, Bom saber.
kolo-video
Um valor fora do intervalo retorna ErrInvalidConfig ou ErrInvalidFrame. Os tempos foram medidos em um Apple M5 e em uma VM de Windows 11 ARM64.
| Limite | Valor |
|---|---|
| Largura e altura de um frame | de 1 a 65536 |
CaptureConfig.Width, Height | 640 x 480 por padrão, no máximo 65536 |
CaptureConfig.FrameRate | 30 fps, de MinFrameRate (um frame por hora) a MaxFrameRate (1000) |
CaptureConfig.Buffer | 2 frames; quando enche, o mais antigo é descartado |
CaptureConfig.StallTimeout | 2 s, um valor negativo desativa |
CaptureConfig.MaxPixels | 8.912.896 |
| Enumeração de V4L2 e Media Foundation | 1024 entradas |
| Tamanho de um frame VP8 | de 1 a 16383 |
| Tamanho de um frame VP9 | de 1 a 65536 |
vpx.Config.FrameRate | 30 fps, de MinFrameRate a MaxFrameRate |
vpx.Config.Bitrate | 0,07 bits por pixel por frame, cerca de 4,4 Mbit/s a 1080p30 |
vpx.Config.KeyframeInterval | 2 s nos timestamps dos frames, negativo para keyframes só sob pedido |
vpx.DecoderConfig.MaxPixels | 8.912.896, conferido em cada cabeçalho de frame |
vpx.DecoderConfig.MaxPacketBytes | 16 MiB, no máximo 256 MiB (ErrTooLarge), verificado antes de copiar o pacote |
Buffer de pacotes do vpx.Decoder | no máximo 1 MiB mantido entre chamadas |
| Motor native, tempo real | 1920x1080 a 30 fps, codificar e decodificar |
| Motor portable, tempo real | codificar até 640x480 a 30 fps, decodificar até 1920x1080 |
| Memória do motor portable | no máximo 1 GiB por instância |
Tamanho de h264.Config | par, de 48 a 4096 por lado, no máximo 36864 macroblocos |
Macroblocos por segundo de h264.Config | no máximo 983040 (1920x1080 até 120 fps, 3840x2160 até 30 fps) |
h264.Config.Bitrate | 0,07 bits por pixel por frame, de 1 a 240.000.000 bit/s |
h264.Config.KeyframeInterval | 2 s nos timestamps dos frames, negativo para keyframes só sob pedido |
| Nível de saída do H.264 | no máximo 5.1 (Tabela A-1 da especificação H.264) |
| Perfis do H.264 | Constrained Baseline (padrão), Main e High; profile_idc 66, 77 e 100 no decodificador |
h264.DecoderConfig.MaxPixels | 9.437.184 (36864 macroblocos), no máximo esse valor |
h264.DecoderConfig.MaxPacketBytes | 16 MiB, no máximo 256 MiB |
| Unidades NAL em um pacote H.264 | no máximo MaxPixels / 256 + 288 |
| Imagem do decodificador H.264 | cada lado de 48 a 4096 após o recorte, no máximo 543 macroblocos por lado, dentro do nível declarado |
| Níveis do decodificador H.264 | level_idc de 9 a 51, níveis de 1 a 5.1 |
| Imagens em um pacote H.264 | 1 |
| Tempo de codificação H.264 no Windows | 1280x720 16,1 ms de mediana, 1920x1080 27,0 ms de mediana, uma execução com as transformações por software |
Veja kolo-video, Bom saber.
kolo-node
| Limite | Valor |
|---|---|
-listen | :7447 |
Arquivo de -config | um único objeto JSON de no máximo 64 KiB |
-bootstrap | host:port separados por vírgulas, repetível; com -bootstrap-file e KOLO_BOOTSTRAP no máximo 16 entradas distintas, 8 endereços por nome, 64 no total |
-bootstrap-file | um arquivo de texto de no máximo 64 KiB, um host:port por linha, repetível |
-first | falso; verdadeiro significa sem nós de entrada, recusado com -bootstrap ou -bootstrap-file |
KOLO_BOOTSTRAP | não definida; só é lida quando -bootstrap, -bootstrap-file e -first estão todos sem definição |
| Resolução de nomes | 5s por nome |
Bootstrap | 30s |
-stats-interval | 5m, de 1s a 24h |
-dht-max-records | 65536, de 16 a 1.000.000 |
-dht-max-records-per-topic | 512, de 1 a 65536 |
-dht-max-records-per-ip | 256, de 1 a 65536 |
-dht-max-inflight | 160, de 8 a 4096, no mínimo 75 com -bootstrap |
-dht-max-relays | 64, de 1 a 4096 |
-dht-max-requests-per-ip | 50/s, de 1 a 10.000 |
-dht-max-requests-per-prefix | 200/s, até 100.000 |
-dht-max-requests | 10.000/s, até 1.000.000 |
-dht-request-timeout | 1s, de 100ms a 10s |
-dht-punch-timeout | 45s, de 1s a 2m |
relay -listen, relay -identity | obrigatórios; o kolo-relay não tem porta atribuída |
relay -allow-file | nenhum (um relay aberto); um arquivo de texto de no máximo 64 KiB com pelo menos uma chave |
Flags -relay- | os padrões e faixas do kolo-relay, veja kolo-node |
-relay-max-conns, -relay-max-conns-per-ip | 128, de 1 a 10000; 4 |
| Nova tentativa até entrar na rede | depois de 1 minuto, dobrando até 5 minutos |
| Bootstrap de novo depois de entrar | a cada 5 minutos enquanto houver menos de 20 servidores |
| Encerramento | 10s, depois sai com 1 |
| Listener que recusa | 16 conexões, 16 pendentes, 1 conexão de saída, 1 stream, janelas de 64 KiB |
check | de 1 a 16 endereços, -timeout 5s, de 1s a 1m |
check -relay, -relay-file, KOLO_RELAYS | no máximo 16 relays distintos; um arquivo de no máximo 64 KiB |
| Arquivo de identidade, o seu diretório | 0600, 0700 |
| Unit do systemd | MemoryMax=512M, GOMEMLIMIT=480MiB, reinício depois de 5s |
Buffers UDP (net.core.rmem_max, wmem_max) | 7500000 |
| Porta UDP | 7447 |
Veja kolo-node, Bom saber.
kolo-pin
| Limite | Valor |
|---|---|
MaxBytes (todos os donos), -max-bytes | DefaultMaxBytes, 100 GB; além disso, ErrDiskFull |
Capability.Quota (um dono) | 0 para nenhuma; além dela, ErrQuotaExceeded |
MaxOwners (registros de dono), -max-owners | DefaultMaxOwners, 100.000; um dono novo além disso é ErrOwnerLimit, os já guardados nunca são recusados |
AddTimeout, -add-timeout | nenhum; além disso, um Add dá ErrBusy e o que foi guardado é mantido |
-max-conns, -max-conns-per-ip | 100 (de 1 a 10000) e 4 (no máximo -max-conns), os limites de conexões da kolo-transport |
| Uma entrada | precisa caber em uma mensagem da kolo-sync de 4 MiB com o seu registro e o custo extra da criptografia; senão, ErrTooLarge |
| IDs de log em uma capability | MaxLogs, 256, ou nenhum para todos os logs do dono |
| Capability | no máximo MaxCapabilitySize, 8353 bytes |
| Requisição | no máximo MaxRequestSize, 8389 bytes, uma de cada vez por conexão |
| Leitura de uma requisição, escrita de uma resposta | Timeout, 60s |
| Horário de emissão no futuro do peer | no máximo 60s |
| Tempos da capability | segundos Unix inteiros, até 2^53-1 |
| Verificação de capabilities expiradas | a cada minuto |
| Log aberto sem uso | fechado depois de um minuto |
| Logs abertos | no máximo 64; os usados há mais tempo são fechados primeiro |
| Memória de um log aberto | cerca de 250 bytes por entrada; no pior caso, cerca de 0,42 vez MaxBytes para 64 logs abertos |
| Conexão a um peer de fixação | 10s, depois ErrUnreachable |
DefaultCopies, MaxFallback | 2, 2 |
| Nova tentativa de uma exclusão de log que falhou | depois de 1 minuto, e então o dobro a cada vez, até 64 minutos |
Diretório de dados, identity.key | 0700, 0600 |
-listen | 127.0.0.1:7450 |
-health | 127.0.0.1:7451 |
-metrics | 127.0.0.1:7452 |
Os dois limites de bytes contam chaves e valores guardados, não blocos de disco, e são verificados antes de qualquer coisa ser guardada. Nada é removido, e as exclusões sempre passam. Veja kolo-pin, Bom saber.