README.md~ 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. WebGCC
  2. ======
  3. Introduction
  4. ------------
  5. Welcome to my little project called WebGCC, a barebones PHP based web interface for the GNU Compiler Collections.
  6. Features
  7. --------
  8. * Written in HTML and PHP.
  9. * Accepts code, standard input, command-line arguments, and text input.
  10. * Supports multiple execution sessions.
  11. More features will be added soon, like graphics, a nicer code editor and library selection support.
  12. Feel free to fork my project, modify it and merge the changes back to it.
  13. Requirements
  14. ------------
  15. The requirements aren't anything special, just an ordinary LAMP stack. The specific requirements are:
  16. * Linux distribution (preferably Debian)
  17. * Apache webserver (2.2 or greater)
  18. * PHP 5.4 or greater
  19. * shell_exec() should be enabled
  20. Installation manual
  21. -------------------
  22. 1. Download the repo as a zip file, extract it locally into a folder named 'webgcc'.
  23. 2. (a) The script files should be placed in /var/www/. This can be achieved by just copying the 'webgcc' script folder into the directory.
  24. (b) Alternatively, if the script is to be hosted by a particular user account, a VirtualHost should be created pointing to the public_html directory of that user. The instructions on creating a VirtualHost can be found in Apache HTTP server manual at http://httpd.apache.org/docs/2.2/vhosts/examples.html
  25. After the VirtualHost is created, the user account must be added to the www-data group, and the group ownership of the public_html directory must be set to www-data, along with the proper permissions.
  26. This is done by issuing the following commands in order in the terminal:
  27. cd /home/user/ (where 'user' is the username of the user account)
  28. chown -R user.www-data public_html
  29. usermod -a -G www-data user
  30. chmod 775 public_html
  31. Finally the 'webgcc' script folder must be copied into public_html directory.
  32. 3. The 'webgcc' folder must have writeable permissions, so it's most recommended to set the permissions to 775. This is done by navigating to the working directory from the terminal and issuing the command:
  33. chmod 775 webgcc
  34. 4. Finally the script files should be set with the proper permissions (755). This is done by typing the following commands in order:
  35. cd webgcc
  36. chmod 755 *
  37. Usage
  38. -----
  39. Just open the URL of the interface site. Rest is self-explanatory.
  40. More info and discussion
  41. ------------------------
  42. Just go to the forum thread: