kolo docsbeta

Limites

Cada tamanho, contagem e timeout fixo e cada padrão configurável das bibliotecas do Kolo, em uma tabela por biblioteca.

Nesta página

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

LimiteValor
Seedexatamente 32 bytes
Arquivo de chavearquivo regular de exatamente 32 bytes
Contexto de assinaturade 1 a 255 bytes
Chave pública para Verify32 bytes
Chaves de ordem pequena recusadas por Verifytodas as 14 codificações
Modo do arquivo de chave0600
Modo de um novo diretório pai0700
Frase de recuperaçãoexatamente 24 palavras da lista em inglês do BIP-39, só ASCII; ParsePhrase lê no máximo 1024 bytes
Certificadono máximo 256 bytes, ou 514 com um pai aprovador
Oferta de certificadono máximo 450 bytes, 192 sem pai
Revogaçãono máximo 472 bytes, 182 quando a chave da pessoa ou o próprio dispositivo assina
Arquivo de certificadode 1 a 514 bytes, modo 0600
Cadeia de certificadosno máximo 2 certificados (pessoa, aprovador, dispositivo); um aprovador não pode emitir outro aprovador
Número de série de um certificadopelo menos 1
Contextos que começam com kolo-id/device-recusados por Sign (ErrInvalidContext) e por VerifyDevice
Trabalho de um VerifyDeviceno 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

LimiteValor
Varintno 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
Boolum byte, 0 ou 1

Veja kolo-codec, Bom saber.

kolo-log

LimiteValor
Tamanho da entrada, 64 bitscerca de 254 GiB
Tamanho da entrada, 32 bitscerca de 512 MiB
Menor entrada com preenchimento256 bytes (entradas de até 254 bytes)
Entrada em discoum frame de 256 bytes e 296 bytes de texto cifrado guardado para entradas de até 254 bytes
Preenchimento das entradas maioresPadmé, no máximo cerca de 6% a mais
Memória por entradacerca de 64 bytes de hashes da árvore e 144 bytes de registro, seja qual for o tamanho da entrada
ID do log32 bytes, aleatório
Hash da árvore32 bytes (BLAKE2b-256)
Caminho de provano máximo 65 hashes
Entrada JSONno máximo 4 KiB, 8 KiB para provas
Logs graváveis por (chave do autor, ID do log)1 por processo (ErrLogOpen)
Logs por Storage1: New e NewReplica retornam ErrStorageNotEmpty para um armazenamento que já guarda uma entrada
AddKeysno 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

LimiteValor
Diretório do storecriado com modo 0700, acesso do grupo ou de outros recusado
Modo dos arquivos do Pebble0600 para todo arquivo que o Pebble cria no diretório
PebbleOptions.MemTableSize0 (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 log1 por backend em um processo (ErrLogInUse)
Logs por ID de log em um store1, seja quem for o dono; um ID guardado para outro dono retorna kololog.ErrBadLogHeader
Memória por log ou réplica abertacerca de 250 bytes por entrada, seja qual for o tamanho da entrada
Lote de um Adoptmenos 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 Pebblemenos de 4 GiB - 1 bytes (2 GiB - 1 em 32 bits); ErrTooLarge caso contrário
Registro, head ou marcador de exclusão guardadono máximo 1024 bytes
Chave de entrada guardadaexatamente 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éplicano máximo 1024 bytes
Prova de atualização de uma réplicano máximo 65 hashes
Versão do valor de entrada guardado3 (versões 1 e 2 recusadas)

Veja kolo-store, Bom saber.

kolo-sync

LimiteValor
MaxMessageSize4 MiB, prefixo de tamanho verificado antes da alocação
Entrada cujo texto cifrado com preenchimento não cabe em uma mensagemnão pode ser sincronizada nem buscada com Fetch (ErrTooLarge), excluída ou não, e o log não sincroniza além dela
MaxStreams16 por conexão, de pull ou de fetch, os outros recebem “ocupado”
ServerOptions.MaxTotalStreams256 (DefaultMaxTotalStreams) somando todas as conexões, os outros recebem “ocupado” (ErrBusy no cliente)
ServerOptions.MaxAnswerBytes256 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”
Timeout60s 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
MinRate16 KiB/s, a velocidade média mínima de uma mensagem
Resposta a uma requisição de entradascerca de 1 MiB; uma entrada maior vai sozinha, até MaxMessageSize
PullOptions.InFlightde 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 streaming2 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 ainda6 MiB no máximo; um commit guarda as respostas que esperam até 4 MiB
Entradas que uma resposta STATE olhano 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 redeno máximo 4 KiB cada
Chave de entrada na rede0 ou 32 bytes
Memória do Fetcho intervalo pedido, no máximo uma mensagem a mais

Veja kolo-sync, Bom saber.

kolo-kv

LimiteValor
MaxKeySize32 KiB (a chave vazia é válida)
MaxValueSize1 MiB
Valores de uma chavequando 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ãode 1 a 65.536
Destruição das entradas listadasum único Log.Delete, uma única gravação durável
Memóriao í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.

LimiteValor
GroupConfig.MaxMembers64, de 2 a 1024
GroupConfig.MaxSettlers7 ou MaxMembers se for menor, de 1 a 64
GroupConfig.MinSettlers4 ou MaxSettlers se for menor, de 1 a MaxSettlers
GroupConfig.MaxBody1 MiB, de 1 KiB a 3 MiB
GroupConfig.CheckpointEvery1024 posições assentadas, de 64 a 2^20
Limits.MaxTail2048 entradas, de 64 a 2^20
Limits.MaxPendingBytes16 MiB, de 1 MiB a 1 GiB; um strand guarda no máximo MaxPendingBytes / MaxMembers deles, uma entrada sempre cabe
Limits.MaxForks4, 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.PulseGap500 ms, de 10 ms a 1 min
Limits.PivotWait3 s, de 100 ms a 5 min
Limits.AnnounceGap100 ms, de 10 ms a 10 s
Limits.ConfirmWait10 s, de 1 s a 5 min
Limits.MaxEvents1024, de 16 a 2^16
Chave e valor da visão32 KiB e 1 MiB
Escritas de uma entrada16 x MaxBody, e cada operação custa a sua chave e o seu valor mais 256 bytes
Tag do appde 1 a 64 bytes de UTF-8
Pedido de entrada e welcome64 KiB e 1 MiB
Mensagem de stream4 MiB
Pulls ao mesmo tempo16, um por strand
Resposta a um pedido, chave desconhecida60 s, depois a conexão é fechada
Disco por entradacerca 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.

LimiteValor
MaxCertsPerPerson1024, de 1 a 2^20: os certificados de uma pessoa em uma visão
PersonCertReserveum oitavo de MaxCertsPerPerson (128), de 0 a MaxCertsPerPerson, -1 para nenhum: vagas reservadas para certificados emitidos pela chave da pessoa
MaxRevocationsPerDevice64, de 1 a 2^16: revogações de aprovador de uma chave de dispositivo
MaxDevicesnenhum 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ção514, 450 e 472 bytes, as codificações da kolo-id
Pedido de entrada com prova64 KiB; uma prova tem menos de 700 bytes

Veja kolo-braid, Bom saber.

kolo-transport

LimiteValor
Networksó "udp4"
MaxConns100, de 1 a 10000
MaxConnsPerIP4 (ou MaxConns, se for menor), de 1 a MaxConns
MaxDialed32, de 1 a 10000
MaxIncomingStreams16 de cada tipo por conexão, de 1 a 1000
HandshakeTimeout10s, de 1s a 60s (também a validade de um token de Retry)
IdleTimeout30s, de 1s a 10m
Tempo de inatividade do peer, considerado no mínimo5s
KeepAlivePeriod5s (ou IdleTimeout/2, se for menor), de 500ms até abaixo de IdleTimeout
MaxStreamReceiveWindow256 KiB, de 64 KiB a 16 MiB
MaxConnReceiveWindow512 KiB, de 64 KiB a 64 MiB
MaxMemory1 GiB, de 64 MiB a 64 GiB
CongestionControl"reno" (padrão), "cubic" ou "bbr"; qualquer outro valor é ErrInvalidConfig
WindowGrowthdesligado; ligado, Conn.AllowWindowGrowth deixa as janelas de uma conexão crescerem
MaxGrownStreamReceiveWindow4 MiB, de MaxStreamReceiveWindow a 16 MiB (só com WindowGrowth)
MaxGrownConnReceiveWindow8 MiB, de MaxConnReceiveWindow a 64 MiB (só com WindowGrowth)
MaxGrownMemory64 MiB, de 1 MiB a 64 GiB, compartilhado pelas conexões de um Listener (só com WindowGrowth)
Amostras do BBRno 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 accept32 conexões
MaxPacketSize (datagramas que não são QUIC)1200 bytes
Fila de datagramas que não são QUIC32 datagramas
MaxCode2^62-1
Mensagem de CloseWithErrorno máximo 256 bytes
Saída de ExportKey32 bytes
Validade de um token NEW_TOKEN1ns
Listener.Close em uma conn que ignora deadlines1s
Datagramas de ListenConnno mínimo 1280 bytes; acima de 1452, truncados

Veja kolo-transport, Bom saber.

kolo-secure

LimiteValor
HandshakeTimeout10s depois do handshake QUIC, de 1s a 60s
MaxPending64 por listener, de 1 a 1000
Mensagem do handshakecorpo de 1 a 256 bytes, tamanho de no máximo 2 bytes
Maior mensagem real do handshake98 bytes
Chave remote32 bytes
Codificações de ordem pequena recusadas14
Outras chaves que quem tem uma chave consegue provaraté 7
Valor do exporter32 bytes
Código de close de um handshake que falha1

Veja kolo-secure, Bom saber.

kolo-dht

LimiteValor
MaxRecords65536 por servidor, de 16 a 1.000.000
MaxRecordsPerTopic512, de 1 a 65536 (um dezesseis avos por /24 IPv4)
MaxRecordsPerIP256, de 1 a 65536
MaxAnnouncements16, de 1 a 256
MaxInflight160, de 8 a 4096
MaxRelays64, de 1 a 4096
MaxPunches16, de 1 a 256 (conexões de birthday punch: 4 por /24)
MaxRequestsPerIP50/s, de 1 a 10.000
MaxRequestsPerPrefix200/s por /24, de MaxRequestsPerIP a 100.000
MaxRequests10.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
RequestTimeout1s, de 100ms a 10s
Requisições com falha antes de uma entrada da tabela ser descartada4 seguidas
PunchTimeout45s, de 1s a 2m
MaxRandomPunches1, de 1 a 16
MaxRandomPunchesPerTarget, MaxRandomPunchesPerRequester1, de 1 a MaxRandomPunches
RandomPunchInterval20s, de 1s a 10m
RandomPunchCooldown1m, de 1s a 1h, dobra até chegar a 16 vezes esse valor
MaxRandomPunchesPerMinute4, de 1 a 64
MaxPunchSockets256 ou metade do limite flexível de RLIMIT_NOFILE, de 1 a 16384
KeepAlivePeriod das conexões feitas por punch5s, a não ser que IdleTimeout seja de 5s ou menos
Fila de AcceptSecure.MaxPending, 64 por padrão
Datagramano máximo 1200 bytes
Respostano máximo 20 nós e 16 registros
Tabela de roteamento256 buckets de 20; por /24, 2 em um bucket e 10 no total
Registrorenovado a cada 15s, descartado 20 minutos depois da última renovação
Busca10 servidores ao mesmo tempo, 100 no total, 160 verificações de assinatura
Relays por Connect3
Endereços de Bootstrap64
Token de ida e voltaaceito por 40 a 80s
IDs de nó por endereço IPv48

Veja kolo-dht, Bom saber.

kolo-swarm

LimiteValor
MaxPeers64, de 1 a 1024
MaxInboundMaxPeers/2 arredondado para cima (32), de 1 a MaxPeers
MaxTopics16, de 1 a 32
Topics por hello32
MaxConnecting3, de 1 a 16
Conexões em abertura por relays ao mesmo tempoaté MaxConnecting, contadas à parte das chamadas a Connect do kolo-dht
Config.Relaysvazia por padrão, no máximo 16 relays
Primeiro contato por um relaydepois de até 3 x PunchTimeout do kolo-dht (135s), e então no máximo 60s por relay tentado
MaxHandshakes16, de 1 a 256
MaxHandshakesPerIP4 (ou MaxHandshakes, se for menor), de 1 a MaxHandshakes
Hellos ao mesmo tempo por chave2
MaxCandidates1024, de 16 a 32768
MaxEvents64, de 16 a 4096
HelloTimeout10s, de 1s a 60s (2s por etapa)
LookupInterval10m mais até um quinto disso ao acaso, de 1s a 1h
RetryMin1s, de 100ms a 1m
RetryMax10m, de RetryMin a 1h
Conexão que zera a contagem de falhasdura 15s
Conexões em abertura ao mesmo tempo por host2
HELLO, REPLYno máximo 1026 e 1044 bytes
BootstrapNodesvazia 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 total8 por nome, 64 no total
Resolver um nome de bootstrap5s por nome, em paralelo, dentro do ctx
Arquivo do LoadNodesum arquivo regular de no máximo 64 KiB

Veja kolo-swarm, Bom saber.

kolo-relay

LimiteValor
MaxReservations64, de 1 a 100000
MaxSessions16, de 1 a 10000
MaxSessionsPerPeer4 (ou MaxSessions, se for menor)
MaxSessionsPerTarget8 (ou MaxSessions, se for menor)
ReservationLifetime1h, de 1s a 24h
MaxSessionDuration1h, de 1s a 24h
MaxSessionBytes1 GiB em cada sentido, de 64 KiB a 1 TiB
SessionIdleTimeout60s, de 1s a 10m
ConnectTimeout15s, de 1s a 60s
ControlTimeout (relay)15s, de 1s a 60s
RateBytes1 MiB por segundo por conexão de cliente, de 16 KiB a 1 GiB
RateBurst256 KiB, de 16 KiB a 64 MiB
FlushInterval1ms, de 100µs a 100ms
Listener do relay com Secure nilMaxConns 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 zerado10s
Espera do alvo por um peer anunciado40s com os padrões
Mensagem de controleno máximo 64 bytes
Frame de pacoteno máximo 1452 bytes
Buffer de cópia64 KiB por sentido
Pacotes internos1280 bytes
Reservation.Close, Conn.Closecerca de 2s
Server.Close por iniciadoraté 1s

Veja kolo-relay, Bom saber.

kolo-invite

LimiteValor
Campo de Options zerado ou negativozerado usa o valor padrão, negativo é ErrInvalidArgument
Timeout30s
Fechamento de uma conexão ociosa que é só de conviteentre Timeout e 1,25 vezes Timeout
MaxData64 KiB, no máximo 1 GiB
MaxPending1024
MaxPendingPerSource16
PendingTTLnenhum; um pedido Manual que esperou esse tempo é retirado, como se quem pediu tivesse ido embora
MaxPendingDevices4 pedidos pendentes de vincular um dispositivo, somando todos os convites de dispositivo; os outros recebem ErrBusy
MaxDeviceName64 bytes, de 1 a MaxData
DevicePendingTTL2 minutos; depois o pedido é retirado e o código é queimado
DeviceOptions.TTL5 minutos, quanto tempo um código de dispositivo dura
DeviceJoinOptions.MaxName, MaxPayload64 bytes e 4096 bytes no dispositivo novo
MaxStreams8 por conexão
SourceRate60 por minuto por origem, rajadas de até 60
InviteRate600 por minuto por convite, rajadas de até 600
MaxSources4096
MaxEvents1024
JoinOptions.MaxPayload1 MiB
CreateOptions.TTLzerado nunca expira
CreateOptions.MaxUseszerado quer dizer 1, sem limite superior
CreateOptions.Payloadno máximo 1 GiB, vazio com Manual
Carga útil e dados de entradano máximo 1 GiB
Frames OPEN e CHALLENGEno máximo 64 bytes
Outros framesno máximo max(512, Padmé(n + 256)) + 256 bytes, n é MaxData ou MaxPayload
Texto claro preenchidopelo menos 512 bytes, Padmé acima disso
Respostas de um mesmo tamanhocarga útil de até 508 bytes
Código92 caracteres, prefixo koloinv0, todo em minúsculas ou todo em maiúsculas
Impressão digital, segredo, soma de verificação16, 32 e 4 bytes
Desafio32 bytes por stream
Linger5 minutos
Nova tentativa de Announceespera que cresce de 1s até 1 minuto
Topics de convitedividem o MaxTopics do swarm (16, no máximo 32)
Pedidos encerrados que Approve e Deny lembramos últimos MaxPending
Registro de convitecerca de 100 bytes mais a carga útil
Espera de quem entra com os padrões da kolo-swarmaté 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.

LimiteValor
SetupTimeout, RequestTimeout10s cada um, de 1s a 10m
MaxRequests, MaxSubscriptions1000 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
MaxControlMessageSize65535, de 8192 a 65535
MaxNamespaceFields, MaxNameLength32 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
MaxFetchBytesMaxBufferedBytes, de MaxObjectSize a 64 GiB; um FETCH além dele é recusado com EXCESSIVE_LOAD, um preenchimento é pulado e um FETCH repassado é reiniciado
OriginConfig.MaxTracks1000, de 1 a 1000000
OriginConfig.MaxObjectSize (um payload escrito no origin)16 MiB, de 1 KiB a 1 GiB
TrackOptions.Priority128 (DefaultPriority), de 0 a 255; menor é mais urgente
TrackOptions.CacheGroups, CacheBytes16 grupos, 32 MiB; de 1 a 1000000 grupos, de 1 KiB a 64 GiB
Timeouts de entreganenhum; um valor abaixo de 1 ms é arredondado para cima, para 1 ms
RelayConfig.MaxTracks1000, de 1 a 1000000
RelayConfig.MaxSessionTracksMaxTracks dividido por 10, no mínimo 1; os que passam desse número recebem EXCESSIVE_LOAD
RelayConfig.MaxSessionFetches16, de 1 a 1000000; os que passam desse número recebem EXCESSIVE_LOAD
RelayConfig.Resume0 (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.MaxResumeHeld10000, 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.MaxPeerResumeHeldo MaxRequests da sessão (1000), ou MaxResumeHeld se for menor, de 1 a MaxResumeHeld: anúncios guardados para uma chave de peer
NewGroupRequestInterval1s 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, CacheBytescomo em TrackOptions, para cada track repassado
KeyringConfig.Retain, RetainMax450 ms, até 1 m; Retain mais 400 ms, de Retain a 2 m. Por quanto tempo uma chave substituída ainda abre objetos
KeyringConfig.MaxSenders64, de 1 a 1024; mais chamadas a Receive falham com ErrTooManySenders
KeyringConfig.MaxKeyRate64 mensagens de chave por namespace e segundo, de 1 a 1024; as demais são descartadas e contadas
KeyringConfig.ReplayGroups, ReplayObjects64 grupos e 8192 entradas por Opener, de 1 a 1000000
SenderConfig.MaxTracks1024, de 1 a 1000000; mais um track faz a rotação da chave
Texto claro selado com uma chave de track2^24 unidades de 16 KiB, e depois o Sender faz a rotação
Object ID de um objeto selado, namespace de um broadcast protegidomenor 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 peerno máximo 1024 bytes, escapados; o motivo nunca vai em Error()
Custo de um objeto para o MaxBufferedBytes e o cacheo payload, 48 bytes por propriedade e 64 bytes
Payload de mais de 64 KiBlido conforme chega
IDs de pedido conferidos contra repetiçãoos últimos 65536 números; os mais antigos contam como repetidos
Stream sem avançoreiniciado depois de RequestTimeout
MaxIncomingStreams da kolo-transport16 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.

LimiteValor
CatalogLimits.MaxTracks1024
CatalogLimits.MaxNameLen4096 bytes
CatalogLimits.MaxConfigLen65508 bytes, a maior config que cabe em uma propriedade de objeto
Tamanho do catálogoprecisa caber no MaxObjectSize do origin, 16 MiB na kolo-moq; senão, ErrInvalidCatalog
Tracks de mídia de um origin padrão999, porque o track de catálogo conta para o MaxTracks do origin; depois, ErrTooManyTracks
CatalogPriority, AudioPriority, VideoPriority28, 48, 68; um número menor é enviado antes
MediaGroupTimeout30s
PlayoutConfig.MinDelay100 ms
PlayoutConfig.MaxDelay400 ms, ou MinDelay se for maior
PlayoutConfig.MaxBehind50 ms
PlayoutConfig.MaxFrames8192 por track
PlayoutConfig.MaxBytes16 MiB por track
Objetos de vídeo retidosos mesmos dois limites de novo, contados à parte: até o dobro de cada um, 32 MiB por padrão
Tracks de áudio em um Playout1
Janela da referênciaas últimas 2 s de chegadas, no máximo 8192
Frame adiantado em relação à referênciadescartado se estiver mais de 2 s adiantado
Espera de um objeto protegido pela sua chaveMaxDelay, 400 ms por padrão
Objetos retidos de um track protegidoos 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 protegido1, até chegar a chave dele ou uma versão mais nova o substituir
Custo extra de um objeto de áudio protegido24 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ídeoaté 80 MiB na kolo-media, mais o MaxBufferedBytes da kolo-moq para cada uma das suas assinaturas
Primeiro frame com um timestamp muito adiantadoo 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.

LimiteValor
Format.SampleRate48000 Hz por padrão, de 8000 a 384000 Hz
Format.Channels1 por padrão, de 1 a 254
Config.Period10 ms, pelo menos um frame e no máximo Buffer
Config.Buffer120 ms, de Period a 2 s
Config.StallTimeout12 s, maior que Period
Taxa de amostragem do Opus8000, 12000, 16000, 24000 ou 48000 Hz
Canais do Opus1 ou 2
Bitrate do Opusde 500 a 512000 bit/s, 0 deixa a libopus escolher
Complexidade do Opusde 1 a 10, 0 mantém o padrão da libopus, 9
Perda de pacotes do Opusde 0 a 100 por cento
CBR do Opusligado ou desligado; cada pacote tem (bitrate * duração do frame + 4) / 8 bytes, pelo menos 1
Duração do frame do Opus2,5, 5, 10, 20, 40 ou 60 ms, 20 ms por padrão
opus.PacketBufferSize4000 bytes
opus.MaxPacketDuration120 ms
Maior pacote Opus aceito61296 bytes; um maior é ErrInvalidPacket
DecodeLost, DecodeFECum múltiplo de 2,5 ms, no máximo 120 ms
Módulo da libopus1 MiB de memória e uma pilha de 256 KiB, para cada codificador ou decodificador
Módulo do resampler512 KiB de memória
Memória de um par codificador e decodificadorcerca de 0,8 a 0,9 MB
PulseAudiocada 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
WASAPI5 novas tentativas após uma troca de rota, de 100 ms a 1600 ms, 3,1 s no total
ALSAa reprodução é mantida cheia até 3 períodos
RequestAccesssem 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.

LimiteValor
Largura e altura de um framede 1 a 65536
CaptureConfig.Width, Height640 x 480 por padrão, no máximo 65536
CaptureConfig.FrameRate30 fps, de MinFrameRate (um frame por hora) a MaxFrameRate (1000)
CaptureConfig.Buffer2 frames; quando enche, o mais antigo é descartado
CaptureConfig.StallTimeout2 s, um valor negativo desativa
CaptureConfig.MaxPixels8.912.896
Enumeração de V4L2 e Media Foundation1024 entradas
Tamanho de um frame VP8de 1 a 16383
Tamanho de um frame VP9de 1 a 65536
vpx.Config.FrameRate30 fps, de MinFrameRate a MaxFrameRate
vpx.Config.Bitrate0,07 bits por pixel por frame, cerca de 4,4 Mbit/s a 1080p30
vpx.Config.KeyframeInterval2 s nos timestamps dos frames, negativo para keyframes só sob pedido
vpx.DecoderConfig.MaxPixels8.912.896, conferido em cada cabeçalho de frame
vpx.DecoderConfig.MaxPacketBytes16 MiB, no máximo 256 MiB (ErrTooLarge), verificado antes de copiar o pacote
Buffer de pacotes do vpx.Decoderno máximo 1 MiB mantido entre chamadas
Motor native, tempo real1920x1080 a 30 fps, codificar e decodificar
Motor portable, tempo realcodificar até 640x480 a 30 fps, decodificar até 1920x1080
Memória do motor portableno máximo 1 GiB por instância
Tamanho de h264.Configpar, de 48 a 4096 por lado, no máximo 36864 macroblocos
Macroblocos por segundo de h264.Configno máximo 983040 (1920x1080 até 120 fps, 3840x2160 até 30 fps)
h264.Config.Bitrate0,07 bits por pixel por frame, de 1 a 240.000.000 bit/s
h264.Config.KeyframeInterval2 s nos timestamps dos frames, negativo para keyframes só sob pedido
Nível de saída do H.264no máximo 5.1 (Tabela A-1 da especificação H.264)
Perfis do H.264Constrained Baseline (padrão), Main e High; profile_idc 66, 77 e 100 no decodificador
h264.DecoderConfig.MaxPixels9.437.184 (36864 macroblocos), no máximo esse valor
h264.DecoderConfig.MaxPacketBytes16 MiB, no máximo 256 MiB
Unidades NAL em um pacote H.264no máximo MaxPixels / 256 + 288
Imagem do decodificador H.264cada 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.264level_idc de 9 a 51, níveis de 1 a 5.1
Imagens em um pacote H.2641
Tempo de codificação H.264 no Windows1280x720 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

LimiteValor
-listen:7447
Arquivo de -configum único objeto JSON de no máximo 64 KiB
-bootstraphost: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-fileum arquivo de texto de no máximo 64 KiB, um host:port por linha, repetível
-firstfalso; verdadeiro significa sem nós de entrada, recusado com -bootstrap ou -bootstrap-file
KOLO_BOOTSTRAPnão definida; só é lida quando -bootstrap, -bootstrap-file e -first estão todos sem definição
Resolução de nomes5s por nome
Bootstrap30s
-stats-interval5m, de 1s a 24h
-dht-max-records65536, de 16 a 1.000.000
-dht-max-records-per-topic512, de 1 a 65536
-dht-max-records-per-ip256, de 1 a 65536
-dht-max-inflight160, de 8 a 4096, no mínimo 75 com -bootstrap
-dht-max-relays64, de 1 a 4096
-dht-max-requests-per-ip50/s, de 1 a 10.000
-dht-max-requests-per-prefix200/s, até 100.000
-dht-max-requests10.000/s, até 1.000.000
-dht-request-timeout1s, de 100ms a 10s
-dht-punch-timeout45s, de 1s a 2m
relay -listen, relay -identityobrigatórios; o kolo-relay não tem porta atribuída
relay -allow-filenenhum (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-ip128, de 1 a 10000; 4
Nova tentativa até entrar na rededepois de 1 minuto, dobrando até 5 minutos
Bootstrap de novo depois de entrara cada 5 minutos enquanto houver menos de 20 servidores
Encerramento10s, depois sai com 1
Listener que recusa16 conexões, 16 pendentes, 1 conexão de saída, 1 stream, janelas de 64 KiB
checkde 1 a 16 endereços, -timeout 5s, de 1s a 1m
check -relay, -relay-file, KOLO_RELAYSno máximo 16 relays distintos; um arquivo de no máximo 64 KiB
Arquivo de identidade, o seu diretório0600, 0700
Unit do systemdMemoryMax=512M, GOMEMLIMIT=480MiB, reinício depois de 5s
Buffers UDP (net.core.rmem_max, wmem_max)7500000
Porta UDP7447

Veja kolo-node, Bom saber.

kolo-pin

LimiteValor
MaxBytes (todos os donos), -max-bytesDefaultMaxBytes, 100 GB; além disso, ErrDiskFull
Capability.Quota (um dono)0 para nenhuma; além dela, ErrQuotaExceeded
MaxOwners (registros de dono), -max-ownersDefaultMaxOwners, 100.000; um dono novo além disso é ErrOwnerLimit, os já guardados nunca são recusados
AddTimeout, -add-timeoutnenhum; além disso, um Add dá ErrBusy e o que foi guardado é mantido
-max-conns, -max-conns-per-ip100 (de 1 a 10000) e 4 (no máximo -max-conns), os limites de conexões da kolo-transport
Uma entradaprecisa 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 capabilityMaxLogs, 256, ou nenhum para todos os logs do dono
Capabilityno máximo MaxCapabilitySize, 8353 bytes
Requisiçãono máximo MaxRequestSize, 8389 bytes, uma de cada vez por conexão
Leitura de uma requisição, escrita de uma respostaTimeout, 60s
Horário de emissão no futuro do peerno máximo 60s
Tempos da capabilitysegundos Unix inteiros, até 2^53-1
Verificação de capabilities expiradasa cada minuto
Log aberto sem usofechado depois de um minuto
Logs abertosno máximo 64; os usados há mais tempo são fechados primeiro
Memória de um log abertocerca 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ção10s, depois ErrUnreachable
DefaultCopies, MaxFallback2, 2
Nova tentativa de uma exclusão de log que falhoudepois de 1 minuto, e então o dobro a cada vez, até 64 minutos
Diretório de dados, identity.key0700, 0600
-listen127.0.0.1:7450
-health127.0.0.1:7451
-metrics127.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.