Decodificatore flag TCP

Contratto di ingresso, decodifica rispetto a codifica, e forma della risposta

Imposti mode su decode oppure encode. Il confronto ignora le maiuscole; sono accettati anche spazi, barre verticali e punti e virgola come separatori; i nomi duplicati vengono ignorati perché l'OR bit a bit è idempotente. Un array flags vuoto codifica il byte zero, insolito sul filo ma lecito come maschera. Le chiavi opzionali sono omesse anziché poste a null. La convalida fallita non viene fatturata. In mode decode, value è obbligatorio e può essere un numero JSON o una stringa: il decimale 18, l'esadecimale 0x12 o il binario 0b00010010 indicano lo stesso byte SYN-ACK. Interi fuori da 0 a 255, numeri non interi, stringhe vuote e testo senza prefisso falliscono con invalid_input indicando value. In mode encode, flags è obbligatorio e può essere una stringa separata da virgole come SYN,ACK oppure un array JSON di quei nomi. I token sconosciuti, compreso NS o soprannomi inventati, falliscono con invalid_input che elenca gli otto nomi leciti. In caso di successo il corpo include sempre mode, value_decimal, value_hex (due cifre minuscole), value_binary (otto bit), flags come array ordinato, flags_string con gli stessi nomi uniti da virgole, lettere tcpdump, otto campi booleani da fin a cwr, e una stringa formula che ribadisce i pesi dei bit. Esempio: decode 0x12 produce flags SYN e ACK, tcpdump S. e value_decimal 18; encode SYN,ACK produce il byte identico, così i due mode sono inversi esatti.

Dove un decodificatore di flag TCP merita davvero il proprio posto

I laboratori di protocollo e le esercitazioni da colloquio chiedono ancora agli studenti di leggere un dump hex e dire se un segmento è un SYN, un SYN-ACK o un RST isolato; un decodificatore condiviso è l'oracolo che valuta quelle risposte senza discutere la numerazione dei bit. Chi scrive firewall e BPF codifica un insieme di nomi nel byte che pone accanto a una maschera, poi decodifica gli accoppiamenti di produzione per confermare che la regola ha visto SYN e non SYN-ACK. Fissi l'hex, l'array ordinato di flags e il glifo tcpdump nelle prove, e otterrà un'aritmetica di handshake riproducibile per worker di bordo, quiz sui pacchetti e tracce di socket, senza erigere un'intera pila di dissettori solo per nominare otto bit. Le pipeline di cattura che già memorizzano l'ottetto dei flag TCP come intero possono chiamare questo endpoint per allegare nomi umani prima che un ticket o una cella di cruscotto sia mostrata all'ingegnere di turno. Poiché l'implementazione è parse pura di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita.