Common Open Research Emulator
Find a file
2017-08-16 12:03:32 -07:00
daemon fixed sendall in sdt, after testing core/sdt3d integration 2017-08-16 12:03:32 -07:00
doc daemon: remove Quagga 'vtysh' service 2017-02-01 09:55:58 -05:00
gui merged latest code from rodolfos merge from the latest github pull 2017-07-06 15:10:50 -07:00
kernel kernel: Avoid using the gawk-specific gensub function. 2015-04-03 01:44:00 +00:00
packaging rpm: include iproute-tc [Build]Requires for fedora >= 25 2017-02-10 11:34:01 -05:00
scripts systemd: remove limit on fork() branching factor 2017-01-12 14:14:41 -05:00
.editorconfig merged cleanup branch with master 2017-06-19 18:03:39 -07:00
.gitignore small test cleanup, can isolate to a singular core test fixture 2017-07-25 10:16:18 -07: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 updated installation to use pip for core_python, added a pip check to configure.ac 2017-08-08 11:29:01 -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 merged cleanup branch with master 2017-06-19 18:09:28 -07:00
README-Xen initial import (Boeing r1752, NRL r878) 2013-08-29 14:21:13 +00:00
README.rst merged cleanup branch with master 2017-06-19 18:09:28 -07:00
revision.sh build: Include revision information in distributions. 2016-01-26 17:01:23 -05:00
sonar-project.properties small test cleanup, can isolate to a singular core test fixture 2017-07-25 10:16:18 -07: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

Note: You may need to pass the proxy settings to sudo make install:
    sudo make install HTTP_PROXY=<proxy>

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://pf.itd.nrl.navy.mil/mailman/listinfo/core-users
.. _core-dev: https://pf.itd.nrl.navy.mil/mailman/listinfo/core-dev