Skip to content

Commit

Permalink
Merge pull request #355 from cmu-sei/lite
Browse files Browse the repository at this point in the history
Adds ghosts lite client
  • Loading branch information
sei-dupdyke authored May 22, 2024
2 parents 2065e2a + d56a84c commit 17625ac
Show file tree
Hide file tree
Showing 23 changed files with 2,790 additions and 0 deletions.
319 changes: 319 additions & 0 deletions src/Ghosts.Client.Lite/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,319 @@
## Ignore Visual Studio temporary files, build results, and
## files generated by popular Visual Studio add-ons.
##
## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore

# User-specific files
*.suo
*.user
*.userosscache
*.sln.docstates
*.DS_Store

# User-specific files (MonoDevelop/Xamarin Studio)
*.userprefs

# Build results
[Dd]ebug/
[Dd]ebugPublic/
[Rr]elease/
[Rr]eleases/
x64/
x86/
bld/
[Bb]in/
[Oo]bj/
[Ll]og/


# Visual Studio 2015 cache/options directory
.vs/
# Uncomment if you have tasks that create the project's static files in wwwroot
#wwwroot/


# MSTest test Results
[Tt]est[Rr]esult*/
[Bb]uild[Ll]og.*

# NUNIT
*.VisualState.xml
TestResult.xml

# Build Results of an ATL Project
[Dd]ebugPS/
[Rr]eleasePS/
dlldata.c

# Benchmark Results
BenchmarkDotNet.Artifacts/

# .NET Core
project.lock.json
project.fragment.lock.json
artifacts/
**/Properties/launchSettings.json

*_i.c
*_p.c
*_i.h
*.ilk
*.meta
*.obj
*.pch
*.pdb
*.pgc
*.pgd
*.rsp
*.sbr
*.tlb
*.tli
*.tlh
*.tmp
*.tmp_proj
*.log
*.vspscc
*.vssscc
.builds
*.pidb
*.svclog
*.scc

# Chutzpah Test files
_Chutzpah*

# Visual C++ cache files
ipch/
*.aps
*.ncb
*.opendb
*.opensdf
*.sdf
*.cachefile
*.VC.db
*.VC.VC.opendb

# Visual Studio profiler
*.psess
*.vsp
*.vspx
*.sap

# TFS 2012 Local Workspace
$tf/

# Guidance Automation Toolkit
*.gpState

# ReSharper is a .NET coding add-in
_ReSharper*/
*.[Rr]e[Ss]harper
*.DotSettings.user

# JustCode is a .NET coding add-in
.JustCode

# TeamCity is a build add-in
_TeamCity*

# DotCover is a Code Coverage Tool
*.dotCover

# Visual Studio code coverage results
*.coverage
*.coveragexml

# NCrunch
_NCrunch_*
.*crunch*.local.xml
nCrunchTemp_*

# MightyMoose
*.mm.*
AutoTest.Net/

# Web workbench (sass)
.sass-cache/

# Installshield output folder
[Ee]xpress/

# DocProject is a documentation generator add-in
DocProject/buildhelp/
DocProject/Help/*.HxT
DocProject/Help/*.HxC
DocProject/Help/*.hhc
DocProject/Help/*.hhk
DocProject/Help/*.hhp
DocProject/Help/Html2
DocProject/Help/html

# Click-Once directory
publish/

# Publish Web Output
*.[Pp]ublish.xml
*.azurePubxml
# TODO: Comment the next line if you want to checkin your web deploy settings
# but database connection strings (with potential passwords) will be unencrypted
*.pubxml
*.publishproj

# Microsoft Azure Web App publish settings. Comment the next line if you want to
# checkin your Azure Web App publish settings, but sensitive information contained
# in these scripts will be unencrypted
PublishScripts/

# NuGet Packages
*.nupkg
# The packages folder can be ignored because of Package Restore
**/packages/*
# except build/, which is used as an MSBuild target.
!**/packages/build/
# Uncomment if necessary however generally it will be regenerated when needed
#!**/packages/repositories.config
# NuGet v3's project.json files produces more ignorable files
*.nuget.props
*.nuget.targets

# Microsoft Azure Build Output
csx/
*.build.csdef

# Microsoft Azure Emulator
ecf/
rcf/

# Windows Store app package directories and files
AppPackages/
BundleArtifacts/
Package.StoreAssociation.xml
_pkginfo.txt
*.appx

# Visual Studio cache files
# files ending in .cache can be ignored
*.[Cc]ache
# but keep track of directories ending in .cache
!*.[Cc]ache/

# Others
ClientBin/
~$*
*~
*.dbmdl
*.dbproj.schemaview
*.jfm
*.pfx
*.publishsettings
orleans.codegen.cs

# Since there are multiple workflows, uncomment next line to ignore bower_components
# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
#bower_components/

# RIA/Silverlight projects
Generated_Code/

# Backup & report files from converting an old project file
# to a newer Visual Studio version. Backup files are not needed,
# because we have git ;-)
_UpgradeReport_Files/
Backup*/
UpgradeLog*.XML
UpgradeLog*.htm

# SQL Server files
*.mdf
*.ldf
*.ndf

# Business Intelligence projects
*.rdl.data
*.bim.layout
*.bim_*.settings

# Microsoft Fakes
FakesAssemblies/

# GhostDoc plugin setting file
*.GhostDoc.xml

# Node.js Tools for Visual Studio
.ntvs_analysis.dat
node_modules/

# Typescript v1 declaration files
typings/

# Visual Studio 6 build log
*.plg

# Visual Studio 6 workspace options file
*.opt

# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
*.vbw

# Visual Studio LightSwitch build output
**/*.HTMLClient/GeneratedArtifacts
**/*.DesktopClient/GeneratedArtifacts
**/*.DesktopClient/ModelManifest.xml
**/*.Server/GeneratedArtifacts
**/*.Server/ModelManifest.xml
_Pvt_Extensions

# Paket dependency manager
.paket/paket.exe
paket-files/

# FAKE - F# Make
.fake/

# JetBrains Rider
.idea/
*.sln.iml

# CodeRush
.cr/

# Python Tools for Visual Studio (PTVS)
__pycache__/
*.pyc

# Cake - Uncomment if you are using it
# tools/**
# !tools/packages.config

# Tabs Studio
*.tss

# Telerik's JustMock configuration file
*.jmconfig

# BizTalk build output
*.btp.cs
*.btm.cs
*.odx.cs
*.xsd.cs
ghosts.tools.emailgenerator/config/email-content.csv
ghosts.tools.emailgenerator/config/email-content - Copy.csv
# Ghosts.Client/config/email-reply.csv
# Ghosts.Client/config/email-content.csv
vtunnel.exe

_db/
_g/

_data/
_data/*
*_data/*

_config/
_config/*
*_config/*

_output/
_output/*
*_output/*
output/
16 changes: 16 additions & 0 deletions src/Ghosts.Client.Lite/Ghosts.Client.Lite.sln
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@

Microsoft Visual Studio Solution File, Format Version 12.00
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Ghosts.Client.Lite", "src\Ghosts.Client.Lite.csproj", "{2457881B-2005-4694-BDAA-A8E893D2CF7D}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Release|Any CPU = Release|Any CPU
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{2457881B-2005-4694-BDAA-A8E893D2CF7D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{2457881B-2005-4694-BDAA-A8E893D2CF7D}.Debug|Any CPU.Build.0 = Debug|Any CPU
{2457881B-2005-4694-BDAA-A8E893D2CF7D}.Release|Any CPU.ActiveCfg = Release|Any CPU
{2457881B-2005-4694-BDAA-A8E893D2CF7D}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
EndGlobal
41 changes: 41 additions & 0 deletions src/Ghosts.Client.Lite/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# GHOSTS LITE

## Background

### What is this?
GHOSTS LITE is a streamlined version of the GHOSTS framework designed to simulate realistic
network without the expense of running actual applications. It generates web browsing traffic
and file creation programatically and is configured to be similar to real-user actions.

### Why did we build this?
We built ghosts-lite to provide a more efficient tool for simulating network activity. By
avoiding the need to launch applications like web browsers or office suites, ghosts-lite is
able to reduce the resource consumption and complexity of the simulation, resulting in saving
CPU, storage space, and other memory resources.

### What were the goals?

- **Efficiency:** Reduce the resources required to simualte user activity on a network.
- **Simplicity:** Simplify installation and configuration compared to the full GHOSTS framework
- **Realism:** Maintain the ability to generate realistic network activity.

## Installation

### Prerequisites
- Ensure you have the .NET framework installed on your system.

### Download and install ghosts-lite

1. **Download the latest release** from *Insert link to repository once moved*.
2. **Extract the downloaded archive** to a directory of your choice.
3. **Open terminal** and navigate to the directory where you extracted ghosts-lite

## Troubleshooting

- Ensure the .NET framework is installed with version 8.0 or later.
- If you're experiencing any problems please submit an issue or start a discussion.

## License

[DISTRIBUTION STATEMENT A] This material has been approved for public release and unlimited distribution.
Copyright 2017 Carnegie Mellon University. All Rights Reserved. See LICENSE.md file for terms.
Binary file added src/Ghosts.Client.Lite/lib/ghosts.domain.dll
Binary file not shown.
Loading

0 comments on commit 17625ac

Please sign in to comment.