frama-c-gui - Online nel cloud

PROGRAMMA:

NOME

frama-c[.byte] - un analizzatore statico per programmi C

frama-c-gui[.byte] - l'interfaccia grafica di frama-c

SINOSSI

cornice-c [ Opzioni ] file

DESCRIZIONE

cornice-c è una suite di strumenti dedicati all'analisi del codice sorgente scritto in C. It
riunisce diverse tecniche di analisi statica in un unico framework collaborativo. Questo
framework può essere esteso da plugin aggiuntivi collocati nel $PLUGIN_FRAMAC directory.
Il comando

frama-c - aiuto

fornirà l'elenco completo dei plugin attualmente installati.

frama-c-gui è l'interfaccia utente grafica di cornice-c. Presenta le stesse opzioni di
la versione da riga di comando.

frame-c.byte ed frama-c-gui.byte sono le versioni bytecode ocaml della riga di comando e
interfaccia utente grafica rispettivamente.

Per impostazione predefinita, Frama-C riconosce .c file come file C che necessitano di pre-elaborazione e .i file come
I file C sono già stati pre-elaborati. Alcuni plugin possono estendere l'elenco dei riconosciuti
File. La pre-elaborazione può essere personalizzata attraverso il -cpp-comando ed -cpp-extra-args
opzioni.

VERSIONI

Sintassi

Le opzioni che prendono un parametro aggiuntivo possono anche essere scritte sotto il modulo

-opzione=param

Questa opzione è obbligatoria quando param inizia con un trattino ('-')

La maggior parte delle opzioni che non accettano parametri hanno un corrispondente

-al-Opzione

opzione che ha l'effetto opposto.

Aiuto Opzioni

-Aiuto fornisce un breve avviso di utilizzo e l'elenco dei plug-in installati.

-aiuto-kernel
stampa l'elenco delle opzioni riconosciute dal kernel di Frama-C

-verboso n
Imposta il livello di verbosità (l'impostazione predefinita è 1). Impostandolo su 0 produrrà meno progressi
messaggi. Questo livello può essere impostato anche su un per plug-in base, con opzione -plug-in-
verboso n. Il livello di verbosità del kernel può essere controllato con l'opzione
-kernel-verboso n.

-debug n
Imposta il livello di debug (il valore predefinito è 0, che significa nessun messaggio di debug). Questa opzione
ha le stesse specializzazioni per plugin (e kernel) di -verboso.

-silenzioso Imposta il livello di verbosità e debug su 0.

Opzioni controllo Frama-C Kernel

-intervallo-valido-assoluto
considera che tutti gli indirizzi numerici nell'intervallo minimo Massimo sono validi. I limiti sono
analizzati come costanti intere ocaml. Per impostazione predefinita, tutti gli indirizzi numerici sono
considerato invalido.

-aggiungi-percorso p1[,p2[...,pn]]
aggiunge directory attraverso all'elenco delle directory in cui si trovano i plugin
cercato

[-no]-consenti-duplicazione
consente la duplicazione di piccoli blocchi durante la normalizzazione di test e loop.
In caso contrario, la normalizzazione utilizza etichette e goto. Blocchi più grandi e blocchi con non
il flusso di controllo banale non viene mai duplicato. L'impostazione predefinita è sì.

[-no]-anno
legge l'annotazione ACSL. Questa è l'impostazione predefinita. Le annotazioni non sono pre-elaborate da
predefinito. Utilizzo -pp-annot per quello.

-big-ints-esadecimale max
numeri interi maggiori di max sono visualizzati in esadecimale (per impostazione predefinita, tutti i numeri interi sono
visualizzato in decimale)

-dai un'occhiata esegue controlli di integrità sull'AST interno (solo per sviluppatori).

[-no]-collapse-call-cast
consente il cast implicito tra il valore restituito da una funzione e il lvalue che è
assegnato a. In caso contrario, viene utilizzata una variabile temporanea e il cast viene reso esplicito.
L'impostazione predefinita è sì.

[-no]-constfold
piega tutte le espressioni sintatticamente costanti nel codice prima delle analisi. Predefiniti
al n.

[-no]-continua-annot-error
Quando si analizza un'annotazione, il comportamento predefinito (il -al versione di questa opzione)
quando si verifica un errore di controllo del tipo è rifiutare il file sorgente come nel caso
errori di controllo del tipo all'interno del codice C. Con questa opzione attiva, il correttore di tipo lo farà
emette solo un avviso e scarta l'annotazione ma il controllo del tipo continuerà
(gli errori nel codice C sono comunque fatali).

-cpp-comando cmd
si utilizza cmd come comando per pre-elaborare i file C. Il valore predefinito è CPP ambiente
variabile o a

gcc -C -E -I.

se non è impostato. Per preservare le annotazioni ACSL, il preprocessore deve mantenere
commenti (il -C opzione per gcc). %1 ed %2 può essere utilizzato in cmd per denotare il
rispettivamente il file sorgente originale e il file pre-elaborato

-cpp-extra-args args
Fornisce argomenti aggiuntivi al preprocessore. Questo è utile solo quando
-preprocesso-annot è impostato. La pre-elaborazione delle annotazioni viene eseguita in due distinte pre-
fasi di lavorazione. Il primo è un normale passaggio al codice C che mantiene la macro
definizioni. Questi vengono poi utilizzati nel secondo passaggio durante il quale le annotazioni sono
pre-elaborato. args vengono utilizzati solo per il primo passaggio, in modo che gli argomenti che
non dovrebbe essere usato due volte (come direttive di inclusione aggiuntive o macro
definizioni) deve quindi andare lì invece di -cpp-comando.

[-no]-dinlink
Quando è attivo, carica tutti i plug-in dinamici trovati nel percorso di ricerca (vedi -plug-in-stampa-
sentiero per ulteriori informazioni sul percorso di ricerca predefinito). Altrimenti, solo plugin
richiesto da -moduli-di-carica verrà caricato. Il comportamento predefinito è attivo.

-enum riproporre
Scegliere il modo in cui viene determinata la rappresentazione dei tipi enumerati. cornice-c
-enum Aiuto fornisce l'elenco delle opzioni disponibili. L'impostazione predefinita è gcc-enum

-cifre-float n
Quando si emettono numeri in virgola mobile, display n cifre. Il valore predefinito è 12.

-flottante a zero
Operazioni in virgola mobile a zero

-float-esadecimale
display float come esadecimale

-float-normale
display galleggia con la routine Ocaml standard

-float-relativo
visualizza l'intervallo float come [ limite inferiore++larghezza ]

[-no]-force-rl-arg-eval
forza l'ordine di valutazione da destra a sinistra per gli argomenti delle chiamate di funzione. Altrimenti
l'ordine di valutazione non viene specificato, come nello standard C. Il valore predefinito è n.

-journal-disabilita
Non emettere un diario della sessione corrente. Vedere -abilitazione-giornale.

-abilitazione-giornale
Attivato per impostazione predefinita, esegue il dump di un diario di tutte le azioni eseguite durante l'attuale
Sessione Frama-C sotto forma di uno script ocaml che può essere riprodotto con -caricare-
copione. Il nome dello script può essere impostato con il tasto -nome-rivista opzione.

-nome-rivista Nome
Imposta il nome del file journal (senza il .ML estensione). Il valore predefinito è
frama_c_journal.

-inizializzato-padding-locals
L'inizializzazione implicita dei locali imposta i bit di riempimento a 0. Se falso, i bit di riempimento
vengono lasciati non inizializzati (impostazione predefinita su yes).

[-no]-mantieni-commenti
Tenta di preservare i commenti durante la stampa graziosa del codice sorgente (il valore predefinito è no).

[-no]-mantieni-interruttore
Quando -semplificare-cfg è impostato, mantiene le istruzioni switch. Il valore predefinito è n.

-mantieni-funzioni-specificate-inutilizzate
See -rimuovere-funzioni-specificate-inutilizzate

[-no]-lib-voce
Indica che il punto di ingresso viene chiamato durante l'esecuzione del programma. Ciò implica in
particolare che non si può presumere che le variabili globali abbiano i loro valori iniziali.
L'impostazione predefinita è -no-lib-voce: il punto di ingresso è anche il punto di partenza del
program e globals hanno il loro valore iniziale.

-caricare filetto
caricare lo stato (precedentemente salvato) contenuto in filetto.

-modulo di carico m1[,m2[...,mn]]
carica i moduli ocaml attraverso . Questi moduli devono essere .cmxsfile per il
versione in codice nativo di Frama-c e .cmor.cmafile per la versione bytecode (vedi
la sezione Dynlink del manuale Ocaml per maggiori informazioni). Tutti i moduli che sono
presenti nel plugin i percorsi di ricerca vengono caricati automaticamente.

-carica-script s1[,s2,[...,sn]]
carica gli script ocaml attraverso . Gli script devono essere .MLFile. Essi
deve essere compilabile basandosi solo sulla libreria standard Ocaml e sull'API di Frama-C. Se
sono necessari alcuni passaggi di compilazione personalizzati, compilali al di fuori di Frama-C e usa
-modulo di carico anziché.

-dip.mac macchina
usa macchina come l'attuale configurazione dipendente dalla macchina (dimensioni delle varie
tipi interi, endandness, ...). L'elenco delle macchine attualmente supportate è
disponibile attraverso -dip.mac Aiuto opzione. L'impostazione predefinita è x86_32

-principale f
Set f come punto di ingresso dell'analisi. Il valore predefinito è "principale". Per impostazione predefinita, è
considerato il punto di partenza del programma in analisi. Utilizzo -lib-voce if f
dovrebbe essere chiamato nel bel mezzo di un'esecuzione.

-offuscare
stampa una versione offuscata del codice (dove gli identificatori originali sono sostituiti
da uno insignificante) ed esce. La tabella di corrispondenza tra originale e nuovo
i simboli vengono mantenuti all'inizio del risultato.

-ocodice filetto
reindirizza il codice stampato a filetto invece dell'output standard.

[-no]-nome-origine
Durante la fase di normalizzazione, alcune variabili potrebbero essere rinominate quando diverse
variabile con lo stesso nome può coesistere (es. una variabile globale e una variabile formale
parametro). Quando questa opzione è attiva, viene stampato un messaggio ogni volta che ciò si verifica.
Il valore predefinito è n.

[-no]-avvisa-firmato-abbattuto
genera allarmi quando i downcast firmati possono superare l'intervallo di destinazione (impostazione predefinita su
non).

[-no]-overflow-segnalato-avviso
generare allarmi per le operazioni firmate che traboccano (impostazione predefinita su sì).

[-no]-avvisa-unsigned-downcast
genera allarmi quando i downcast senza segno possono superare l'intervallo di destinazione (impostazione predefinita
a no).

[-no]-avviso-overflow-senza segno
generare allarmi per operazioni non firmate che traboccano (impostazione predefinita su no).

[-no]-pp-annot
annotazioni pre-processo. Questoèattualmente possibile solo quando usi gcc (o GNU
cpp) preprocessore. L'impostazione predefinita è non pre-elaborare le annotazioni.

[-no]-stampa
pretty-stampa il codice sorgente come normalizzato da CIL (il valore predefinito è no).

-print-libpath
restituisce la directory in cui è installata la libreria del kernel Frama-C

-percorso-stampa
alias di -percorso di condivisione di stampa

-print-plugin-percorso
emette la directory in cui Frama-C cerca i suoi plugin (puòessere sovrascritta da
FRAMAC_PLUGIN variabile e il -aggiungi-percorso opzione)

-percorso di condivisione di stampa
emette la directory in cui Frama-C memorizza i suoi dati (può essere sovrascritta da
FRARAC_CONDIVIDI variabile)

-rimuovere-funzioni-specificate-inutilizzate
mantiene i prototipi di funzione che hanno una specifica ACSL ma non sono utilizzati nel
codice. Questa è l'impostazione predefinita. Funzioni aventi l'attributo FRAMAC_BUILTIN siano sempre
tenuto.

-array-sicuro
Per array multidimensionali o array che sono campi all'interno di structs , presuppone che
tutti gli accessi devono essere vincolati (impostati di default). L'opzione opposta è -non sicuro-
array

-Salva filetto
Salva lo stato di Frama-C in filetto dopo che sono state effettuate le analisi.

[-no]-semplificare-cfg
rimuove l'istruzione break, continue e switch prima delle analisi. Il valore predefinito è n.

-poi permette di comporre analisi: una prima esecuzione di Frama-C avverrà con le opzioni
prima -poi e verrà eseguita una seconda esecuzione con le opzioni dopo -poi sul
progetto attuale dalla prima esecuzione.

-poi-on prj
Simile a -poi tranne che la seconda esecuzione viene eseguita in project prj Se non è così
progetto esiste, Frama-C esce con un errore.

-tempo filetto
aggiunge l'ora e la data dell'utente nel dato filetto quando Frama-C esce.

-tipo di controllo
forza il controllo del tipo dei file di origine. Questa opzione è rilevante solo se non oltre
è richiesta l'analisi (poiché il controllo del tipo si verificherà implicitamente prima dell'analisi
viene lanciato).

-ulivello n
srotola sintatticamente i loop n volte prima dell'analisi. Questo può essere piuttosto costoso
e alcuni plugin (ad esempio l'analisi del valore) forniscono modi più efficienti per eseguire
la stessa cosa. Consultare i rispettivi manuali per ulteriori informazioni. Questo può anche
essere attivato in base al ciclo tramite il loop pragma srotolare direttiva. UN
valore negativo per n inibirà tali pragma.

[-no]-unicode
emette formule ACSL con caratteri utf8. Questa è l'impostazione predefinita. Quando viene dato il
-no-unicode opzione, Frama-C utilizzerà invece la versione ASCII. Consulta il manuale ACSL
per la corrispondenza.

-array-non sicuri
vedere -array-sicuro

[-no]-accesso-non specificato
verifica che gli accessi in lettura/scrittura avvengano in ordine imprecisato (secondo il C
nozione standard di punto di sequenza) vengono eseguiti in posizioni separate. Insieme a
-nessun-accesso-non specificato, presuppone che sia sempre così (questa è l'impostazione predefinita).

-versione
restituisce la stringa della versione di Frama-C

-warn-decimal-float
avverte quando una costante in virgola mobile non può essere rappresentata esattamente (es. 0.1).
può essere uno di nessuna, una volta, o contro tutti i

[-no]-avviso-chiamato-non-dichiarato
avverte quando una funzione viene chiamata prima che sia stata dichiarata (impostata per impostazione predefinita).
Frama-Do

plugin specifico Opzioni

Per ciascun plug-in, il comando

frame-c -plug-in-Aiuto

fornirà l'elenco delle opzioni specifiche per il plugin.

EXIT STATUS

0 Esecuzione riuscita

1 Input utente non valido

2 Interruzione dell'utente (kill o equivalente)

3 Funzionalità non implementata

4 5 6 Errore interno

125 Errore sconosciuto

Lo stato di uscita maggiore di 2 può essere considerato un bug (o una richiesta di funzionalità per il caso
dello stato di uscita 3) e possono essere riportati sui BTS di Frama-C (vedi sotto).

AMBIENTE VARIABILI

È possibile controllare i luoghi in cui Frama-C cerca i suoi file tramite il
seguenti variabili.

FRAMAC_LIB
La directory in cui sono installate le interfacce compilate del kernel

FRAMAC_PLUGIN
La directory in cui Frama-C può trovare i plug-in standard. Se desideri avere plugin
in più punti, usa -aggiungi-percorso anziché.

FRARAC_CONDIVIDI
La directory in cui sono installati i dati Frama-C.

Usa frama-c-gui online usando i servizi onworks.net