{"id":27215615,"url":"https://github.com/anubislms/xv6","last_synced_at":"2025-08-24T15:09:04.445Z","repository":{"id":43472183,"uuid":"237458114","full_name":"AnubisLMS/xv6","owner":"AnubisLMS","description":"NYU's fork of MIT's xv6-public","archived":false,"fork":false,"pushed_at":"2023-12-10T22:33:39.000Z","size":211,"stargazers_count":14,"open_issues_count":2,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-09T17:03:10.196Z","etag":null,"topics":["c"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AnubisLMS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-31T15:28:45.000Z","updated_at":"2024-10-06T08:06:51.000Z","dependencies_parsed_at":"2023-12-10T23:37:38.459Z","dependency_job_id":null,"html_url":"https://github.com/AnubisLMS/xv6","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/AnubisLMS/xv6","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnubisLMS%2Fxv6","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnubisLMS%2Fxv6/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnubisLMS%2Fxv6/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnubisLMS%2Fxv6/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AnubisLMS","download_url":"https://codeload.github.com/AnubisLMS/xv6/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnubisLMS%2Fxv6/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271895131,"owners_count":24840090,"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","status":"online","status_checked_at":"2025-08-24T02:00:11.135Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["c"],"created_at":"2025-04-10T04:26:09.737Z","updated_at":"2025-08-24T15:09:04.402Z","avatar_url":"https://github.com/AnubisLMS.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VSCode Integration\n\n## Compiling\nIf you are using the class vm, to compile, just run `make xv6.img` in the project directory. That will build xv6.img. Assuimging that was successful, you can then run xv6 by running `make qemu`. If you make changes to any xv6, you will likely need to first clean out the \"stale\" binaries before rebuilding xv6.img. You can clean your build environment with `make clean`.\n\n## Debugging \nYou will then want to navigate to\nrun `make clean \u0026\u0026 make qemu-vscode` once the gdb server has started, it will wait for connections. You can then \nnavigate to your debug console in VSCode and select gdb from the gear icon. You should see an \"Attach to QEMU\" profile \navailable. When you run this, you should connect to the gdb server. Go ahead and try to set up breakpoints and whatnot. \n\n## Compiling with Docker (if you want to)\nIf you are already a linux power user, you can compile natively with docker. You can compile xv6 with docker my running `make docker`. That will run an ubuntu 18.04 container that will compile xv6.img for you. I would not recommend relying on this unless you are already profcient with docker.\n\n## Dependencies (if you are not on the VM)\nIf you are compiling natively, will need to add a plugin to your vscode. To install the necessary dependencies for debugging in vscode, press `ctrl p` then enter `ext install webfreak.debug`. \nThat will install [this](https://github.com/WebFreak001/code-debug) vscode module. You will also need to install\ngdb and lldb if you haven't already. On debian that is `sudo apt update \u0026\u0026 sudo apt install -y gdb lldb`, on arch \n(btw) `sudo pacman -S gdb lldb`, and alpine `sudo apk add --update gdb lldb`.\n\n\n# Old stuff\n\nxv6 is a re-implementation of Dennis Ritchie's and Ken Thompson's Unix\nVersion 6 (v6).  xv6 loosely follows the structure and style of v6,\nbut is implemented for a modern x86-based multiprocessor using ANSI C.\n\nACKNOWLEDGMENTS\n\nxv6 is inspired by John Lions's Commentary on UNIX 6th Edition (Peer\nto Peer Communications; ISBN: 1-57398-013-7; 1st edition (June 14,\n2000)). See also http://pdos.csail.mit.edu/6.828/2014/xv6.html, which\nprovides pointers to on-line resources for v6.\n\nxv6 borrows code from the following sources:\n    JOS (asm.h, elf.h, mmu.h, bootasm.S, ide.c, console.c, and others)\n    Plan 9 (entryother.S, mp.h, mp.c, lapic.c)\n    FreeBSD (ioapic.c)\n    NetBSD (console.c)\n\nThe following people have made contributions:\n    Russ Cox (context switching, locking)\n    Cliff Frey (MP)\n    Xiao Yu (MP)\n    Nickolai Zeldovich\n    Austin Clements\n\nIn addition, we are grateful for the bug reports and patches contributed by\nSilas Boyd-Wickizer, Peter Froehlich, Shivam Handa, Anders Kaseorg, Eddie\nKohler, Yandong Mao, Hitoshi Mitake, Carmi Merimovich, Joel Nider, Greg Price,\nEldar Sehayek, Yongming Shen, Stephen Tu, and Zouchangwei.\n\nThe code in the files that constitute xv6 is\nCopyright 2006-2014 Frans Kaashoek, Robert Morris, and Russ Cox.\n\nERROR REPORTS\n\nIf you spot errors or have suggestions for improvement, please send\nemail to Frans Kaashoek and Robert Morris (kaashoek,rtm@csail.mit.edu). \n\nBUILDING AND RUNNING XV6\n\nTo build xv6 on an x86 ELF machine (like Linux or FreeBSD), run \"make\".\nOn non-x86 or non-ELF machines (like OS X, even on x86), you will\nneed to install a cross-compiler gcc suite capable of producing x86 ELF\nbinaries.  See http://pdos.csail.mit.edu/6.828/2014/tools.html.\nThen run \"make TOOLPREFIX=i386-jos-elf-\".\n\nTo run xv6, install the QEMU PC simulators.  To run in QEMU, run \"make qemu\".\n\nTo create a typeset version of the code, run \"make xv6.pdf\".  This\nrequires the \"mpage\" utility.  See http://www.mesa.nl/pub/mpage/.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanubislms%2Fxv6","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanubislms%2Fxv6","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanubislms%2Fxv6/lists"}