X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=INSTALL;h=4c54b59d3de9b160e0b8e5377ea3c535adc89812;hb=b0fb94a346e52f36aeef238dd5f9bef9a10c14ef;hp=4749e30d4da11bacf46b6af5ce02659a44594d00;hpb=2be0b371712ddf1fc2aaac81672b2196b6df891f;p=sliver-openvswitch.git diff --git a/INSTALL b/INSTALL index 4749e30d4..4c54b59d3 100644 --- a/INSTALL +++ b/INSTALL @@ -18,8 +18,13 @@ you will need the following software: - GNU make. - - The GNU C compiler. We generally test with version 4.1, 4.2, or - 4.3. + - A C compiler, such as: + + * GCC 4.x. + + * Clang. Clang 3.4 and later provide useful static semantic + analysis and thread-safety checks. For Ubuntu, there are + nightly built packages available on clang's website. - libssl, from OpenSSL, is optional but recommended if you plan to connect the Open vSwitch to an OpenFlow controller. libssl is @@ -107,6 +112,10 @@ installing the following to obtain better warnings: - GNU make. + - clang, version 3.4 or later + +Also, you may find the ovs-dev script found in utilities/ovs-dev.py useful. + Installation Requirements ------------------------- @@ -171,6 +180,10 @@ Prerequisites section, follow the procedure below to build. % ./configure CC=gcc-4.2 + To use 'clang' compiler: + + % ./configure CC=clang + To build the Linux kernel module, so that you can run the kernel-based switch, pass the location of the kernel build directory on --with-linux. For example, to build for a running @@ -209,15 +222,15 @@ Prerequisites section, follow the procedure below to build. 6. Run "make install" to install the executables and manpages into the running system, by default under /usr/local. -7. If you built kernel modules, you may load them with "insmod", e.g.: +7. If you built kernel modules, you may install and load them, e.g.: - % insmod datapath/linux/openvswitch.ko + % make modules_install + % /sbin/modprobe openvswitch - You may need to specify a full path to insmod, e.g. /sbin/insmod. To verify that the modules have been loaded, run "/sbin/lsmod" and check that openvswitch is listed. - If the "insmod" operation fails, look at the last few kernel log + If the "modprobe" operation fails, look at the last few kernel log messages (e.g. with "dmesg | tail"): - The message "openvswitch: exports duplicate symbol @@ -264,11 +277,6 @@ Prerequisites section, follow the procedure below to build. you do not understand what this means or do not know if your driver will work, do not set this. - Once you verify that the kernel modules load properly, you should - install them: - - % make modules_install - 8. Initialize the configuration database using ovsdb-tool, e.g.: % mkdir -p /usr/local/etc/openvswitch