Setup

Prerequisites

You can work on any Linux setup (native install, WSL, VM), but we strongly recommend you use the operating-systems class VMs.

Cloning the repository

If you haven’t already cloned the repository, do so and you are ready to go:

student@os:~$ git clone https://github.com/cs-pub-ro/operating-systems.git
student@os:~$ cd operating-systems

Getting the latest changes

Each time you start a new laboratory, you should ensure you have the latest changes. If you have no local changes, you can simply run git pull and you are ready to go:

student@os:~$ cd operating-systems
student@os:~/operating-systems$ git status  # Check if you have unstaged changes
On branch <not-important>
nothing to commit, working tree clean

# "working tree clean" means that you have no changes
student@os:~/operating-systems$ git pull --rebase

If the git status output differs, follow the instructions to save your progress.

Save Progress and Prepare next lab

1. Check if you have unstaged changes that might be lost:

    student@os:~$ cd operating-systems
    student@os:~/operating-systems$ git status
    On branch <not-important>
    Changes not staged for commit:
    (use "git add <file>..." to update what will be committed)
    (use "git restore <file>..." to discard changes in working directory)
            modified:   main.c
   

   If git status states “work tree clean”, you should follow the instructions to pull latest changes instead.

2. Create a commit to store your changes:

    student@os:~/operating-systems$ git add -f .  # Use -f as `support/` directories are ignored
    student@os:~/operating-systems$ git commit -m "Store progress for lab X"
    student@os:~/operating-systems$ git status    # double check that everything was committed
    On branch <not-important>
    nothing to commit, working tree clean
   

3. Create a new branch for lab Y:

    student@os:~/operating-systems$ git checkout -b lab-Y main  # Replace Y with lab number
    student@os:~/operating-systems$ git pull origin main        # Get latest changes from origin/main
   

4. (Optional) Finding previous labs

   Assuming you followed the instructions in this section, you can find your previous work on other branches:

    student@os:~/operating-systems$ git branch
    main
    lab-1
    lab-2
    * lab-3
    student@os:~/operating-systems$ git checkout lab-2
    Switched to branch 'lab-2'