Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
F
frama-c
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Deploy
Releases
Container Registry
Model registry
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
pub
frama-c
Commits
f78090a5
Commit
f78090a5
authored
4 years ago
by
David Bühler
Browse files
Options
Downloads
Patches
Plain Diff
[Dive] Rewrites the README file, removes outdated compilation instructions.
parent
0b5924d9
No related branches found
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
src/plugins/dive/README.md
+6
-96
6 additions, 96 deletions
src/plugins/dive/README.md
with
6 additions
and
96 deletions
src/plugins/dive/README.md
+
6
−
96
View file @
f78090a5
Dive is a Frama-C plugin
,
specialized in
to
the visualization of data
Dive is a Frama-C plugin specialized in the visualization of data
dependencies.
dependencies. The main goal of this visualization is to help the user to find
It is intended to help the user find the origin of an imprecision in an Eva
the origin of an imprecision of an Eva
analysis.
analysis.
Some jargon
Dependencies
===========
===========
=
The front-end of Dive relies on several external tools and libraries :
The front-end of Dive relies on several external tools and libraries :
...
@@ -12,96 +12,6 @@ The front-end of Dive relies on several external tools and libraries :
...
@@ -12,96 +12,6 @@ The front-end of Dive relies on several external tools and libraries :
browser
browser
-
yarn: a package manager for javascript modules written for Node.js
-
yarn: a package manager for javascript modules written for Node.js
-
electron: a javascript framework for gui applications
-
electron: a javascript framework for gui applications
-
Ivette: the future Frama-C
and other tools
GUI
-
Ivette: the future Frama-C GUI
-
Cytoscape: a javascript library to display graphs and interact with them
-
Cytoscape: a javascript library to display graphs and interact with them
-
Zmq: a multilanguage framework for common simple networking patterns
-
Zmq: a multilanguage framework for common simple networking patterns
Compilation
===========
Dependencies
------------
-
Zmq must be installed with opam (with its system dependencies) for the
`-server-zmq`
option to be available.
Instructions
------------
The Frama-C plugin can be cloned into the Frama-C plugin source directory.
```
bash
cd
framac/src/plugins
git clone git@git.frama-c.com:frama-c/dive.git
```
The front-end is, for now, completely independent. One must start by cloning
Dome-electron, on the branch
`feature/cytoscape`
. Dome-electron provides a
framework to develop and test Ivette visual components.
```
bash
git clone git@git.frama-c.com:dome/electron.git
--branch
feature/cytoscape
```
In the electron directory, install a few javascript libraries needed by Dive.
```
bash
cd
electron
yarn add
--dev
@fortawesome/fontawesome-free cytoscape-cxtmenu cytoscape
\
cytoscape-popper tippy.js cytoscape-dagre cytoscape-cola
\
cytoscape-cose-bilkent cytoscape-klay
```
You can then run the framework for the first time by using the
`dev`
target
of the
`Makefile`
.
```
bash
make dev
```
At the end of the (long) process, it should open a window with an Hello-World
application. We will now replace this application with Dive. You can leave the
electron application running. Inside the
`src/renderer`
directory, clone the
front-end component of Dive.
```
bash
cd
src/renderer
git clone git@git.frama-c.com:perrelle/dive-electron.git
```
Finally, edit the contents of
`src/renderer/App.js`
and replace it by
```
javascript
import
dive
from
'
./dive-electron/main.js
'
;
export
default
dive
;
```
The application in the window should automatically update after a while.
Usage
=====
Once compiled, the Dome front-end component will always be displayed when
typing
```
bash
make dev
```
and will try to connect to a Frama-C server on
`tcp://127.0.0.1:9000`
.
Frama-C can be lauched before or after, either directly
```
bash
frama-c source.c
-server-zmq
tcp://127.0.0.1:9000
```
or, if the analysis results have been previously recorded
```
bash
frama-c
-load
results.sav
-server-zmq
tcp://127.0.0.1:9000
```
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment