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ímite | Valor |
|---|---|
| Semilla | exactamente 32 bytes |
| Archivo de clave | archivo normal de exactamente 32 bytes |
| Contexto de firma | de 1 a 255 bytes |
Clave pública para Verify | 32 bytes |
Claves de orden pequeño que rechaza Verify | las 14 codificaciones |
| Modo del archivo de clave | 0600 |
| Modo de un directorio padre nuevo | 0700 |
| Frase de recuperación | exactamente 24 palabras de la lista inglesa de BIP-39, solo ASCII; ParsePhrase lee como mucho 1024 bytes |
| Certificado | como mucho 256 bytes, o 514 con un padre aprobador |
| Oferta de certificado | como mucho 450 bytes, 192 sin padre |
| Revocación | como mucho 472 bytes, 182 cuando la firma la clave de la persona o el propio dispositivo |
| Archivo de certificado | de 1 a 514 bytes, modo 0600 |
| Cadena de certificados | como mucho 2 certificados (persona, aprobador, dispositivo); un aprobador no puede emitir otro aprobador |
| Número de serie de un certificado | al menos 1 |
Contextos que empiezan por kolo-id/device- | los rechazan Sign (ErrInvalidContext) y VerifyDevice |
Trabajo de un VerifyDevice | como 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ímite | Valor |
|---|---|
| Varint | como 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 |
| Bool | un byte, 0 o 1 |
Consulta kolo-codec, Conviene saber.
kolo-log
| Límite | Valor |
|---|---|
| Tamaño de entrada, 64 bits | unos 254 GiB |
| Tamaño de entrada, 32 bits | unos 512 MiB |
| Entrada con relleno más pequeña | 256 bytes (entradas de hasta 254 bytes) |
| Entrada en disco | un frame de 256 bytes y 296 bytes de texto cifrado guardado para entradas de hasta 254 bytes |
| Relleno de las entradas más grandes | Padmé, como mucho un 6 % más |
| Memoria por entrada | unos 64 bytes de hashes del árbol y 144 bytes de registro, sea cual sea el tamaño de la entrada |
| ID de log | 32 bytes, aleatorio |
| Hash del árbol | 32 bytes (BLAKE2b-256) |
| Ruta de prueba | como máximo 65 hashes |
| Entrada JSON | como máximo 4 KiB, 8 KiB para pruebas |
| Logs escribibles por (clave de autor, ID de log) | 1 por proceso (ErrLogOpen) |
Logs por Storage | 1: New y NewReplica devuelven ErrStorageNotEmpty para un almacenamiento que ya guarda una entrada |
AddKeys | como 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ímite | Valor |
|---|---|
| Directorio del almacén | se crea con modo 0700; se rechaza si el grupo u otros tienen acceso |
| Modo de los archivos de Pebble | 0600 para todo archivo que Pebble crea en el directorio |
PebbleOptions.MemTableSize | 0 (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 log | 1 por backend en cada proceso (ErrLogInUse) |
| Logs por ID de log en un almacén | 1, sea quien sea el propietario; un ID guardado para otro propietario devuelve kololog.ErrBadLogHeader |
| Memoria por log o réplica abiertos | unos 250 bytes por entrada, sea cual sea el tamaño de la entrada |
Lote de un Adopt | menos 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 Pebble | menos de 4 GiB - 1 bytes (2 GiB - 1 en 32 bits); ErrTooLarge en otro caso |
| Registro, head o marca de borrado guardados | como máximo 1024 bytes |
| Clave de entrada guardada | exactamente 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éplica | como máximo 1024 bytes |
| Prueba de puesta al día de una réplica | como máximo 65 hashes |
| Versión del valor de entrada guardado | 3 (las versiones 1 y 2 se rechazan) |
Consulta kolo-store, Conviene saber.
kolo-sync
| Límite | Valor |
|---|---|
MaxMessageSize | 4 MiB; el prefijo de longitud se comprueba antes de reservar memoria |
| Entrada cuyo texto cifrado con relleno no cabe en un mensaje | no se puede sincronizar ni traer con Fetch (ErrTooLarge), esté borrada o no, y el log no se sincroniza más allá de ella |
MaxStreams | 16 por conexión, sean de pull o de fetch; a los demás se les responde «ocupado» |
ServerOptions.MaxTotalStreams | 256 (DefaultMaxTotalStreams) entre todas las conexiones; a los demás se les responde «ocupado» (ErrBusy en el cliente) |
ServerOptions.MaxAnswerBytes | 256 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» |
Timeout | 60s 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 |
MinRate | 16 KiB/s, la velocidad media mínima de un mensaje |
| Respuesta a una petición de entradas | unos 1 MiB; una entrada mayor va sola, hasta MaxMessageSize |
PullOptions.InFlight | de 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 streaming | 2 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ún | 6 MiB como máximo; un commit guarda las respuestas que esperan hasta 4 MiB |
| Entradas que mira una respuesta STATE | como 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 red | como máximo 4 KiB cada uno |
| Clave de entrada en la red | 0 o 32 bytes |
Memoria de Fetch | el rango pedido, como mucho un mensaje más |
Consulta kolo-sync, Conviene saber.
kolo-kv
| Límite | Valor |
|---|---|
MaxKeySize | 32 KiB (la clave vacía es válida) |
MaxValueSize | 1 MiB |
| Valores de una clave | cuando una clave tiene 65.536 valores desde su último borrado, el siguiente Put primero los borra |
| Entradas que lista una entrada de borrado | de 1 a 65.536 |
| Destrucción de las entradas listadas | un solo Log.Delete, una sola escritura duradera |
| Memoria | el í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ímite | Valor |
|---|---|
GroupConfig.MaxMembers | 64, de 2 a 1024 |
GroupConfig.MaxSettlers | 7 o MaxMembers si es menor, de 1 a 64 |
GroupConfig.MinSettlers | 4 o MaxSettlers si es menor, de 1 a MaxSettlers |
GroupConfig.MaxBody | 1 MiB, de 1 KiB a 3 MiB |
GroupConfig.CheckpointEvery | 1024 posiciones asentadas, de 64 a 2^20 |
Limits.MaxTail | 2048 entradas, de 64 a 2^20 |
Limits.MaxPendingBytes | 16 MiB, de 1 MiB a 1 GiB; un strand guarda como máximo MaxPendingBytes / MaxMembers de ellos, una entrada siempre cabe |
Limits.MaxForks | 4, 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.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 |
| Clave y valor de la vista | 32 KiB y 1 MiB |
| Escrituras de una entrada | 16 x MaxBody, y cada operación cuesta su clave y su valor más 256 bytes |
| Etiqueta de app | de 1 a 64 bytes de UTF-8 |
| Solicitud de entrada y welcome | 64 KiB y 1 MiB |
| Mensaje de stream | 4 MiB |
| Pulls a la vez | 16, uno por strand |
| Respuesta a una petición, clave desconocida | 60 s, después se cierra la conexión |
| Disco por entrada | unos 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ímite | Valor |
|---|---|
MaxCertsPerPerson | 1024, de 1 a 2^20: los certificados de una persona en una vista |
PersonCertReserve | un octavo de MaxCertsPerPerson (128), de 0 a MaxCertsPerPerson, -1 para ninguno: huecos reservados para certificados emitidos por la clave de la persona |
MaxRevocationsPerDevice | 64, de 1 a 2^16: revocaciones de aprobador de una clave de dispositivo |
MaxDevices | ninguno 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ón | 514, 450 y 472 bytes, las codificaciones de kolo-id |
| Solicitud de unión con prueba | 64 KiB; una prueba ocupa menos de 700 bytes |
Consulta kolo-braid, Conviene saber.
kolo-transport
| Límite | Valor |
|---|---|
Network | solo "udp4" |
MaxConns | 100, de 1 a 10000 |
MaxConnsPerIP | 4 (o MaxConns si es menor), de 1 a MaxConns |
MaxDialed | 32, de 1 a 10000 |
MaxIncomingStreams | 16 de cada tipo por conexión, de 1 a 1000 |
HandshakeTimeout | 10s, de 1s a 60s (también la vida de un token Retry) |
IdleTimeout | 30s, de 1s a 10m |
| Mínimo que se toma para el tiempo de inactividad del peer | 5s |
KeepAlivePeriod | 5s (o IdleTimeout/2 si es menor), desde 500ms hasta justo por debajo 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" (por defecto), "cubic" o "bbr"; cualquier otro valor es ErrInvalidConfig |
WindowGrowth | desactivado; activado, Conn.AllowWindowGrowth deja crecer las ventanas de una conexión |
MaxGrownStreamReceiveWindow | 4 MiB, de MaxStreamReceiveWindow a 16 MiB (solo con WindowGrowth) |
MaxGrownConnReceiveWindow | 8 MiB, de MaxConnReceiveWindow a 64 MiB (solo con WindowGrowth) |
MaxGrownMemory | 64 MiB, de 1 MiB a 64 GiB, compartido por las conexiones de un Listener (solo con WindowGrowth) |
| Muestras de BBR | como mucho 40000 números de paquete, unos 5,5 MiB por conexión BBR; las muestras más antiguas se descartan |
| Cola de aceptación | 32 conexiones |
MaxPacketSize (datagramas que no son QUIC) | 1200 bytes |
| Cola de datagramas que no son QUIC | 32 datagramas |
MaxCode | 2^62-1 |
Mensaje de CloseWithError | como máximo 256 bytes |
Salida de ExportKey | 32 bytes |
| Vida de un token NEW_TOKEN | 1ns |
Listener.Close sobre una conn que ignora los plazos | 1s |
Datagramas de ListenConn | al menos 1280 bytes; lo que pasa de 1452 se trunca |
Consulta kolo-transport, Conviene saber.
kolo-secure
| Límite | Valor |
|---|---|
HandshakeTimeout | 10s después del handshake de QUIC, de 1s a 60s |
MaxPending | 64 por listener, de 1 a 1000 |
| Mensaje del handshake | cuerpo de 1 a 256 bytes, longitud de 2 bytes como mucho |
| Mensaje real del handshake más grande | 98 bytes |
Clave remote | 32 bytes |
| Codificaciones de orden pequeño rechazadas | 14 |
| Otras claves que puede demostrar quien tiene una clave | hasta 7 |
| Valor del exportador | 32 bytes |
| Código de cierre de un handshake fallido | 1 |
Consulta kolo-secure, Conviene saber.
kolo-dht
| Límite | Valor |
|---|---|
MaxRecords | 65536 por servidor, de 16 a 1.000.000 |
MaxRecordsPerTopic | 512, de 1 a 65536 (un dieciseisavo por /24 de 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 (conexiones 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 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 |
RequestTimeout | 1s, de 100ms a 10s |
| Peticiones fallidas antes de descartar una entrada de la tabla | 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; se duplica hasta 16 veces más |
MaxRandomPunchesPerMinute | 4, de 1 a 64 |
MaxPunchSockets | 256 o la mitad del RLIMIT_NOFILE blando, de 1 a 16384 |
KeepAlivePeriod de las conexiones perforadas | 5s salvo que IdleTimeout sea de 5s o menos |
Cola de Accept | Secure.MaxPending, 64 por defecto |
| Datagrama | como máximo 1200 bytes |
| Respuesta | como máximo 20 nodos y 16 registros |
| Tabla de enrutamiento | 256 buckets de 20; por /24, 2 en un bucket y 10 en total |
| Registro | se refresca cada 15s y se descarta 20 minutos después del último refresco |
| Búsqueda | 10 servidores a la vez, 100 en total, 160 comprobaciones de firma |
Relays por Connect | 3 |
Direcciones de Bootstrap | 64 |
| Token de ida y vuelta | se acepta entre 40 y 80s |
| IDs de nodo por dirección IPv4 | 8 |
Consulta kolo-dht, Conviene saber.
kolo-swarm
| Límite | Valor |
|---|---|
MaxPeers | 64, de 1 a 1024 |
MaxInbound | MaxPeers/2 redondeado hacia arriba (32), de 1 a MaxPeers |
MaxTopics | 16, de 1 a 32 |
| Topics por hello | 32 |
MaxConnecting | 3, de 1 a 16 |
| Llamadas a través de relays a la vez | hasta MaxConnecting, contadas aparte de las llamadas a Connect de kolo-dht |
Config.Relays | vacía por defecto, como mucho 16 relays |
| Primer contacto a través de un relay | tras hasta 3 x PunchTimeout de kolo-dht (135s), luego como mucho 60s por cada relay que se prueba |
MaxHandshakes | 16, de 1 a 256 |
MaxHandshakesPerIP | 4 (o MaxHandshakes si es menor), de 1 a MaxHandshakes |
| Hellos a la vez por clave | 2 |
MaxCandidates | 1024, de 16 a 32768 |
MaxEvents | 64, de 16 a 4096 |
HelloTimeout | 10s, de 1s a 60s (2s por paso) |
LookupInterval | 10m más hasta una quinta parte al azar, de 1s a 1h |
RetryMin | 1s, de 100ms a 1m |
RetryMax | 10m, de RetryMin a 1h |
| Conexión que pone a cero el contador de fallos | dura 15s |
| Llamadas a la vez por host | 2 |
| HELLO, REPLY | como máximo 1026 y 1044 bytes |
BootstrapNodes | vací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 total | 8 por nombre, 64 en total |
| Resolver un nombre de bootstrap | 5s por nombre, en paralelo, dentro de ctx |
Archivo de LoadNodes | un archivo regular de como mucho 64 KiB |
Consulta kolo-swarm, Conviene saber.
kolo-relay
| Límite | Valor |
|---|---|
MaxReservations | 64, de 1 a 100000 |
MaxSessions | 16, de 1 a 10000 |
MaxSessionsPerPeer | 4 (o MaxSessions si es menor) |
MaxSessionsPerTarget | 8 (o MaxSessions si es menor) |
ReservationLifetime | 1h, de 1s a 24h |
MaxSessionDuration | 1h, de 1s a 24h |
MaxSessionBytes | 1 GiB en 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 conexión 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 del relay con Secure a nil | MaxConns 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 cero | 10s |
| Espera del destino a un peer anunciado | 40s con los valores por defecto |
| Mensaje de control | como máximo 64 bytes |
| Trama de paquete | como máximo 1452 bytes |
| Búfer de copia | 64 KiB por sentido |
| Paquetes internos | 1280 bytes |
Reservation.Close, Conn.Close | unos 2s |
Server.Close por iniciador | hasta 1s |
Consulta kolo-relay, Conviene saber.
kolo-invite
| Límite | Valor |
|---|---|
Campo de Options a cero o negativo | a cero toma su valor por defecto, negativo es ErrInvalidArgument |
Timeout | 30s |
| Cierre de una conexión inactiva que solo es de invitación | entre Timeout y 1,25 veces Timeout |
MaxData | 64 KiB, como mucho 1 GiB |
MaxPending | 1024 |
MaxPendingPerSource | 16 |
PendingTTL | ninguno; una petición Manual que esperó ese tiempo se retira, como si su solicitante se hubiera ido |
MaxPendingDevices | 4 peticiones pendientes de vincular un dispositivo, entre todas las invitaciones de dispositivo; las demás reciben ErrBusy |
MaxDeviceName | 64 bytes, de 1 a MaxData |
DevicePendingTTL | 2 minutos; después la petición se retira y su código queda quemado |
DeviceOptions.TTL | 5 minutos, lo que dura un código de dispositivo |
DeviceJoinOptions.MaxName, MaxPayload | 64 bytes y 4096 bytes en el dispositivo nuevo |
MaxStreams | 8 por conexión |
SourceRate | 60 por minuto por origen, ráfagas de hasta 60 |
InviteRate | 600 por minuto por invitación, ráfagas de hasta 600 |
MaxSources | 4096 |
MaxEvents | 1024 |
JoinOptions.MaxPayload | 1 MiB |
CreateOptions.TTL | a cero no caduca nunca |
CreateOptions.MaxUses | a cero significa 1, sin límite superior |
CreateOptions.Payload | como mucho 1 GiB, vacío con Manual |
| Carga útil y datos de unión | como mucho 1 GiB |
| Tramas OPEN y CHALLENGE | como mucho 64 bytes |
| Otras tramas | como mucho max(512, Padmé(n + 256)) + 256 bytes, n es MaxData o MaxPayload |
| Texto en claro rellenado | al menos 512 bytes, Padmé por encima |
| Respuestas de un mismo tamaño | carga útil de hasta 508 bytes |
| Código | 92 caracteres, prefijo koloinv0, todo en minúsculas o todo en mayúsculas |
| Huella, secreto, suma de comprobación | 16, 32 y 4 bytes |
| Desafío | 32 bytes por stream |
Linger | 5 minutos |
Reintento de Announce | espera creciente de 1s a 1 minuto |
| Topics de invitación | comparten el MaxTopics del swarm (16, como mucho 32) |
Peticiones terminadas que recuerdan Approve y Deny | las últimas MaxPending |
| Registro de invitación | unos 100 bytes más su carga útil |
| Espera de quien se une con los valores por defecto de kolo-swarm | hasta 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ímite | Valor |
|---|---|
SetupTimeout, RequestTimeout | 10s cada uno, de 1s a 10m |
MaxRequests, MaxSubscriptions | 1000 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 |
MaxControlMessageSize | 65535, de 8192 a 65535 |
MaxNamespaceFields, MaxNameLength | 32 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 |
MaxFetchBytes | MaxBufferedBytes, 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.MaxTracks | 1000, de 1 a 1000000 |
OriginConfig.MaxObjectSize (un payload escrito en el origin) | 16 MiB, de 1 KiB a 1 GiB |
TrackOptions.Priority | 128 (DefaultPriority), de 0 a 255; menor es más urgente |
TrackOptions.CacheGroups, CacheBytes | 16 grupos, 32 MiB; de 1 a 1000000 grupos, de 1 KiB a 64 GiB |
| Timeouts de entrega | ninguno; un valor menor de 1 ms se redondea hacia arriba a 1 ms |
RelayConfig.MaxTracks | 1000, de 1 a 1000000 |
RelayConfig.MaxSessionTracks | MaxTracks entre 10, como mínimo 1; los que superan ese número reciben EXCESSIVE_LOAD |
RelayConfig.MaxSessionFetches | 16, de 1 a 1000000; los que superan ese número reciben EXCESSIVE_LOAD |
RelayConfig.Resume | 0 (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.MaxResumeHeld | 10000, de 1 a 1000000: anuncios conservados a la vez para sesiones terminadas; uno que no cabe se retira con su sesión |
RelayConfig.MaxPeerResumeHeld | el MaxRequests de la sesión (1000), o MaxResumeHeld si es menor, de 1 a MaxResumeHeld: anuncios conservados para una clave de peer |
NewGroupRequestInterval | 1s 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, CacheBytes | como en TrackOptions, para cada track reenviado |
KeyringConfig.Retain, RetainMax | 450 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.MaxSenders | 64, de 1 a 1024; más llamadas a Receive fallan con ErrTooManySenders |
KeyringConfig.MaxKeyRate | 64 mensajes de clave por namespace y segundo, de 1 a 1024; los demás se descartan y se cuentan |
KeyringConfig.ReplayGroups, ReplayObjects | 64 grupos y 8192 entradas por Opener, de 1 a 1000000 |
SenderConfig.MaxTracks | 1024, de 1 a 1000000; un track más rota la clave |
| Texto plano sellado con una clave de track | 2^24 unidades de 16 KiB, y después el Sender rota |
| Object ID de un objeto sellado, namespace de un broadcast protegido | menor 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 peer | como 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 KiB | se lee a medida que llega |
| IDs de petición comprobados contra repeticiones | los últimos 65536 números; los más antiguos cuentan como repetidos |
| Stream sin avance | se reinicia tras RequestTimeout |
MaxIncomingStreams de kolo-transport | 16 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ímite | Valor |
|---|---|
CatalogLimits.MaxTracks | 1024 |
CatalogLimits.MaxNameLen | 4096 bytes |
CatalogLimits.MaxConfigLen | 65508 bytes, la mayor config que cabe en una propiedad de objeto |
| Tamaño del catálogo | tiene que caber en el MaxObjectSize del origin, 16 MiB en kolo-moq; si no, ErrInvalidCatalog |
| Tracks de medios de un origin por defecto | 999, porque el track de catálogo cuenta para el MaxTracks del origin; después, ErrTooManyTracks |
CatalogPriority, AudioPriority, VideoPriority | 28, 48, 68; un número menor se envía antes |
MediaGroupTimeout | 30s |
PlayoutConfig.MinDelay | 100 ms |
PlayoutConfig.MaxDelay | 400 ms, o MinDelay si es mayor |
PlayoutConfig.MaxBehind | 50 ms |
PlayoutConfig.MaxFrames | 8192 por track |
PlayoutConfig.MaxBytes | 16 MiB por track |
| Objetos de video retenidos | los mismos dos límites otra vez, contados aparte: hasta el doble de cada uno, 32 MiB por defecto |
Tracks de audio en un Playout | 1 |
| Ventana de la referencia | las últimas 2 s de llegadas, como máximo 8192 |
| Frame adelantado respecto a la referencia | se descarta si va más de 2 s adelantado |
| Espera de un objeto protegido por su clave | MaxDelay, 400 ms por defecto |
| Objetos retenidos de un track protegido | los 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 protegida | 1, hasta que llega su clave o lo reemplaza una versión más nueva |
| Sobrecarga de un objeto de audio protegido | 24 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 video | hasta 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 adelantada | su 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ímite | Valor |
|---|---|
Format.SampleRate | 48000 Hz por defecto, de 8000 a 384000 Hz |
Format.Channels | 1 por defecto, de 1 a 254 |
Config.Period | 10 ms, al menos un frame y como máximo Buffer |
Config.Buffer | 120 ms, de Period a 2 s |
Config.StallTimeout | 12 s, mayor que Period |
| Frecuencia de muestreo de Opus | 8000, 12000, 16000, 24000 o 48000 Hz |
| Canales de Opus | 1 o 2 |
| Tasa de bits de Opus | de 500 a 512000 bit/s, 0 deja elegir a libopus |
| Complejidad de Opus | de 1 a 10, 0 mantiene el valor de libopus, 9 |
| Pérdida de paquetes de Opus | de 0 a 100 por ciento |
CBR de Opus | activado o apagado; cada paquete es de (bitrate * duración del frame + 4) / 8 bytes, al menos 1 |
| Duración del frame de Opus | 2,5, 5, 10, 20, 40 o 60 ms, 20 ms por defecto |
opus.PacketBufferSize | 4000 bytes |
opus.MaxPacketDuration | 120 ms |
| Paquete Opus más largo que se acepta | 61296 bytes; uno más largo es ErrInvalidPacket |
DecodeLost, DecodeFEC | un múltiplo de 2,5 ms, como máximo 120 ms |
| Módulo de libopus | 1 MiB de memoria y una pila de 256 KiB, por cada codificador o decodificador |
| Módulo del resampler | 512 KiB de memoria |
| Memoria de un par codificador y decodificador | de 0,8 a 0,9 MB aproximadamente |
| PulseAudio | cada 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 |
| WASAPI | 5 reintentos tras un cambio de ruta, de 100 ms a 1600 ms, 3,1 s en total |
| ALSA | la reproducción se mantiene llena hasta 3 periodos |
RequestAccess | sin 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ímite | Valor |
|---|---|
| Ancho y alto de un frame | de 1 a 65536 |
CaptureConfig.Width, Height | 640 x 480 por defecto, como máximo 65536 |
CaptureConfig.FrameRate | 30 fps, de MinFrameRate (un frame por hora) a MaxFrameRate (1000) |
CaptureConfig.Buffer | 2 frames; si se llena, se descarta el más antiguo |
CaptureConfig.StallTimeout | 2 s, un valor negativo lo desactiva |
CaptureConfig.MaxPixels | 8.912.896 |
| Enumeración de V4L2 y Media Foundation | 1024 entradas |
| Tamaño de un frame VP8 | de 1 a 16383 |
| Tamaño de un frame VP9 | de 1 a 65536 |
vpx.Config.FrameRate | 30 fps, de MinFrameRate a MaxFrameRate |
vpx.Config.Bitrate | 0,07 bits por píxel por frame, unos 4,4 Mbit/s a 1080p30 |
vpx.Config.KeyframeInterval | 2 s sobre las marcas de tiempo de los frames, negativo para keyframes solo a petición |
vpx.DecoderConfig.MaxPixels | 8.912.896, comprobado en cada cabecera de frame |
vpx.DecoderConfig.MaxPacketBytes | 16 MiB, como mucho 256 MiB (ErrTooLarge), comprobado antes de copiar el paquete |
Búfer de paquetes de vpx.Decoder | como mucho 1 MiB conservado entre llamadas |
| Motor native, tiempo real | 1920x1080 a 30 fps, codificar y decodificar |
| Motor portable, tiempo real | codificar hasta 640x480 a 30 fps, decodificar hasta 1920x1080 |
| Memoria del motor portable | como máximo 1 GiB por instancia |
Tamaño de h264.Config | par, de 48 a 4096 por lado, como máximo 36864 macrobloques |
Macrobloques por segundo de h264.Config | como máximo 983040 (1920x1080 hasta 120 fps, 3840x2160 hasta 30 fps) |
h264.Config.Bitrate | 0,07 bits por píxel por frame, de 1 a 240.000.000 bit/s |
h264.Config.KeyframeInterval | 2 s sobre las marcas de tiempo de los frames, negativo para keyframes solo a petición |
| Nivel de salida de H.264 | como máximo 5.1 (Tabla A-1 de la especificación H.264) |
| Perfiles de H.264 | Constrained Baseline (por defecto), Main y High; profile_idc 66, 77 y 100 en el decodificador |
h264.DecoderConfig.MaxPixels | 9.437.184 (36864 macrobloques), como máximo ese valor |
h264.DecoderConfig.MaxPacketBytes | 16 MiB, como máximo 256 MiB |
| Unidades NAL en un paquete H.264 | como máximo MaxPixels / 256 + 288 |
| Imagen del decodificador H.264 | cada lado de 48 a 4096 tras el recorte, como máximo 543 macrobloques por lado, dentro del nivel declarado |
| Niveles del decodificador H.264 | level_idc de 9 a 51, niveles de 1 a 5.1 |
| Imágenes en un paquete H.264 | 1 |
| Tiempo de codificación H.264 en Windows | 1280x720 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ímite | Valor |
|---|---|
-listen | :7447 |
Archivo de -config | un único objeto JSON de 64 KiB como máximo |
-bootstrap | host:port separados por comas, repetible; con -bootstrap-file y KOLO_BOOTSTRAP como mucho 16 entradas distintas, 8 direcciones por nombre, 64 en total |
-bootstrap-file | un archivo de texto de como mucho 64 KiB, un host:port por línea, repetible |
-first | falso; verdadero significa sin nodos de entrada, se rechaza con -bootstrap o -bootstrap-file |
KOLO_BOOTSTRAP | sin definir; se lee solo cuando -bootstrap, -bootstrap-file y -first están todos sin definir |
| Resolución de nombres | 5s por nombre |
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, como mínimo 75 con -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, hasta 100.000 |
-dht-max-requests | 10.000/s, hasta 1.000.000 |
-dht-request-timeout | 1s, de 100ms a 10s |
-dht-punch-timeout | 45s, de 1s a 2m |
relay -listen, relay -identity | obligatorios; kolo-relay no tiene un puerto asignado |
relay -allow-file | ninguno (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-ip | 128, de 1 a 10000; 4 |
| Reintento hasta unirse | al cabo de 1 minuto, duplicando la espera hasta 5 minutos |
| Nuevo bootstrap una vez unido | cada 5 minutos mientras haya menos de 20 servidores |
| Apagado | 10s; después, salida con 1 |
| Listener que rechaza | 16 conexiones, 16 pendientes, 1 saliente, 1 stream, ventanas de 64 KiB |
check | de 1 a 16 direcciones, -timeout de 5s, de 1s a 1m |
check -relay, -relay-file, KOLO_RELAYS | como mucho 16 relays distintos; un archivo de como mucho 64 KiB |
| Archivo de identidad, su directorio | 0600, 0700 |
| Unidad de systemd | MemoryMax=512M, GOMEMLIMIT=480MiB, reinicio al cabo de 5s |
Búferes UDP (net.core.rmem_max, wmem_max) | 7500000 |
| Puerto UDP | 7447 |
Consulta kolo-node, Conviene saber.
kolo-pin
| Límite | Valor |
|---|---|
MaxBytes (todos los propietarios), -max-bytes | DefaultMaxBytes, 100 GB; por encima, ErrDiskFull |
Capability.Quota (un propietario) | 0 para ninguna; por encima, ErrQuotaExceeded |
MaxOwners (registros de propietario), -max-owners | DefaultMaxOwners, 100.000; un propietario nuevo por encima es ErrOwnerLimit, los ya guardados nunca se rechazan |
AddTimeout, -add-timeout | ninguno; por encima, un Add da ErrBusy y se conserva lo guardado |
-max-conns, -max-conns-per-ip | 100 (de 1 a 10000) y 4 (como mucho -max-conns), los límites de conexiones de kolo-transport |
| Una entrada | tiene 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 capacidad | MaxLogs, 256, o ninguno para todos los logs del propietario |
| Capacidad | como máximo MaxCapabilitySize, 8353 bytes |
| Petición | como máximo MaxRequestSize, 8389 bytes, de una en una por conexión |
| Leer una petición, escribir una respuesta | Timeout, 60s |
| Hora de emisión en el futuro del peer | como máximo 60s |
| Horas de una capacidad | segundos Unix enteros, hasta 2^53-1 |
| Comprobación de capacidades caducadas | cada minuto |
| Log abierto sin usar | se cierra al cabo de un minuto |
| Logs abiertos | como máximo 64; primero se cierran los usados hace más tiempo |
| Memoria de un log abierto | unos 250 bytes por entrada; en el peor caso, unas 0,42 veces MaxBytes para 64 logs abiertos |
| Conexión a un peer de anclaje | 10s; después, ErrUnreachable |
DefaultCopies, MaxFallback | 2, 2 |
| Reintento de un borrado de log fallido | tras 1 minuto, luego el doble cada vez, hasta 64 minutos |
Directorio de datos, identity.key | 0700, 0600 |
-listen | 127.0.0.1:7450 |
-health | 127.0.0.1:7451 |
-metrics | 127.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.