kolo docsbeta

Límites

Cada tamaño, cantidad y tiempo de espera fijos y cada valor por defecto configurable de las bibliotecas de Kolo, en una tabla por biblioteca.

En esta página

Antes de los números

El borrado es de mejor esfuerzo. Se cumple en los peers que siguen el protocolo. Un peer que ya recibió una clave de entrada puede quedársela, y las copias antiguas de un disco pueden conservar todavía una clave borrada. Consulta Borrado.

Kolo solo funciona con IPv4: las direcciones IPv6 se rechazan, incluida la forma v4-mapped. Todas las bibliotecas son experimentales.

kolo-id

LímiteValor
Semillaexactamente 32 bytes
Archivo de clavearchivo normal de exactamente 32 bytes
Contexto de firmade 1 a 255 bytes
Clave pública para Verify32 bytes
Claves de orden pequeño que rechaza Verifylas 14 codificaciones
Modo del archivo de clave0600
Modo de un directorio padre nuevo0700
Frase de recuperaciónexactamente 24 palabras de la lista inglesa de BIP-39, solo ASCII; ParsePhrase lee como mucho 1024 bytes
Certificadocomo mucho 256 bytes, o 514 con un padre aprobador
Oferta de certificadocomo mucho 450 bytes, 192 sin padre
Revocacióncomo mucho 472 bytes, 182 cuando la firma la clave de la persona o el propio dispositivo
Archivo de certificadode 1 a 514 bytes, modo 0600
Cadena de certificadoscomo mucho 2 certificados (persona, aprobador, dispositivo); un aprobador no puede emitir otro aprobador
Número de serie de un certificadoal menos 1
Contextos que empiezan por kolo-id/device-los rechazan Sign (ErrInvalidContext) y VerifyDevice
Trabajo de un VerifyDevicecomo mucho 4 firmas de certificado y 1 firma de mensaje, más un trabajo lineal en la lista de revocaciones

Consulta kolo-id, Conviene saber.

kolo-codec

LímiteValor
Varintcomo máximo 10 bytes, 64 bits
Bytes(max), String(max)longitud como máximo max, comprobada antes de reservar memoria
UvarintMax(max)valor como máximo max
Boolun byte, 0 o 1

Consulta kolo-codec, Conviene saber.

kolo-log

LímiteValor
Tamaño de entrada, 64 bitsunos 254 GiB
Tamaño de entrada, 32 bitsunos 512 MiB
Entrada con relleno más pequeña256 bytes (entradas de hasta 254 bytes)
Entrada en discoun frame de 256 bytes y 296 bytes de texto cifrado guardado para entradas de hasta 254 bytes
Relleno de las entradas más grandesPadmé, como mucho un 6 % más
Memoria por entradaunos 64 bytes de hashes del árbol y 144 bytes de registro, sea cual sea el tamaño de la entrada
ID de log32 bytes, aleatorio
Hash del árbol32 bytes (BLAKE2b-256)
Ruta de pruebacomo máximo 65 hashes
Entrada JSONcomo máximo 4 KiB, 8 KiB para pruebas
Logs escribibles por (clave de autor, ID de log)1 por proceso (ErrLogOpen)
Logs por Storage1: New y NewReplica devuelven ErrStorageNotEmpty para un almacenamiento que ya guarda una entrada
AddKeyscomo mucho MaxAddKeys, 32.768 claves por llamada; más es ErrTooManyKeys
EntrySecret (claves derivadas)32 bytes aleatorios uniformes

Consulta kolo-log, Conviene saber.

kolo-store

LímiteValor
Directorio del almacénse crea con modo 0700; se rechaza si el grupo u otros tienen acceso
Modo de los archivos de Pebble0600 para todo archivo que Pebble crea en el directorio
PebbleOptions.MemTableSize0 (los 4 MiB de Pebble) o de 1 MiB a 1 GiB, en otro caso ErrInvalidOptions; memoria de hasta el doble del tamaño
Logs abiertos por ID de log1 por backend en cada proceso (ErrLogInUse)
Logs por ID de log en un almacén1, sea quien sea el propietario; un ID guardado para otro propietario devuelve kololog.ErrBadLogHeader
Memoria por log o réplica abiertosunos 250 bytes por entrada, sea cual sea el tamaño de la entrada
Lote de un Adoptmenos de 2 GiB (1 GiB en 32 bits), contado como cuenta Pebble un lote; ErrTooLarge a partir de 2 GiB. Retiene las entradas que añade, y Pebble una segunda copia
Lote de Pebblemenos de 4 GiB - 1 bytes (2 GiB - 1 en 32 bits); ErrTooLarge en otro caso
Registro, head o marca de borrado guardadoscomo máximo 1024 bytes
Clave de entrada guardadaexactamente 32 bytes; ausente en una entrada borrada y en una entrada de réplica recibida sin su clave (solo una entrada viva de un log propio sin su clave es ErrCorrupt)
Head de puesta al día de una réplicacomo máximo 1024 bytes
Prueba de puesta al día de una réplicacomo máximo 65 hashes
Versión del valor de entrada guardado3 (las versiones 1 y 2 se rechazan)

Consulta kolo-store, Conviene saber.

kolo-sync

LímiteValor
MaxMessageSize4 MiB; el prefijo de longitud se comprueba antes de reservar memoria
Entrada cuyo texto cifrado con relleno no cabe en un mensajeno se puede sincronizar ni traer con Fetch (ErrTooLarge), esté borrada o no, y el log no se sincroniza más allá de ella
MaxStreams16 por conexión, sean de pull o de fetch; a los demás se les responde «ocupado»
ServerOptions.MaxTotalStreams256 (DefaultMaxTotalStreams) entre todas las conexiones; a los demás se les responde «ocupado» (ErrBusy en el cliente)
ServerOptions.MaxAnswerBytes256 MiB (DefaultMaxAnswerBytes), al menos 2 x MaxMessageSize, entre todas las conexiones; una respuesta cuenta el doble de su tamaño, y a la que no cabe se le responde «ocupado»
Timeout60s para abrir un stream, para el inicio de cada lectura o escritura de un mensaje, y por espera de una petición; un mensaje de n bytes puede tardar otros n a MinRate
MinRate16 KiB/s, la velocidad media mínima de un mensaje
Respuesta a una petición de entradasunos 1 MiB; una entrada mayor va sola, hasta MaxMessageSize
PullOptions.InFlightde 1 a 8 (MaxInFlight); cualquier otro valor es ErrInvalidArgument. Con un peer que envía en streaming, el máximo de peticiones de crédito que un pull mantiene en espera, 8 si es 0; con un peer más antiguo, las respuestas pedidas y aún no guardadas, 3 (DefaultInFlight) si es 0
Crédito de un pull en streaming2 MiB por petición, de 2 peticiones hasta InFlight en espera; un servidor guarda como mucho 64 MiB de crédito por stream
Respuestas que un pull retiene sin guardar aún6 MiB como máximo; un commit guarda las respuestas que esperan hasta 4 MiB
Entradas que mira una respuesta STATEcomo máximo 32.768 (MaxMessageSize / 128); después, quien hace pull pide el resto. Solo lee marcas de borrado y claves, nunca un texto cifrado
Head, cabecera, registro, marca o prueba en la redcomo máximo 4 KiB cada uno
Clave de entrada en la red0 o 32 bytes
Memoria de Fetchel rango pedido, como mucho un mensaje más

Consulta kolo-sync, Conviene saber.

kolo-kv

LímiteValor
MaxKeySize32 KiB (la clave vacía es válida)
MaxValueSize1 MiB
Valores de una clavecuando una clave tiene 65.536 valores desde su último borrado, el siguiente Put primero los borra
Entradas que lista una entrada de borradode 1 a 65.536
Destrucción de las entradas listadasun solo Log.Delete, una sola escritura duradera
Memoriael índice (cada clave viva y el número de su entrada); los valores se leen del almacenamiento cuando se piden

Consulta kolo-kv, Conviene saber.

kolo-braid

Un campo a cero toma su valor por defecto. Un valor fuera de su rango devuelve ErrInvalidConfig para GroupConfig, fijado por la entrada genesis, o ErrInvalidArgument para los Limits locales.

LímiteValor
GroupConfig.MaxMembers64, de 2 a 1024
GroupConfig.MaxSettlers7 o MaxMembers si es menor, de 1 a 64
GroupConfig.MinSettlers4 o MaxSettlers si es menor, de 1 a MaxSettlers
GroupConfig.MaxBody1 MiB, de 1 KiB a 3 MiB
GroupConfig.CheckpointEvery1024 posiciones asentadas, de 64 a 2^20
Limits.MaxTail2048 entradas, de 64 a 2^20
Limits.MaxPendingBytes16 MiB, de 1 MiB a 1 GiB; un strand guarda como máximo MaxPendingBytes / MaxMembers de ellos, una entrada siempre cabe
Limits.MaxForks4, de 1 a 64: los segundos historiales de un strand que guarda un peer; las entradas del siguiente se rechazan y ya no se piden
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
Clave y valor de la vista32 KiB y 1 MiB
Escrituras de una entrada16 x MaxBody, y cada operación cuesta su clave y su valor más 256 bytes
Etiqueta de appde 1 a 64 bytes de UTF-8
Solicitud de entrada y welcome64 KiB y 1 MiB
Mensaje de stream4 MiB
Pulls a la vez16, uno por strand
Respuesta a una petición, clave desconocida60 s, después se cierra la conexión
Disco por entradaunos 600 bytes en cada peer; el historial no se poda nunca

El paquete devices recibe devices.Options. Los tres primeros son límites de apply, así que todos los peers de un grupo deben usar los mismos valores.

LímiteValor
MaxCertsPerPerson1024, de 1 a 2^20: los certificados de una persona en una vista
PersonCertReserveun octavo de MaxCertsPerPerson (128), de 0 a MaxCertsPerPerson, -1 para ninguno: huecos reservados para certificados emitidos por la clave de la persona
MaxRevocationsPerDevice64, de 1 a 2^16: revocaciones de aprobador de una clave de dispositivo
MaxDevicesninguno por defecto (los asientos MaxMembers del grupo son el único límite); un tope opcional de dispositivos de una persona que Admit deja entrar, ErrTooManyDevices al superarlo
Certificado, oferta, revocación514, 450 y 472 bytes, las codificaciones de kolo-id
Solicitud de unión con prueba64 KiB; una prueba ocupa menos de 700 bytes

Consulta kolo-braid, Conviene saber.

kolo-transport

LímiteValor
Networksolo "udp4"
MaxConns100, de 1 a 10000
MaxConnsPerIP4 (o MaxConns si es menor), de 1 a MaxConns
MaxDialed32, de 1 a 10000
MaxIncomingStreams16 de cada tipo por conexión, de 1 a 1000
HandshakeTimeout10s, de 1s a 60s (también la vida de un token Retry)
IdleTimeout30s, de 1s a 10m
Mínimo que se toma para el tiempo de inactividad del peer5s
KeepAlivePeriod5s (o IdleTimeout/2 si es menor), desde 500ms hasta justo por debajo 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" (por defecto), "cubic" o "bbr"; cualquier otro valor es ErrInvalidConfig
WindowGrowthdesactivado; activado, Conn.AllowWindowGrowth deja crecer las ventanas de una conexión
MaxGrownStreamReceiveWindow4 MiB, de MaxStreamReceiveWindow a 16 MiB (solo con WindowGrowth)
MaxGrownConnReceiveWindow8 MiB, de MaxConnReceiveWindow a 64 MiB (solo con WindowGrowth)
MaxGrownMemory64 MiB, de 1 MiB a 64 GiB, compartido por las conexiones de un Listener (solo con WindowGrowth)
Muestras de BBRcomo mucho 40000 números de paquete, unos 5,5 MiB por conexión BBR; las muestras más antiguas se descartan
Cola de aceptación32 conexiones
MaxPacketSize (datagramas que no son QUIC)1200 bytes
Cola de datagramas que no son QUIC32 datagramas
MaxCode2^62-1
Mensaje de CloseWithErrorcomo máximo 256 bytes
Salida de ExportKey32 bytes
Vida de un token NEW_TOKEN1ns
Listener.Close sobre una conn que ignora los plazos1s
Datagramas de ListenConnal menos 1280 bytes; lo que pasa de 1452 se trunca

Consulta kolo-transport, Conviene saber.

kolo-secure

LímiteValor
HandshakeTimeout10s después del handshake de QUIC, de 1s a 60s
MaxPending64 por listener, de 1 a 1000
Mensaje del handshakecuerpo de 1 a 256 bytes, longitud de 2 bytes como mucho
Mensaje real del handshake más grande98 bytes
Clave remote32 bytes
Codificaciones de orden pequeño rechazadas14
Otras claves que puede demostrar quien tiene una clavehasta 7
Valor del exportador32 bytes
Código de cierre de un handshake fallido1

Consulta kolo-secure, Conviene saber.

kolo-dht

LímiteValor
MaxRecords65536 por servidor, de 16 a 1.000.000
MaxRecordsPerTopic512, de 1 a 65536 (un dieciseisavo por /24 de 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 (conexiones 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 cuestan una comprobación (por segundo: por dirección IPv4, por /24, en total)20, 100, 1000, o los límites de peticiones de arriba si son menores
RequestTimeout1s, de 100ms a 10s
Peticiones fallidas antes de descartar una entrada de la tabla4 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; se duplica hasta 16 veces más
MaxRandomPunchesPerMinute4, de 1 a 64
MaxPunchSockets256 o la mitad del RLIMIT_NOFILE blando, de 1 a 16384
KeepAlivePeriod de las conexiones perforadas5s salvo que IdleTimeout sea de 5s o menos
Cola de AcceptSecure.MaxPending, 64 por defecto
Datagramacomo máximo 1200 bytes
Respuestacomo máximo 20 nodos y 16 registros
Tabla de enrutamiento256 buckets de 20; por /24, 2 en un bucket y 10 en total
Registrose refresca cada 15s y se descarta 20 minutos después del último refresco
Búsqueda10 servidores a la vez, 100 en total, 160 comprobaciones de firma
Relays por Connect3
Direcciones de Bootstrap64
Token de ida y vueltase acepta entre 40 y 80s
IDs de nodo por dirección IPv48

Consulta kolo-dht, Conviene saber.

kolo-swarm

LímiteValor
MaxPeers64, de 1 a 1024
MaxInboundMaxPeers/2 redondeado hacia arriba (32), de 1 a MaxPeers
MaxTopics16, de 1 a 32
Topics por hello32
MaxConnecting3, de 1 a 16
Llamadas a través de relays a la vezhasta MaxConnecting, contadas aparte de las llamadas a Connect de kolo-dht
Config.Relaysvacía por defecto, como mucho 16 relays
Primer contacto a través de un relaytras hasta 3 x PunchTimeout de kolo-dht (135s), luego como mucho 60s por cada relay que se prueba
MaxHandshakes16, de 1 a 256
MaxHandshakesPerIP4 (o MaxHandshakes si es menor), de 1 a MaxHandshakes
Hellos a la vez por clave2
MaxCandidates1024, de 16 a 32768
MaxEvents64, de 16 a 4096
HelloTimeout10s, de 1s a 60s (2s por paso)
LookupInterval10m más hasta una quinta parte al azar, de 1s a 1h
RetryMin1s, de 100ms a 1m
RetryMax10m, de RetryMin a 1h
Conexión que pone a cero el contador de fallosdura 15s
Llamadas a la vez por host2
HELLO, REPLYcomo máximo 1026 y 1044 bytes
BootstrapNodesvacía por defecto, lo que significa los nodos de entrada públicos incluidos; como mucho 16 entradas (el mismo tope que kolo-node)
Direcciones por nombre de bootstrap, en total8 por nombre, 64 en total
Resolver un nombre de bootstrap5s por nombre, en paralelo, dentro de ctx
Archivo de LoadNodesun archivo regular de como mucho 64 KiB

Consulta kolo-swarm, Conviene saber.

kolo-relay

LímiteValor
MaxReservations64, de 1 a 100000
MaxSessions16, de 1 a 10000
MaxSessionsPerPeer4 (o MaxSessions si es menor)
MaxSessionsPerTarget8 (o MaxSessions si es menor)
ReservationLifetime1h, de 1s a 24h
MaxSessionDuration1h, de 1s a 24h
MaxSessionBytes1 GiB en 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 conexión de cliente, de 16 KiB a 1 GiB
RateBurst256 KiB, de 16 KiB a 64 MiB
FlushInterval1ms, de 100µs a 100ms
Listener del relay con Secure a nilMaxConns 128, MaxConnsPerIP 4, MaxDialed 1, MaxIncomingStreams 2, ventanas de 64 KiB y 256 KiB
ControlTimeout (cliente)20s, de 1s a 60s
MaxPending (cliente)16, de 1 a 256
SendQueue (cliente)512 paquetes, de 8 a 1024
HandshakeTimeout en Peer cuando es cero10s
Espera del destino a un peer anunciado40s con los valores por defecto
Mensaje de controlcomo máximo 64 bytes
Trama de paquetecomo máximo 1452 bytes
Búfer de copia64 KiB por sentido
Paquetes internos1280 bytes
Reservation.Close, Conn.Closeunos 2s
Server.Close por iniciadorhasta 1s

Consulta kolo-relay, Conviene saber.

kolo-invite

LímiteValor
Campo de Options a cero o negativoa cero toma su valor por defecto, negativo es ErrInvalidArgument
Timeout30s
Cierre de una conexión inactiva que solo es de invitaciónentre Timeout y 1,25 veces Timeout
MaxData64 KiB, como mucho 1 GiB
MaxPending1024
MaxPendingPerSource16
PendingTTLninguno; una petición Manual que esperó ese tiempo se retira, como si su solicitante se hubiera ido
MaxPendingDevices4 peticiones pendientes de vincular un dispositivo, entre todas las invitaciones de dispositivo; las demás reciben ErrBusy
MaxDeviceName64 bytes, de 1 a MaxData
DevicePendingTTL2 minutos; después la petición se retira y su código queda quemado
DeviceOptions.TTL5 minutos, lo que dura un código de dispositivo
DeviceJoinOptions.MaxName, MaxPayload64 bytes y 4096 bytes en el dispositivo nuevo
MaxStreams8 por conexión
SourceRate60 por minuto por origen, ráfagas de hasta 60
InviteRate600 por minuto por invitación, ráfagas de hasta 600
MaxSources4096
MaxEvents1024
JoinOptions.MaxPayload1 MiB
CreateOptions.TTLa cero no caduca nunca
CreateOptions.MaxUsesa cero significa 1, sin límite superior
CreateOptions.Payloadcomo mucho 1 GiB, vacío con Manual
Carga útil y datos de unióncomo mucho 1 GiB
Tramas OPEN y CHALLENGEcomo mucho 64 bytes
Otras tramascomo mucho max(512, Padmé(n + 256)) + 256 bytes, n es MaxData o MaxPayload
Texto en claro rellenadoal menos 512 bytes, Padmé por encima
Respuestas de un mismo tamañocarga útil de hasta 508 bytes
Código92 caracteres, prefijo koloinv0, todo en minúsculas o todo en mayúsculas
Huella, secreto, suma de comprobación16, 32 y 4 bytes
Desafío32 bytes por stream
Linger5 minutos
Reintento de Announceespera creciente de 1s a 1 minuto
Topics de invitacióncomparten el MaxTopics del swarm (16, como mucho 32)
Peticiones terminadas que recuerdan Approve y Denylas últimas MaxPending
Registro de invitaciónunos 100 bytes más su carga útil
Espera de quien se une con los valores por defecto de kolo-swarmhasta unos 12 minutos

Consulta kolo-invite, Conviene saber.

kolo-moq

Un campo en cero toma el valor por defecto, y un valor fuera de rango es ErrInvalidConfig.

LímiteValor
SetupTimeout, RequestTimeout10s cada uno, de 1s a 10m
MaxRequests, MaxSubscriptions1000 cada uno, de 1 a 1000000; las que superan ese número reciben EXCESSIVE_LOAD
MaxObjectSize (un payload recibido del peer)16 MiB, de 1 KiB a 1 GiB
MaxControlMessageSize65535, de 8192 a 65535
MaxNamespaceFields, MaxNameLength32 campos, 4096 bytes: los límites del draft, que solo se pueden bajar
MaxBufferedGroups (una suscripción, en ambos lados)64, de 1 a 1000000
MaxBufferedBytes (una suscripción, en ambos lados)32 MiB, o MaxObjectSize si es mayor, hasta 64 GiB
MaxNamespaces (una suscripción a namespaces)1000, de 1 a 1000000
MaxFetchBytesMaxBufferedBytes, de MaxObjectSize a 64 GiB; un FETCH que lo supera se rechaza con EXCESSIVE_LOAD, un relleno se omite y un FETCH reenviado se reinicia
OriginConfig.MaxTracks1000, de 1 a 1000000
OriginConfig.MaxObjectSize (un payload escrito en el origin)16 MiB, de 1 KiB a 1 GiB
TrackOptions.Priority128 (DefaultPriority), de 0 a 255; menor es más urgente
TrackOptions.CacheGroups, CacheBytes16 grupos, 32 MiB; de 1 a 1000000 grupos, de 1 KiB a 64 GiB
Timeouts de entreganinguno; un valor menor de 1 ms se redondea hacia arriba a 1 ms
RelayConfig.MaxTracks1000, de 1 a 1000000
RelayConfig.MaxSessionTracksMaxTracks entre 10, como mínimo 1; los que superan ese número reciben EXCESSIVE_LOAD
RelayConfig.MaxSessionFetches16, de 1 a 1000000; los que superan ese número reciben EXCESSIVE_LOAD
RelayConfig.Resume0 (desactivado), de 1s a 1h: cuánto conserva un relay los anuncios de un publicador cuya conexión se perdió o que llamó a Session.Suspend
RelayConfig.MaxResumeHeld10000, de 1 a 1000000: anuncios conservados a la vez para sesiones terminadas; uno que no cabe se retira con su sesión
RelayConfig.MaxPeerResumeHeldel MaxRequests de la sesión (1000), o MaxResumeHeld si es menor, de 1 a MaxResumeHeld: anuncios conservados para una clave de peer
NewGroupRequestInterval1s por suscripción entre dos llamadas a RequestNewGroup; una más temprana es ErrNewGroupTooSoon; un track avisa en TrackWriter.NewGroupRequests como mucho una vez cada 1s, sea cual sea el número de suscripciones
RelayConfig.CacheGroups, CacheBytescomo en TrackOptions, para cada track reenviado
KeyringConfig.Retain, RetainMax450 ms, hasta 1 m; Retain más 400 ms, de Retain a 2 m. Cuánto tiempo una clave reemplazada todavía abre objetos
KeyringConfig.MaxSenders64, de 1 a 1024; más llamadas a Receive fallan con ErrTooManySenders
KeyringConfig.MaxKeyRate64 mensajes de clave por namespace y segundo, de 1 a 1024; los demás se descartan y se cuentan
KeyringConfig.ReplayGroups, ReplayObjects64 grupos y 8192 entradas por Opener, de 1 a 1000000
SenderConfig.MaxTracks1024, de 1 a 1000000; un track más rota la clave
Texto plano sellado con una clave de track2^24 unidades de 16 KiB, y después el Sender rota
Object ID de un objeto sellado, namespace de un broadcast protegidomenor que 2^32; de 1 a 31 campos, con el nombre completo del track de claves dentro de 4096 bytes
Frase de motivo y PeerImplementation de un peercomo máximo 1024 bytes, escapados; el motivo nunca va en Error()
Coste de un objeto para MaxBufferedBytes y la cachésu payload, 48 bytes por propiedad y 64 bytes
Payload de más de 64 KiBse lee a medida que llega
IDs de petición comprobados contra repeticioneslos últimos 65536 números; los más antiguos cuentan como repetidos
Stream sin avancese reinicia tras RequestTimeout
MaxIncomingStreams de kolo-transport16 por defecto, de 1 a 1000; súbelo hasta las suscripciones que esperes

Consulta kolo-moq, Conviene saber.

kolo-media

Un campo en cero de una config toma el valor por defecto.

LímiteValor
CatalogLimits.MaxTracks1024
CatalogLimits.MaxNameLen4096 bytes
CatalogLimits.MaxConfigLen65508 bytes, la mayor config que cabe en una propiedad de objeto
Tamaño del catálogotiene que caber en el MaxObjectSize del origin, 16 MiB en kolo-moq; si no, ErrInvalidCatalog
Tracks de medios de un origin por defecto999, porque el track de catálogo cuenta para el MaxTracks del origin; después, ErrTooManyTracks
CatalogPriority, AudioPriority, VideoPriority28, 48, 68; un número menor se envía antes
MediaGroupTimeout30s
PlayoutConfig.MinDelay100 ms
PlayoutConfig.MaxDelay400 ms, o MinDelay si es mayor
PlayoutConfig.MaxBehind50 ms
PlayoutConfig.MaxFrames8192 por track
PlayoutConfig.MaxBytes16 MiB por track
Objetos de video retenidoslos mismos dos límites otra vez, contados aparte: hasta el doble de cada uno, 32 MiB por defecto
Tracks de audio en un Playout1
Ventana de la referencialas últimas 2 s de llegadas, como máximo 8192
Frame adelantado respecto a la referenciase descarta si va más de 2 s adelantado
Espera de un objeto protegido por su claveMaxDelay, 400 ms por defecto
Objetos retenidos de un track protegidolos mismos dos límites otra vez, hasta tres veces cada uno con el ensamblador de grupos y el playout, 48 MiB por defecto
Objeto de catálogo retenido de una visualización protegida1, hasta que llega su clave o lo reemplaza una versión más nueva
Sobrecarga de un objeto de audio protegido24 bytes, 9,6 kbit/s a 50 objetos por segundo; menos del 1 por ciento en video
Memoria de un participante remoto protegido con audio y videohasta 80 MiB en kolo-media, más el MaxBufferedBytes de kolo-moq por cada una de sus suscripciones
Primer frame con una marca de tiempo muy adelantadasu track queda en silencio de 2 a 3 s y luego se reproduce
Peticiones de keyframe (WatchOptions.RequestKeyframes)tras 500 ms sin frames, luego 1 s, 2 s, 4 s y 8 s; tras cinco peticiones por silencio, ninguna más hasta 30 frames seguidos o una pérdida. Una petición sin respuesta se repite tras 1 s, 2 s, 4 s y 8 s, y cinco seguidas ponen fin a las peticiones hasta que se reproduce un frame

Consulta kolo-media, Conviene saber.

kolo-audio

Un valor fuera de rango devuelve ErrInvalidConfig, ErrInvalidArgument o ErrUnsupportedFormat.

LímiteValor
Format.SampleRate48000 Hz por defecto, de 8000 a 384000 Hz
Format.Channels1 por defecto, de 1 a 254
Config.Period10 ms, al menos un frame y como máximo Buffer
Config.Buffer120 ms, de Period a 2 s
Config.StallTimeout12 s, mayor que Period
Frecuencia de muestreo de Opus8000, 12000, 16000, 24000 o 48000 Hz
Canales de Opus1 o 2
Tasa de bits de Opusde 500 a 512000 bit/s, 0 deja elegir a libopus
Complejidad de Opusde 1 a 10, 0 mantiene el valor de libopus, 9
Pérdida de paquetes de Opusde 0 a 100 por ciento
CBR de Opusactivado o apagado; cada paquete es de (bitrate * duración del frame + 4) / 8 bytes, al menos 1
Duración del frame de Opus2,5, 5, 10, 20, 40 o 60 ms, 20 ms por defecto
opus.PacketBufferSize4000 bytes
opus.MaxPacketDuration120 ms
Paquete Opus más largo que se acepta61296 bytes; uno más largo es ErrInvalidPacket
DecodeLost, DecodeFECun múltiplo de 2,5 ms, como máximo 120 ms
Módulo de libopus1 MiB de memoria y una pila de 256 KiB, por cada codificador o decodificador
Módulo del resampler512 KiB de memoria
Memoria de un par codificador y decodificadorde 0,8 a 0,9 MB aproximadamente
PulseAudiocada petición, conexión y escritura 30 s; frames de hasta 16 MiB; como máximo 32 canales; versiones del protocolo de la 21 a la 32
WASAPI5 reintentos tras un cambio de ruta, de 100 ms a 1600 ms, 3,1 s en total
ALSAla reproducción se mantiene llena hasta 3 periodos
RequestAccesssin timeout propio: el aviso espera a la persona, el ctx de quien llama acota la espera y se devuelve ctx.Err() cuando termina

Consulta kolo-audio, Conviene saber.

kolo-video

Un valor fuera de rango devuelve ErrInvalidConfig o ErrInvalidFrame. Los tiempos se midieron en un Apple M5 y en una VM de Windows 11 ARM64.

LímiteValor
Ancho y alto de un framede 1 a 65536
CaptureConfig.Width, Height640 x 480 por defecto, como máximo 65536
CaptureConfig.FrameRate30 fps, de MinFrameRate (un frame por hora) a MaxFrameRate (1000)
CaptureConfig.Buffer2 frames; si se llena, se descarta el más antiguo
CaptureConfig.StallTimeout2 s, un valor negativo lo desactiva
CaptureConfig.MaxPixels8.912.896
Enumeración de V4L2 y Media Foundation1024 entradas
Tamaño de un frame VP8de 1 a 16383
Tamaño de un frame VP9de 1 a 65536
vpx.Config.FrameRate30 fps, de MinFrameRate a MaxFrameRate
vpx.Config.Bitrate0,07 bits por píxel por frame, unos 4,4 Mbit/s a 1080p30
vpx.Config.KeyframeInterval2 s sobre las marcas de tiempo de los frames, negativo para keyframes solo a petición
vpx.DecoderConfig.MaxPixels8.912.896, comprobado en cada cabecera de frame
vpx.DecoderConfig.MaxPacketBytes16 MiB, como mucho 256 MiB (ErrTooLarge), comprobado antes de copiar el paquete
Búfer de paquetes de vpx.Decodercomo mucho 1 MiB conservado entre llamadas
Motor native, tiempo real1920x1080 a 30 fps, codificar y decodificar
Motor portable, tiempo realcodificar hasta 640x480 a 30 fps, decodificar hasta 1920x1080
Memoria del motor portablecomo máximo 1 GiB por instancia
Tamaño de h264.Configpar, de 48 a 4096 por lado, como máximo 36864 macrobloques
Macrobloques por segundo de h264.Configcomo máximo 983040 (1920x1080 hasta 120 fps, 3840x2160 hasta 30 fps)
h264.Config.Bitrate0,07 bits por píxel por frame, de 1 a 240.000.000 bit/s
h264.Config.KeyframeInterval2 s sobre las marcas de tiempo de los frames, negativo para keyframes solo a petición
Nivel de salida de H.264como máximo 5.1 (Tabla A-1 de la especificación H.264)
Perfiles de H.264Constrained Baseline (por defecto), Main y High; profile_idc 66, 77 y 100 en el decodificador
h264.DecoderConfig.MaxPixels9.437.184 (36864 macrobloques), como máximo ese valor
h264.DecoderConfig.MaxPacketBytes16 MiB, como máximo 256 MiB
Unidades NAL en un paquete H.264como máximo MaxPixels / 256 + 288
Imagen del decodificador H.264cada lado de 48 a 4096 tras el recorte, como máximo 543 macrobloques por lado, dentro del nivel declarado
Niveles del decodificador H.264level_idc de 9 a 51, niveles de 1 a 5.1
Imágenes en un paquete H.2641
Tiempo de codificación H.264 en Windows1280x720 16,1 ms de mediana, 1920x1080 27,0 ms de mediana, una ejecución con las transformaciones por software

Consulta kolo-video, Conviene saber.

kolo-node

LímiteValor
-listen:7447
Archivo de -configun único objeto JSON de 64 KiB como máximo
-bootstraphost:port separados por comas, repetible; con -bootstrap-file y KOLO_BOOTSTRAP como mucho 16 entradas distintas, 8 direcciones por nombre, 64 en total
-bootstrap-fileun archivo de texto de como mucho 64 KiB, un host:port por línea, repetible
-firstfalso; verdadero significa sin nodos de entrada, se rechaza con -bootstrap o -bootstrap-file
KOLO_BOOTSTRAPsin definir; se lee solo cuando -bootstrap, -bootstrap-file y -first están todos sin definir
Resolución de nombres5s por nombre
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, como mínimo 75 con -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, hasta 100.000
-dht-max-requests10.000/s, hasta 1.000.000
-dht-request-timeout1s, de 100ms a 10s
-dht-punch-timeout45s, de 1s a 2m
relay -listen, relay -identityobligatorios; kolo-relay no tiene un puerto asignado
relay -allow-fileninguno (un relay abierto); un archivo de texto de como mucho 64 KiB con al menos una clave
Flags -relay-los valores por defecto y rangos de kolo-relay, ver kolo-node
-relay-max-conns, -relay-max-conns-per-ip128, de 1 a 10000; 4
Reintento hasta unirseal cabo de 1 minuto, duplicando la espera hasta 5 minutos
Nuevo bootstrap una vez unidocada 5 minutos mientras haya menos de 20 servidores
Apagado10s; después, salida con 1
Listener que rechaza16 conexiones, 16 pendientes, 1 saliente, 1 stream, ventanas de 64 KiB
checkde 1 a 16 direcciones, -timeout de 5s, de 1s a 1m
check -relay, -relay-file, KOLO_RELAYScomo mucho 16 relays distintos; un archivo de como mucho 64 KiB
Archivo de identidad, su directorio0600, 0700
Unidad de systemdMemoryMax=512M, GOMEMLIMIT=480MiB, reinicio al cabo de 5s
Búferes UDP (net.core.rmem_max, wmem_max)7500000
Puerto UDP7447

Consulta kolo-node, Conviene saber.

kolo-pin

LímiteValor
MaxBytes (todos los propietarios), -max-bytesDefaultMaxBytes, 100 GB; por encima, ErrDiskFull
Capability.Quota (un propietario)0 para ninguna; por encima, ErrQuotaExceeded
MaxOwners (registros de propietario), -max-ownersDefaultMaxOwners, 100.000; un propietario nuevo por encima es ErrOwnerLimit, los ya guardados nunca se rechazan
AddTimeout, -add-timeoutninguno; por encima, un Add da ErrBusy y se conserva lo guardado
-max-conns, -max-conns-per-ip100 (de 1 a 10000) y 4 (como mucho -max-conns), los límites de conexiones de kolo-transport
Una entradatiene que caber en un mensaje de kolo-sync de 4 MiB con su registro y la sobrecarga del cifrado; si no, ErrTooLarge
IDs de log en una capacidadMaxLogs, 256, o ninguno para todos los logs del propietario
Capacidadcomo máximo MaxCapabilitySize, 8353 bytes
Peticióncomo máximo MaxRequestSize, 8389 bytes, de una en una por conexión
Leer una petición, escribir una respuestaTimeout, 60s
Hora de emisión en el futuro del peercomo máximo 60s
Horas de una capacidadsegundos Unix enteros, hasta 2^53-1
Comprobación de capacidades caducadascada minuto
Log abierto sin usarse cierra al cabo de un minuto
Logs abiertoscomo máximo 64; primero se cierran los usados hace más tiempo
Memoria de un log abiertounos 250 bytes por entrada; en el peor caso, unas 0,42 veces MaxBytes para 64 logs abiertos
Conexión a un peer de anclaje10s; después, ErrUnreachable
DefaultCopies, MaxFallback2, 2
Reintento de un borrado de log fallidotras 1 minuto, luego el doble cada vez, hasta 64 minutos
Directorio de datos, identity.key0700, 0600
-listen127.0.0.1:7450
-health127.0.0.1:7451
-metrics127.0.0.1:7452

Los dos límites de bytes cuentan las claves y los valores guardados, no los bloques de disco, y se comprueban antes de guardar nada. No se expulsa nada para hacer sitio, y los borrados siempre pasan. Consulta kolo-pin, Conviene saber.