{"id":24625674,"url":"https://github.com/awpala/cs-6290-hpca-setup-and-debugger","last_synced_at":"2025-03-19T17:59:02.497Z","repository":{"id":211928899,"uuid":"730255319","full_name":"awpala/cs-6290-hpca-setup-and-debugger","owner":"awpala","description":"Docker-based development and debugging via VS Code for HPCA (CS 6290)","archived":false,"fork":false,"pushed_at":"2023-12-14T23:12:22.000Z","size":1204,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-25T04:39:31.694Z","etag":null,"topics":["computer-science","cs-6290","debugger","docker","docker-compose","gatech","georgia-tech","gt-omscs","hpca","omscs","omscs-courses","sesc","vscode"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awpala.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-12-11T14:30:17.000Z","updated_at":"2025-01-05T20:09:27.000Z","dependencies_parsed_at":"2023-12-15T00:25:16.934Z","dependency_job_id":null,"html_url":"https://github.com/awpala/cs-6290-hpca-setup-and-debugger","commit_stats":null,"previous_names":["awpala/cs-6290-hpca-setup-and-debugger"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awpala%2Fcs-6290-hpca-setup-and-debugger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awpala%2Fcs-6290-hpca-setup-and-debugger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awpala%2Fcs-6290-hpca-setup-and-debugger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awpala%2Fcs-6290-hpca-setup-and-debugger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awpala","download_url":"https://codeload.github.com/awpala/cs-6290-hpca-setup-and-debugger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244479753,"owners_count":20459450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-science","cs-6290","debugger","docker","docker-compose","gatech","georgia-tech","gt-omscs","hpca","omscs","omscs-courses","sesc","vscode"],"created_at":"2025-01-25T04:39:37.760Z","updated_at":"2025-03-19T17:59:02.478Z","avatar_url":"https://github.com/awpala.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# CS 6290 (HPCA) Docker + VS Code Project Setup and Debugger\n\n## Introduction\n\nThis repository is a collection of resources pertaining to setting up the [SESC](https://sesc.sourceforge.net/) application for projects in OMSCS course ***High Performance Computer Architecture (HPCA)***, CS 6290.\n\nThe net result is a [Docker](https://docs.docker.com/)-based development environment for editing, running, and debugging the SESC app, summarized as follows:\n\n\u003ccenter\u003e\n\u003cimg src=\"./assets/prereq-001.png\" width=\"550px\"\u003e\n\u003c/center\u003e\n\n**CAVEAT**: This setup assumes a local ***x86-based*** client/host device. Otherwise, if using ARM (e.g., Apple Silicon M1, M2, etc.), consult relevant resources and posts in Ed, etc., as the setup described in this guide may be otherwise problematic to deal with.\n\n## Prerequisites\n\nPrior to proceeding further, ensure that the following **dependencies** are installed locally on your client/host device:\n  * [Docker Desktop](https://www.docker.com/products/docker-desktop/) (or equivalent Docker Engine) for containerization\n    * On installation, this will also provide the underlying [Docker Engine](https://docs.docker.com/engine/) (Linux-based) virtualization layer, and the [Docker Compose](https://docs.docker.com/compose/) command line tool\n  * [VS Code](https://code.visualstudio.com/) for interaction with the source code and files\n\n***Note***: For Windows client/host devices, when installing Docker Desktop, use the default/preselected [WSL 2](https://aka.ms/wsl) based installation settings (i.e., rather than Hyper-V). This is a Windows-specific sub-dependency which provides the underlying Linux-based virtualization layer.\n\nAdditionally, ensure the following VS Code extensions are installed:\n  * [Remote Development extension pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack)\n  * [Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker)\n  * [C/C++](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)\n\n***Note***: See [here](https://code.visualstudio.com/docs/remote/remote-overview) for more information regarding VS Code remote extension pack. Also, see [here](https://code.visualstudio.com/docs/languages/cpp) for more information regarding C/C++ development using VS Code.\n\nRelevant files provided in this repository are referenced in subsequent sections/links. For expediency, you may either pull down or download this entire repository in order to access these files in a single/consolidated manner, or otherwise simply transfer these files on an ad hoc basis as needed.\n\n***Note***: In general throughout this repo, `~` and `/home/cs6290/` (i.e., home directory of user `cs6290`) refer to the ***same*** location within the ([Linux-based](https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard)) file system of the Docker-containerized (or equivalent) development environment.\n\n## Environment Setup\n\nOn completed installation of the prerequisites, see the [Environment Setup](./env-setup.md) for further instructions regarding instantiating the Docker-based development environment, which contains a containerized version of the SESC app and related development tools (i.e., compiler and debugger).\n\n## Debugging\n\nOn successful setup of the development environment (or equivalent), see the [Debugging Guide](./debugging-guide.md) for further information regarding configuring and using the debugger (i.e., for projects work).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawpala%2Fcs-6290-hpca-setup-and-debugger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawpala%2Fcs-6290-hpca-setup-and-debugger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawpala%2Fcs-6290-hpca-setup-and-debugger/lists"}