Common Open Research Emulator
Find a file
Igal 86523c75d7 removed cflag -Werror
This solves #128

gcc7 has a compatibility problem with python and issues a warning as described at https://bugzilla.redhat.com/show_bug.cgi?id=1473425  

Setting the `-Werror` flag treats all warnings as errors, which fails the build.  IMHO it is better to remove the flag from regular builds.  Advanced users can add it if they choose to.
2017-08-19 10:26:10 -07:00
daemon globally replace mailing list URLs and dev email 2017-06-30 09:07:16 -07:00
doc globally replace mailing list URLs and dev email 2017-06-30 09:07:16 -07:00
gui globally replace mailing list URLs and dev email 2017-06-30 09:07:16 -07:00
kernel kernel: Avoid using the gawk-specific gensub function. 2015-04-03 01:44:00 +00:00
packaging globally replace mailing list URLs and dev email 2017-06-30 09:07:16 -07:00
scripts systemd: remove limit on fork() branching factor 2017-01-12 14:14:41 -05:00
.gitignore packaging: Add a makefile to directly build RPM packages. 2016-09-06 11:36:32 -04:00
bootstrap.sh initial import (Boeing r1752, NRL r878) 2013-08-29 14:21:13 +00:00
Changelog Declare version 4.8. 2015-06-05 22:02:08 +00:00
configure.ac removed cflag -Werror 2017-08-19 10:26:10 -07:00
LICENSE initial import (Boeing r1752, NRL r878) 2013-08-29 14:21:13 +00:00
Makefile.am deb: Move post-remove cleanup to the pre-remove script. 2016-01-29 13:39:34 -05:00
python-prefix.py Fix typo in previous commit. 2015-02-19 18:18:33 +00:00
README-Xen initial import (Boeing r1752, NRL r878) 2013-08-29 14:21:13 +00:00
README.rst broke commands to separate lines 2017-08-07 22:56:30 -04:00
revision.sh build: Include revision information in distributions. 2016-01-26 17:01:23 -05:00

====
CORE
====

CORE: Common Open Research Emulator

Copyright (c)2005-2013 the Boeing Company.

See the LICENSE file included in this distribution.

About
=====

CORE is a tool for emulating networks using a GUI or Python scripts. The CORE
project site (1) is a good source of introductory information, with a manual,
screenshots, and demos about this software. The GitHub project (2) hosts the
source repos, wiki, and bug tracker. There is a deprecated
Google Code page (3) with the old wiki, blog, bug tracker, and quickstart guide.

1. http://www.nrl.navy.mil/itd/ncs/products/core

2. https://github.com/coreemu/core

3. http://code.google.com/p/coreemu/

4. `Official Documentation`_

.. _Official Documentation: https://downloads.pf.itd.nrl.navy.mil/docs/core/core-html/index.html


Building CORE
=============

To build this software you should use:

    ./bootstrap.sh

    ./configure
    
    make
    
    sudo make install

Here is what is installed with 'make install':

    /usr/local/bin/core-gui
    /usr/local/sbin/core-daemon
    /usr/local/sbin/[vcmd, vnoded, coresendmsg, core-cleanup.sh]
    /usr/local/lib/core/*
    /usr/local/share/core/*
    /usr/local/lib/python2.6/dist-packages/core/*
    /usr/local/lib/python2.6/dist-packages/[netns,vcmd].so
    /etc/core/*
    /etc/init.d/core

See the manual for the software required for building CORE.


Running CORE
============

First start the CORE services:

    sudo /etc/init.d/core-daemon start

This automatically runs the core-daemon program. 
Assuming the GUI is in your PATH, run the CORE GUI by typing the following:

    core-gui

This launches the CORE GUI. You do not need to run the GUI as root.


Support
=======

If you have questions, comments, or trouble, please use the CORE mailing lists:

- `core-users`_ for general comments and questions

- `core-dev`_ for bugs, compile errors, and other development issues


.. _core-users: https://publists.nrl.navy.mil/mailman/listinfo/core-users
.. _core-dev: https://publists.nrl.navy.mil/mailman/listinfo/core-dev