Web Resources for CS3650 (Computer Systems)

Instructor: Gene Cooperman
Spring Semester, 2024

NOTE:
The office hours are as stated on the syllabus (Tues. and Fri., 5:15 - 6:30; for Spring, 2024), and by appointment. I am typically still in my office at least until 7pm.

===============================

Course basics: Here are some immediate resources in the course for doing homework, following the readings, etc.

Course home:
The course materials will always be available either from this web page or from the course directory on the Khoury Linux computers: /course/cs3650/.
Syllabus:
The syllabus contains the required readings in the textbook. It's available from the link or from /course/cs3650/ (the course directory) on Khoury Linux computers. Note especially our online textbook ostep.org.
Homework:
The homework subdirectory of the course directory contains all course homework, and the course directory contains all handouts.
Help directory:
The course directory includes a help directory. There are two older reviews of UNIX there. But please consider this excellent modern introduction to UNIX by M. Stonebank. (or alt, with updates to Linux/bash by C. Tothill)
Linux:
The course is based on Linux (the third of the three popular operating systems). If you do not yet have a Khoury Linux account, get one. If you are not fluent in the basics of Linux/UNIX, please go to any of the good tutorials on the Web. Personally, I like: *** this Linux tutorial *** (from M. Stonebank, U. of Surrey, England), or this *** updated one for Linux/bash *** (by C. Tothill)
Other useful tips on Linux:
  1. Productivity tip: In most settings: the four cursor keys work (for editing the current or previous commands); and the <TAB> key works (for auto-completion of filenames and commands).
  2. If you're using Apple (the second most popular operating system), the terminal window provides you with a UNIX-like environment.
  3. If you're using Windows (the most popular operating system), you can install WSL2 (Windows Subsytem for Linux, version 2). This gives you a Linux virtual machine side-by-side with Windows. If you are unsure of which Linux distribution to use, Ubuntu is a common first choice for those unfamiliar with Linux. Some "gotchas" and workarounds follow.
    After installing WSL, a known bug from May, 2021 causes the vmmem process to consume a lot of CPU time at wake-after-sleep, if WSL was running. There is a workaround here.
    (On an older system (2021), when I followed the instructions for WSL2, I got Error 0x1bc and I fixed it by downloading the MSI package listed here. I then needed to enter "Windows Features" in the search bar, and then select "Windows Hypervisor Platform", and then go back to following the Microsoft Windows instructions. Some people may also need to turn on virtualization in their BIOS. After entering BIOS, examine all options in all tabs with the letter 'v'. For me, the option was "AMD SVM".)
  4. In order to copy files between Windows and WSL, I create a link inside WSL to the 'Downloads' folder:
    cd
    ls /mnt/c/Users
    # For me, I am user 16176 in Windows. So, I type:
    ln -s /mnt/c/Users/16176/Downloads ./
    # You can now copy (cp) between ~/Downloads and ~ in WSL,
    # where '~' is the Linux shortcut for your home directory.
  5. But if you insist on not using Windows, but not WSL2, then please try putty (substitute for 'ssh') and WinSCP (substitute for 'scp'). For 'ssh' without WSL2, you can alternatively install OpenSSH for Windows.
  6. Regardless of whether you are using Linux, Apple, or Windows/WSL2 on your laptop, practice using ssh USERNAME@login.ccs.neu.edu and scp myfile.txt USERNAME@login.ccs.neu.edu: (and notice the final colon with the 'scp' command line). For help, try: man ssh and man scp.
Linux editors:
Please also note the directory for UNIX (Linux) editors. On Khoury Linux, try: cd /course/cs3650/unix-editors. The editor vi is a popular choice. To learn vi (estimated time: one hour), login to Khoury Linux and do:
    vi /course/cs3650/editors-unix/vitutor.vi
and follow the on-screen instructions.
MIPS assembly language:
The assembly portion of the course will be based on MIPS. Please download the MARS Simulator for use with MIPS assembly. You can find the (optional) textbook's "Green Card" online. You can find a manual for MIPS as Appendix A in the (optional) textbook or else in Appendix A online, or here. Read this, and re-read it. The latter may require your Khoury Linux password. Some other possibly useful resources from the web are this quick reference sheet and this old introduction to the MARS Simulator. The course will also heavily use the MIPS simulator.
Common Linux Commands:
Here is one web site (Common Linux Commands) with about 30 common Linux commands. If you haven't used Linux much, try a quick review of these commands (passive knowledge only). If you need more, there are plenty of great text and video tutorials on the Linux command line.
C language:
We will briefly review the C  language (the core of Java, but including primitive types, only). For a more extensive overview of C, consider a good, free on-line C book by Mike Banahan, Declan Brady and Mark Doran.
GDB debugger, gcc compiler, etc.:
Some help files for Linux and its compilers, editors, etc. are also available. As you use Linux, please especially practice using GDB (GNU debugger). This will help when you test your homeworks under Linux. It will also reward you with more productive debugging for the rest of your computer science career.
Python
See materials on Python, and the Python subdirectory
UNIX xv6
The original UNIX was small enough that one can read all of the code, with the right guidance. The UNIX xv6 subdirectory has an easy-to-read hyperlinked version of UNIX xv6, with about 7,000 lines of code (about 100 pages of code).
Thread synchronization
"thread-synch" subdirectory (notes on basic use of mutex, semaphore and condition variables)
Undergraduate tutoring:
Khoury College used to offer free undergraduate upper-class tutoriing. I don't see a link to it right now (as of Sept., 2021). If someone knows more about the current status of this resource, tell me, and I'll update a link to it.

Going beyond: enrichment material:

Text supplements (optional) for course:

RISC-V Simulator for Assembly Language homework (MARS):

  1. In Spring, 2025, we are now switching from MIPS to RISC-V CPUs. The MIPS resources, below, will all be changed to the analogous resources for RISC-V.
  2. There is a MIPS Assembly language simulator with free downloads available (and local copy) and online documentation. For your convenience, a copy of the simulator is at: MIPS-simulator. There is also an online video demo of the Mars simulator.
  3. To begin running the simulator, go inside the folder, and double-click on the Mars.jar icon. Alternatively, if running from the command line in Linux, type: java -jar Mars.jar If you download Mars.jar for your computer, there are also suggestions on that page for running Mars.
  4. The syntax of the assembly language is intended to be compatible with Appendix B of our textbook (also available online (requires CCIS password)).
  5. The software is distributed as a Java .jar file. It requires Java J2SE 1.5 or later. Depending on your configuration, you may be able to directly open it from the download menu.

    If you have trouble, or if you prefer to run from the command line on your own computer, the Java SDK is is also available for free download from the same download page. The instructions for running it from Windows or DOS should work equally well on Linux. The CCIS machines should already have the necessary Java SDK installed.

  6. GOTCHAS: There are several important things to watch out for.
    1. When you hit the "Assemble" menu item, any error messages about failure to assemble are in the bottom window pane, tab: "Mars Messages". Input/Output is in the bottom window pane, tab: "Run I/O"
    2. If you paste assembly code into the edit window pane, you must save that code to a file before Mars will let you assemble it.
    3. If you have selected a box with your mouse (e.g. "Value" box in the data window pane, or "Register" box), then Mars will not update the value in that box. Mars assumes you prefer to write your own value into that box, and not to allow the assembly program to use that box.
    4. If your program stops at an error, read the "Mars Messages" for the cause of the error, and then hit the "Backstep" menu item to see what caused that error. Continue hitting "Backstep" or "Singlestep" in order to identify the error.
    5. Your main routine must call the "exit" system call to terminate. It may not simply call return ("jr $ra"). Note that page B-44 of Appendix B of the text (fourth edition) has a table of "system services" (system calls). These allow you to do "exit" and also I/O.
  7. One of the nicer features of this software is a limited backstep capability (opposite of single-step) for debugging. In addition, the help menu includes a short summary of the MIPS assembly instructions. In general, I like this IDE for assembly even better than some of the IDEs that I have seen for C/C++/Java. (The one feature that I found a little unintuitive is that if you want to look at the stack (for example) instead of data, you must go to the Data Segment window pane, and use the drop-down menu at the bottom of that pane to choose "current $sp" instead of ".data".)
  8. Please note the three sample assembly programs, along with an accompanying tutorial on the same web page.
  9. I'd appreciate if if you could be on the lookout for any unusual issues, and report them promptly (along with possible workarounds), so the rest of the class can benefit. Thanks very much for your help on this.

===============================

The GNU debugger

GDB (GNU DeBugger):
  A Few Simple Debugging Commands Save You Hours of Work 

        INVOKING gdb:
          gdb --args  
          Example:  gdb --args ./a.out myargs

        COMMON gdb COMMANDS:
          BREAKPOINTS:  break, continue
          STARTING:  break main, run
          WHERE AM I:  info threads, thread 1; where, frame 2; list
          PRINT:  ptype, print  (   ptype argv[0]; print argv[0]   )
          EXECUTING:  next, step, until, finish, continue
            (next line, step inside fnc, until previously
             unseen line (escape a loop), finish current fnc,
             continue to next breakpoint)
          EXIT:  quit
          < Cursor keys work, TAB provides auto-complete >
          PARENT AND CHILD PROCESSES:
            set follow-fork-mode child
              (after call to fork(), switch to debugging child process)
          DEBUGGING INFINITE LOOP:
            run; TYPE ^C (ctrl-C) TO TALK TO gdb; where; print var1; etc.
          HELP:  help    e.g.: (gdb) help continue

        ADVANCED gdb: USING gdbinit:
          In a more sophisticated debugging session, you may have to try
          multiple GDB sessions.  To do this, you will want to try doing:
            gdb -x gdbinit --args ./a.out myargs
          First, create a gdbinit file. An easy way is, in your last GDB session,
            (gdb) show commands
          Then copy-paste those comamnds into gdbinit and edit as desired.
          Then at the top of gdbinit, insert:
            # gdb -x gdbinit --args ./a.out myargs  [Customize as needed]
            set breakpoint pending on
            set pagination off
            # Stop if about to exit:
            break _exit           
            # Continue w/ output of 'show commands'; Extend and modify as needed

        MORE ADVANCED gdb:
          info function 
            IF DEBUGGING C++ CODE, you will find this useful, in order
            to discover the full GDB name of your target method.
          macro expand MACRO_FNC(ARG)  [requires 'gdb -g3']
          debugging child after fork:
            set follow-fork-mode child
            break fork
            run
          EXTENDED "WHERE AM I":
            set detach-on-fork off
            info inferiors; inferior 2
            info threads; thread 1
              NOTE:  The qualified thread number is: .
                     So, 'thread 2.3' switches to thread 3 in inferior 2.
            where; frame 2
            list; print myvariable
And for the adventurous, consider this full-featured GDB Dashboard. It's a nicer version of things like "layout src". For digging deeper into GDB, try: "gdb - customize it the way you want".

  NOTE: For those who like a full-screen display of the current code, try the command ^Xa (ctrl-X a) to turn full-screen mode on and off. Also, try: (gdb) layout split
And finally, try "focus cmd" and "focus src", or ^Xo, to decide which pane you want your cursor keys to operate on.

  NOTE: For those who like to try a reversible version of GDB, see rr-project.org (for GDB with reverse execution)

  NOTE: For a _really cool_ GDB interface, look at: https://github.com/cyrus-and/gdb-dashboard. To try it out, just go to the .gdbinit file from that web site, and then copy the code into a local file, gdbinit-dashboard, and then execute source gdbinit-dashboard in GDB. Personally, I like to use Dashboard by displaying the whole dashboard in another terminal.

===============================
Python

There are some good introductory materials for Python in the instructor's directory. After trying those out, here are some other Python background materials:

Python

NEWS (from Fall, 2021 and earlier):

===============================
Current Events

NEWS (from 2024 and earlier):
SPECULATION ABOUT FUTURE CHIPS AND THE END OF MOORE'S LAW:       For context, note the Wikipedia Silicon article on the covalent radius of silicon is 0.111 nm. So, the distance between adjacent silicon atoms is the diameter (0.222 nm).
       7 nm is approximately 31.5 silicon atom diameters. 5 nm is approximately 22.5 silicon atom diameters. 3 nm is approximately 13.5 silicon atom diameters. 2 nm is approximately 9.0 silicon atom diameters.

       Motivation for multi-core CPUs: Limits of CPU Power Trends at beginning of the millenium (from here)