web-bash

web-bash is a simulated terminal interface implemented entirely in your browser. By using the browser, users are able to become accostomed to a command line without putting production systems at risk.

Why would you put your system in danger by letting the intern play with your servers? Buy web-bash and save yourself the trouble.

Authors

• Tyler Romeo
• Nicholas Bevacqua
• Krzysztof Jordan

Installation

Note: all paths are relative to the root folder of webbash

1. Install a LAMP web stack. The following software is recommended:
   • Apache (if not using Apache, make sure to properly configure your web server to match our .htaccess file)
   • PHP 5.3+ with PDO
   • MySQL
   • Linux or Windows (Mac not yet supported)
2. Create a database and user in your MySQL server for WebBash.
3. Import the maintenance/tables.sql file into your database server.
4. Open the config.ini.sample file and replace the sample database credentials with your own.

FEATURES

Stream redirection Examples: echo hello > test cat < test ls 2> testerr

COMMANDS

alias

Declares one or more new command shortcuts
expressions have the form X=(value)             
    EX: alias speak=echo

cat

Outputs contents of one or more files to the stdout 
(unless redirected to a different stream)
    files --- file targets

cd

Changes directories to the provided path
    path --- the path to the file

chgrp

Changes the group of the user
    group --- new group to be assigned
    user --- target user

chmod

Changes the permissions of the file
    permissions --- 3 digit numerical value ranging from 000 to 777
    file --- target file

chown

Change file owner
    user --- new owner of the file
    file --- target file

cp

Copies file1 into file2 
( only works within the same directory for now )
    file1 --- source file
    file2 --- destination file

commands

Prints a list of all available commands

date

Prints the current date to stdout

echo

Prints onto the stdout, ( unless redirected ) 
replaces $name with environment variable value
    args --- arguments to be output to the output stream

export

Declares one or more new environment variables
    expressions --- have the form X=(value)

false

Represents a false value    

help

Prints out help information to stdout

ln

Creates a symbolic link to the target location
source file --- file to assign the new link to
target link --- link to be assigned

ls [OPTIONS]

Shows all the files in current directory,
[OPTIONS]: 
        -l show long format
        -a include all files starting with a .

mkdir

Creates one or more directories
    directories --- directory names

mv

Moves file1 into file2
( only works within the same directory for now )
    file1 --- source file 
    file2 --- destination file

passwd

Changes the password for the current user

pwd

Prints the current directory to stdout

rm [OPTIONS]

Removes one or more files 
( will perform a cascading delete in folders )

[OPTIONS]:
        -r remove folders

rmdir

Removes one or more empty directories
    directories --- the directories to be deleted

sleep

Sleeps for a given amount of seconds
    number --- how many seconds

touch <files ...>

Refreshes the modified times of the given files
    files --- one or more file targets

true

Represents a true value.

uname [OPTIONS]

Prints system information
options: 
        -a print all information
        -s print the kernel name
        -n print the network node hostname
        -r print the release version

unset

Unsets one or more environment variables
    args --- environment variable names, separated by space

useradd []

Adds a new user to the shell environment
    username --- username for the new user
    email --- optional, email to be associated with the user

whoami

Prints your username to stdout