Skip to content
KitploitKITPLOIT
StrumentiExploitsBlog
Log in
Invia
StrumentiExploitsBlog
Invia

Strumenti di Hacking, PenTest e Cybersecurity per il tuo Arsenale di Sicurezza!

Kitploit è una directory di strumenti di hacking, cybersecurity e pentesting. Scopri gli ultimi aggiornamenti dei progetti per trovare vulnerabilità, analizzare sistemi, automatizzare i test e rafforzare la tua sicurezza.

FeedContattoPrivacy© 2026 Kitploit

Directory degli strumenti

Categorie

Vedi tutte le categorie
Loading categories
failpoint — Libreria di fault-injection per Go che aggiunge failpoint controllabili a runtime per innescare panic, sleep, return e percorsi di errore condizionali tramite variabili d'ambiente. | Kitploit
Strumenti/GitHubGitHub/pingcap/failpoint
Utilità GenericheDebuggerIngegneria del CaosTop in Ingegneria del Caos n.18
GitHubpingcap/failpoint

failpoint

Libreria di fault-injection per Go che aggiunge failpoint controllabili a runtime per innescare panic, sleep, return e percorsi di errore condizionali tramite variabili d'ambiente.

Vedi Repository
89970972 giorni faRevisionato da Kitploit
Condividi

failpoint

LICENSE Language Go Report Card Build Status Coverage Status Mentioned in Awesome Go

Un'implementazione dei failpoint per Golang. I failpoint vengono usati per aggiungere punti nel codice in cui gli errori possono essere iniettati in modo controllato dall'utente. Un failpoint è uno snippet di codice che viene eseguito solo quando il corrispondente failpoint è attivo.

Avvio rapido (usa failpoint-ctl)

  1. Compila failpoint-ctl dal sorgente

    git clone https://github.com/pingcap/failpoint.git
    cd failpoint
    make
    ls bin/failpoint-ctl
    
  2. Inietta i failpoint nel tuo programma, ad esempio:

    package main
    
    import "github.com/pingcap/failpoint"
    
    func main() {
        failpoint.Inject("testPanic", func() {
            panic("failpoint triggerd")
        })
    }
    
  3. Trasforma il tuo codice con failpoint-ctl enable

  4. Compila con go build

  5. Abilita i failpoint con la variabile d'ambiente GO_FAILPOINTS

    GO_FAILPOINTS="main/testPanic=return(true)" ./your-program
    

    Nota: GO_FAILPOINTS non funziona con il tipo di marcatore InjectCall.

  6. Se usi go run per eseguire il test, non dimenticare di aggiungere il file generato binding__failpoint_binding__.go al tuo comando, ad esempio:

    GO_FAILPOINTS="main/testPanic=return(true)" go run your-program.go binding__failpoint_binding__.go
    

Avvio rapido (usa failpoint-toolexec)

  1. Compila failpoint-toolexec dal sorgente

    git clone https://github.com/pingcap/failpoint.git
    cd failpoint
    make
    ls bin/failpoint-toolexec
    
  2. Inietta i failpoint nel tuo programma, ad esempio:

    package main
    
    import "github.com/pingcap/failpoint"
    
    func main() {
        failpoint.Inject("testPanic", func() {
            panic("failpoint triggerd")
        })
    }
    
  3. Usa una cache di build separata per evitare di mescolare le cache senza failpoint-toolexec, e compila

    GOCACHE=/tmp/failpoint-cache go build -toolexec path/to/failpoint-toolexec

  4. Abilita i failpoint con la variabile d'ambiente GO_FAILPOINTS

    GO_FAILPOINTS="main/testPanic=return(true)" ./your-program
    
  5. Puoi anche usare go run o go test, ad esempio:

    GOCACHE=/tmp/failpoint-cache GO_FAILPOINTS="main/testPanic=return(true)" go run -toolexec path/to/failpoint-toolexec your-program.go
    

Principi di progettazione

  • Definisci il failpoint in codice Golang valido, non in commenti o altro

  • Un failpoint non comporta alcun costo aggiuntivo

    • Non avrà effetto sulla logica normale
    • Non causerà regressioni di prestazioni nel codice normale
    • Il codice del failpoint non apparirà nel binario finale
  • La routine del failpoint è scrivibile/leggibile e deve essere controllata da un compilatore

  • Il codice generato dalla definizione del failpoint è facile da leggere

  • Mantieni gli stessi numeri di riga dei codici di iniezione (più facile da debuggare)

  • Supporto per test paralleli con context.Context

Concetti chiave

  • Failpoint

    Un failpoint è uno snippet di codice che viene eseguito solo quando il corrispondente failpoint è attivo. La closure non verrà mai eseguita se viene eseguito failpoint.Disable("failpoint-name-for-demo").

    var outerVar = "declare in outer scope"
    failpoint.Inject("failpoint-name-for-demo", func(val failpoint.Value) {
        fmt.Println("unit-test", val, outerVar)
    })
    
  • Funzioni marcatore

    • Sono solo funzioni vuote

      • Per suggerire al rewriter di riscrivere con un'istruzione di uguaglianza
      • Per ricevere alcuni parametri come regola di riscrittura
      • Saranno inline in fase di compilazione e non emetteranno nulla nel binario (costo zero)
      • Le variabili nello scope esterno possono essere accedute nella closure tramite cattura, e il codice convertito è comunque legale perché tutte le variabili catturate si trovano nello scope esterno dell'istruzione IF.
    • Sono facili da scrivere/leggere

    • Introducono un controllo del compilatore per i failpoint che non possono compilare in modalità normale se il codice del failpoint non è valido

  • Elenco delle funzioni marcatore

    • func Inject(fpname string, fpblock func(val Value)) {}
    • func InjectContext(fpname string, ctx context.Context, fpblock func(val Value)) {}
    • func InjectCall(fpname string, args ...any) {}
    • func Break(label ...string) {}
    • func Goto(label string) {}
    • func Continue(label ...string) {}
    • func Fallthrough() {}
    • func Return(results ...interface{}) {}
    • func Label(label string) {}
  • Variabili d'ambiente supportate per i failpoint

    Un failpoint può essere abilitato esportando variabili d'ambiente con il seguente pattern, molto simile a freebsd failpoint SYSCTL VARIABLES

    Nota: InjectCall non può essere abilitato tramite variabili d'ambiente.

    [<percent>%][<count>*]<type>[(args...)][-><more terms>]
    

    L'argomento specifica quale azione intraprendere; può essere uno dei seguenti:

    • off: Non eseguire alcuna azione (non attiva il codice del failpoint)
    • return: Attiva il failpoint con l'argomento specificato
    • sleep: Dormi per il numero specificato di millisecondi
    • panic: Panico
    • break: Esegui gdb e interrompi nel debugger
    • print: Stampa il percorso del failpoint per la variabile di iniezione
    • pause: Pausa sospende fino a quando il failpoint non viene disabilitato

Come iniettare un failpoint nel tuo programma

  • Puoi chiamare failpoint.Inject per iniettare un failpoint nel punto di chiamata, dove failpoint-name viene usato per attivare il failpoint e failpoint-closure verrà espansa come corpo dell'istruzione IF.

    failpoint.Inject("failpoint-name", func(val failpoint.Value) {
        failpoint.Return("unit-test", val)
    })
    

    Il codice convertito è simile a:

    if val, _err_ := failpoint.Eval(_curpkg_("failpoint-name")); _err_ == nil {
        return "unit-test", val
    }
    
  • failpoint.Value è il valore passato da failpoint.Enable("failpoint-name", "return(5)") che può essere ignorato.

    failpoint.Inject("failpoint-name", func(_ failpoint.Value) {
        fmt.Println("unit-test")
    })
    

    OPPURE

    failpoint.Inject("failpoint-name", func() {
        fmt.Println("unit-test")
    })
    

    E il codice convertito è simile a:

    if _, _err_ := failpoint.Eval(_curpkg_("failpoint-name")); _err_ == nil {
        fmt.Println("unit-test")
    }
    
  • Inoltre, la closure del failpoint può essere una funzione che accetta context.Context. Puoi fare cose personalizzate con context.Context, come controllare se un failpoint è attivo nei test paralleli o in altri casi. Per esempio,

    failpoint.InjectContext(ctx, "failpoint-name", func(val failpoint.Value) {
        fmt.Println("unit-test", val)
    })
    
Scarica lo strumento

Più Popolari

Vedi tutti →

Scopri gli strumenti più utilizzati dalla nostra community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 Il toolkit OSINT definitivo: grafo di indagine, punteggio di affidabilità, famiglie di alias, mappa, timeline e report. 49 moduli, oltre 400 siti, nessuna chiave API richiesta.

    732
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # App di esecuzione con un tocco GhostLock (CVE-2026-43499)

    506
  • 3

    ARTEX

    baarai/artex

    Piattaforma di penetration testing autonoma multi-agente basata su LLM con agenti planner/worker, grafi di asset e di esplorazione, registrazione del traffico MITM e retesting delle vulnerabilità.

    405
  • 4

    redforge

    cybersecurity91/redforge

    Toolkit red team lato browser con 102 strumenti offline per ricognizione, generazione di payload, attacchi alle credenziali, crittografia, codifica e reportistica dell'engagement.

    342
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    Il sistema d'azione per la cybersecurity nativa AI—dove l'intento diventa esecuzione governata, le evidenze diventano memoria operativa, e ogni operazione migliora la successiva.

    261
  • 6

    antifox

    antifox-ai/antifox

    Piattaforma multi-agente di penetration testing autonoma basata sull'IA che esegue ricognizione, scoperta della superficie d'attacco, validazione dello sfruttamento e consegna di report supportati da evidenze.

    259

Esplora tutti gli strumenti

Sfoglia la nostra collezione di strumenti

Vedi tutti gli strumenti →