| 1 | CIVL: The Concurrency Intermediate Verification Language
|
|---|
| 2 | v 0.8
|
|---|
| 3 |
|
|---|
| 4 | ------------------------------ Overview -------------------------------
|
|---|
| 5 |
|
|---|
| 6 | CIVL is a framework encompassing...
|
|---|
| 7 |
|
|---|
| 8 | * a programming language, CIVL-C, which adds to C a number of
|
|---|
| 9 | concurrency primitives, as well as the ability to define
|
|---|
| 10 | functions in any scope. Together, these features make for
|
|---|
| 11 | a very expressive concurrent language that can faithfully
|
|---|
| 12 | represent programs using various APIs and parallel languages,
|
|---|
| 13 | such as MPI, OpenMP, CUDA, and Chapel. CIVL-C also provides
|
|---|
| 14 | a number of primitives supporting verification.
|
|---|
| 15 | * a model checker which uses symbolic execution to verify a
|
|---|
| 16 | number of safety properties of CIVL-C programs. The model
|
|---|
| 17 | checker can also be used to verify that two CIVL-C programs
|
|---|
| 18 | are functionally equivalent.
|
|---|
| 19 | * a number of translators from various commonly-used languages
|
|---|
| 20 | and APIs to CIVL-C. (This part is still a work in progress.)
|
|---|
| 21 |
|
|---|
| 22 | CIVL is developed by the Verified Software Laboratory at the
|
|---|
| 23 | University of Delaware Department of Computer Science.
|
|---|
| 24 | For more information, visit http://vsl.cis.udel.edu/civl
|
|---|
| 25 |
|
|---|
| 26 | Developers:
|
|---|
| 27 |
|
|---|
| 28 | Stephen F. Siegel
|
|---|
| 29 | Timothy K. Zirkel
|
|---|
| 30 | Manchun Zheng
|
|---|
| 31 | Ziqing Luo
|
|---|
| 32 |
|
|---|
| 33 | ------------------------------- License -------------------------------
|
|---|
| 34 |
|
|---|
| 35 | CIVL is open source software distributed under the GNU
|
|---|
| 36 | General Public License. However, the libraries used by CIVL
|
|---|
| 37 | (and incorporated into the complete distribution) use various
|
|---|
| 38 | licenses. See directory licenses for the license of each component.
|
|---|
| 39 |
|
|---|
| 40 | -------------------------- Updates from v 0.7 -------------------------
|
|---|
| 41 |
|
|---|
| 42 | 1. Dyscopes are now first-class objects, like processes and other types.
|
|---|
| 43 | Refer to CIVL Manual Section 6.2.2 for more details about $scope expressions.
|
|---|
| 44 |
|
|---|
| 45 | 2. Interfaces for message passing are significantly simplified. Refer to
|
|---|
| 46 | CIVL Manual Section 7.3.2 and examples/messagePassing for more details.
|
|---|
| 47 |
|
|---|
| 48 | 3. $wait is not implemented as a system function declared in civlc.h,
|
|---|
| 49 | instead of a language primitive. So the syntax becomes "$wait(p)"
|
|---|
| 50 | instead of "$wait p".
|
|---|
| 51 |
|
|---|
| 52 | 4. There is no longer a $heap type. Instead, every dynamic scope has its
|
|---|
| 53 | own heap automatically. The $malloc function has been modified to take
|
|---|
| 54 | a scope as its first argument, e.g., $malloc($here, sizeof(int)).
|
|---|
| 55 |
|
|---|
| 56 | ------------------------- Binary Installation -------------------------
|
|---|
| 57 |
|
|---|
| 58 | For most users, this will be the easiest way to install and use CIVL.
|
|---|
| 59 |
|
|---|
| 60 | 1. Install a Java 7 SDK if you have not already. Go to
|
|---|
| 61 | http://www.oracle.com/technetwork/java/javase/downloads/ for the
|
|---|
| 62 | latest from Oracle. On linux, you can optionally sudo apt-get install
|
|---|
| 63 | openjdk-7-jdk.
|
|---|
| 64 |
|
|---|
| 65 | 2. If you already have the VSL dependencies library, you may
|
|---|
| 66 | skip this step. Otherwise, download the archive of VSL
|
|---|
| 67 | dependencies from http://vsl.cis.udel.edu/tools/vsl_depend,
|
|---|
| 68 | choosing the version for your OS type (32-bit linux,
|
|---|
| 69 | 64-bit linux, or 64-bit OS X). Unzip and untar the
|
|---|
| 70 | downloaded .tgz file and you will have a folder named "vsl".
|
|---|
| 71 | If you do not already have a directory /opt, create one with
|
|---|
| 72 | "mkdir /opt". Move vsl into /opt. Use sudo as needed.
|
|---|
| 73 |
|
|---|
| 74 | 3. Download the CIVL distribution from http://vsl.cis.udel.edu/civl.
|
|---|
| 75 |
|
|---|
| 76 | 4. Unzip and untar the downloaded file if this does not happen
|
|---|
| 77 | automatically. This should result in a folder named
|
|---|
| 78 | CIVL-TAG, where TAG is some version id string. This folder
|
|---|
| 79 | contains the following:
|
|---|
| 80 |
|
|---|
| 81 | - README : this file
|
|---|
| 82 | - bin : containing one executable sh script called "civl"
|
|---|
| 83 | - lib : containing civl-TAG.jar
|
|---|
| 84 | - doc : containing the manual and the tutorial of CIVL
|
|---|
| 85 | - licenses : licenses for CIVL and included libraries
|
|---|
| 86 | - examples : some example CIVL programs
|
|---|
| 87 |
|
|---|
| 88 | 5. Move CIVL-TAG into /opt.
|
|---|
| 89 |
|
|---|
| 90 | 6. Put the civl script in your path however you like to put things
|
|---|
| 91 | in your path. Either move it to a directory in your path,
|
|---|
| 92 | or create a symlink to it, or edit your .profile or equivalent
|
|---|
| 93 | to put it in your path.
|
|---|
| 94 |
|
|---|
| 95 | ------------------------- Source Installation -------------------------
|
|---|
| 96 |
|
|---|
| 97 | We recommend using the Eclipse IDE for Java/EE developers.
|
|---|
| 98 |
|
|---|
| 99 | 1. Install an SVN plugin in Eclipse (such as Subversive) if you have
|
|---|
| 100 | not already.
|
|---|
| 101 |
|
|---|
| 102 | 2. Install prerequisite projects ABC, SARL and GMC.
|
|---|
| 103 | Make sure that the three projects are put in the workspace
|
|---|
| 104 | directory where CIVL will be put.
|
|---|
| 105 |
|
|---|
| 106 | a. Install the C front-end ABC. In Eclipse,
|
|---|
| 107 | select New Project...from SVN, use the archive
|
|---|
| 108 | svn://vsl.cis.udel.edu/abc. After entering that, open it
|
|---|
| 109 | up and select the "trunk". After checking out trunk, name
|
|---|
| 110 | the project "ABC". Then follow the instructions in the INSTALL
|
|---|
| 111 | file for Eclipse installation. Build the abc.jar from within
|
|---|
| 112 | Eclipse by right-clicking (or ctrl-clicking on OS X) on the
|
|---|
| 113 | build.xml file and selecting Run As->Ant Build.
|
|---|
| 114 |
|
|---|
| 115 | b. Install the symbolic algebra and reasoning library SARL.
|
|---|
| 116 | In Eclipse, select New Project...from SVN, use the archive
|
|---|
| 117 | svn://vsl.cis.udel.edu/sarl. After entering that, open it
|
|---|
| 118 | up and select the "trunk". After checking out trunk, name
|
|---|
| 119 | the project "SARL". Then follow the instructions in the INSTALL
|
|---|
| 120 | file for Eclipse installation. Build the sarl.jar from within
|
|---|
| 121 | Eclipse by right-clicking (or ctrl-clicking) on the build.xml
|
|---|
| 122 | file and selecting Run As->Ant Build.
|
|---|
| 123 |
|
|---|
| 124 | c. Install the generic model checking utilities package GMC.
|
|---|
| 125 | In Eclipse, select New Project...from SVN, use the archive
|
|---|
| 126 | svn://vsl.cis.udel.edu/gmc. After entering that, open it
|
|---|
| 127 | up and select the "trunk". After checking out trunk, name
|
|---|
| 128 | the project "GMC". Build the gmc.jar from within Eclipse
|
|---|
| 129 | by right-clicking (or ctrl-clicking) on the build.xml file and
|
|---|
| 130 | selecting Run As->Ant Build.
|
|---|
| 131 |
|
|---|
| 132 | 3. From within Eclipse, select New Project...from SVN. The archive is
|
|---|
| 133 | svn://vsl.cis.udel.edu/civl. After entering that, open it up and
|
|---|
| 134 | select the "trunk". (It is simplest to just check out the trunk for
|
|---|
| 135 | the Eclipse project.)
|
|---|
| 136 |
|
|---|
| 137 | 4. Check out the trunk, and create the project using the New Java
|
|---|
| 138 | Project Wizard as usual, naming it "CIVL". The .project, .classpath,
|
|---|
| 139 | and other Eclipse meta-data are already in the SVN archive, saving you
|
|---|
| 140 | a bunch of work.
|
|---|
| 141 |
|
|---|
| 142 | 5. If you already have the VSL dependencies library, you may
|
|---|
| 143 | skip this step. Download the tgz archive of VSL dependencies from
|
|---|
| 144 | http://vsl.cis.udel.edu/tools/vsl_depend, choosing the right .tgz
|
|---|
| 145 | according to your platform:
|
|---|
| 146 |
|
|---|
| 147 | vsl_linux32-1.0.tgz - 32-bit linux
|
|---|
| 148 | vsl_linux64-1.0.tgz - 64-bit linux
|
|---|
| 149 | vsl_osx64-1.0.tgz - 64-bit osx
|
|---|
| 150 |
|
|---|
| 151 | Unzip the .tgz file and you will have the folder vsl.
|
|---|
| 152 | Move vsl to /opt (you might need to use sudo for this.
|
|---|
| 153 | Also, if you don't already have a directory called /opt,
|
|---|
| 154 | you will have to create it with mkdir /opt).
|
|---|
| 155 |
|
|---|
| 156 | Suppose that you put the .tgz file (or .tar file if your browser
|
|---|
| 157 | unzipped it automatically to a .tar file) in the directory $Download.
|
|---|
| 158 | You can use the following commands:
|
|---|
| 159 |
|
|---|
| 160 | $ cd $Download
|
|---|
| 161 | $ tar xzf YourTgzOrTarFile vsl
|
|---|
| 162 | $ sudo mv vsl /opt
|
|---|
| 163 |
|
|---|
| 164 | Now you can type "ls /opt/vsl", and the output should be
|
|---|
| 165 |
|
|---|
| 166 | README.txt lib licenses src
|
|---|
| 167 |
|
|---|
| 168 | 6. If default_build.properties matches the configuration of your system,
|
|---|
| 169 | then you can skip this step. Otherwise, you may need to create a file
|
|---|
| 170 | build.properties in the directory where build.xml is in.
|
|---|
| 171 | Copy and paste the content from any file under properties, edit each
|
|---|
| 172 | entry with the path configured in your system. The newly created file
|
|---|
| 173 | build.properties will automatically be used by ant to to build the .jar file.
|
|---|
| 174 |
|
|---|
| 175 | 7. Navigate to Preferences -> Java -> Build Path -> ClassPath
|
|---|
| 176 | Variables, and then select New to create a classpath variable VSL,
|
|---|
| 177 | and specify its value to be /opt/vsl. Navigate to Preferences -> Run/Debug
|
|---|
| 178 | -> String Substitution -> New, and then define an entry vsl_lib and
|
|---|
| 179 | set its value to be /opt/vsl/lib.
|
|---|
| 180 |
|
|---|
| 181 | 8. Do a clean build. Everything should compile. Generate the civl.jar
|
|---|
| 182 | by right-clicking (or ctrl-click on OS X) the build.xml file and
|
|---|
| 183 | Run As->Ant Build.
|
|---|
| 184 |
|
|---|
| 185 | 9. Go to Run->Run Configurations... Create a new JUnit configuration.
|
|---|
| 186 | Name it CIVL Tests. Select "Run all tests in the selected project..."
|
|---|
| 187 | and navigate to the folder "test" in the CIVL project.
|
|---|
| 188 | The Test runner should be JUnit 4. Under the Arguments tab, type
|
|---|
| 189 | "-ea" (without the quotes) in the VM arguments area (to enable assertion
|
|---|
| 190 | checking). Under the Environment tab, create an entry
|
|---|
| 191 | DYLD_LIBRARY_PATH (OS X) or LD_LIBRARY_PATH (linux),
|
|---|
| 192 | specify its value by clicking Variables and choose vsl_lib from the list,
|
|---|
| 193 | or you may type ${vsl_lib} in the value entry.
|
|---|
| 194 |
|
|---|
| 195 | 10. An example of how to set up a single test from within Eclipse:
|
|---|
| 196 | create a new Run Configuration via the Run->Run
|
|---|
| 197 | Configurations... menu. Create a new "Java Application"
|
|---|
| 198 | configuration. Call it "CIVL barrier2". The Project is CIVL. The
|
|---|
| 199 | main class is edu.udel.cis.vsl.civl.CIVL. Under the Arguments tab,
|
|---|
| 200 | set the Program arguments to "examples/barrier2.cvl" (without the
|
|---|
| 201 | quotes). Modify the VM arguments and the Environment as in the step
|
|---|
| 202 | above. You should now be able to run the test by clicking "Run".
|
|---|
