User Tools

Site Tools


Sidebar

projects

wcp1 (due 20240828)
wcp2 (due 20240904)
pct0 (bonus; due 20240905)
pct1 (bonus; due 20240905)
pct2 (due 20240905)
abc0 (due 20240906)
dac0 (due 20240911)
pct3 (bonus; due 20240911)
wcp3 (due 20240911)
gtf0 (due 20240918)
pct4 (due 20240918)
wcp4 (due 20240918)
pct5 (bonus; due 20240926)
tpb0 (due 20240926)
wcp5 (due 20240926)
gfo0 (due 20241002)
pct6 (due 20241002)
tpb1 (due 20241002)
wcp6 (due 20241002)
pct7 (bonus; due 20241009)
usr0 (due 20241009)
wcp7 (due 20241009)
bwp1 (bonus; due 20241016)
pct8 (due 20241016)
tpb2 (due 20241016)
wcp8 (due 20241016)
pct9 (bonus; due 20241023)
wcp9 (due 20241023)
wpa0 (due 20241023)
fwg0 (due 20241030)
gfo1 (due 20241030)
pctA (due 20241030)
wcpA (due 20241030)
pctB (bonus; due 20241106)
upf0 (due 20241106)
wcpB (due 20241106)
ldg0 (due 20241113)
pctC (due 20241113)
wcpC (due 20241113)
pctD (bonus; due 20241120)
wcpD (bonus; due 20241120)
bwp2 (bonus; due 20241204)
gfo2 (due 20241204)
pctE (bonus; due 20241204)
wcpE (bonus; due 20241204)
EoCE (due 20241216)
haas:fall2024:unix:projects:abc0

Corning Community College

CSCS1730 UNIX/Linux Fundamentals

PROJECT: Assorted Beginning Concepts (ABC0)

OBJECTIVE

To get started on the course and semester. Bootstrap your access and configuration of various resources, following instructions, contributing to documentation, and asking questions in the discord.

EDIT

You will want to go here to edit and fill in the various sections of the document:

ABC0

NOTE: this is a collaborative document among ALL my classes this semester. That means more people editing. Be mindful that only one person can edit the document at a time.

Only task headings have been provided. You are not expected to know how to do the task given just that description (although in some cases it can be adequately figured out). Instead, if no further information is yet present, ASK FOR DETAILS on the discord.

If something is missing: add it.

If something is present but needs polish: spruce it up.

If something is present but is incorrect: please fix it.

This is intended to be an informative, useful document that all can benefit from.

Those with prior experience, please be mindful not to gobble up all the low-hanging fruit from the newcomers.

Get on discord and into class channels

If for somehow you made it this far into the CS program yet are not in the lab46 discord, there is a link on the respective class syllabus. Click the link, and you will be transported to the channel. Also, you may have to identify yourself to the admin / class.

Getting an editor

You will need a text editor for class, vim is recommended

On WSL you can install it with:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install vim

On Arch you can install it with:

sudo pacman -Syu
sudo pacman -S vim

Log into Lab46 (shell)

Change lab46 password
Clone lab46 semester repo on lab46 (fixrepo)

Log into Lab46 wiki

  • If you are reading this, YOU FOUND THE LAB46 WIKI!
  • Click login in the upper right and enter your user name and password
  • Your username is the beginning of your CCC email (i.e jsmith@corning-cc.edu user = jsmith)
  • Your password is your CCC i.d. (i.e. C00######)
Change lab46 wiki password (can be same as lab46)
  • Once logged in click update profile in the upper right and there is a menu to update your password

Set up personal development system

Clone lab46 semester repo on your system
  • On your system of choice, Virtual Machine or Pi, open a terminal
  • Option 1:
    • If on a Pi or Debian based distro the following command should work
wget -q https://lab46.g7n.org/~wedge/piph/download -O piph
bash ./piph
  • Option 2:
    • Not taking the shortcut route, use these two commands
hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER ~/src
hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER/spring2024 ~/src/spring2024
  • Of course replacing USER with your username
Create info.text file with information

Create using touch, vi, echo, nano, etc.

If requirements for this semester's 'info.text' file are the same as past semesters, the file should include the following information: name, email, discord username, and program.

Example format:

  • name: John
  • email: jdoe@corning-cc.edu
  • disord: JohnDoe
  • program: Computer Science
Create, compile, and execute hello.c

Similarly to info.txt, you can need to create a file using a text editor like nano or vim.

Using one of the text editors, create a new file and name it “hello.c”

Within your file write out your C code for hello world

To compile you can use the gcc command with certain flags like this

USER@lab46:~/src/fall2024/DESIG$ gcc -Wall -std=gnu18 -o "OUTPUTFILE" INPUTFILE 

where INPUTFILE is your uncompiled code, and OUTPUTFILE is your compiled code

Once you have compiled your code you can execute it with ./OUTPUTFILE

Add, Commit, Push changes to repo

In order to move files between Lab46 and your personal computer you can do this by doing hg add, hg commit and hg push and pull. Using hg add will start tracking files. Using hg commit will commit those files and save them (hg commit -m “put commit message here”) and doing hg push will push them out to the other destination where you want to access them. After using hg push make sure to go the destination and use hg pull to get access to the updated files.

Pull and Update project changes on Lab46

Submit project files on lab46

submitting files on lab46 uses the submit command

USER@lab46:~/src/fall2024/DESIG$ submit DESIG PROJECT FILE1 FILE2 FILE3 ...

sub in the class you are taking in place of DESIG, the project you are submitting in place of PROJECT, in this case abc0, and the files you are submitting in place of FILE, in this case your C code and info.txt file. For example, if you were in data submitting abc0:

USER@lab46:~/src/fall/2024/data/abc0$ submit data abc0 helloworld.c info.txt

Customize journal title and intro, edit week1 entry

Each classmate has their own journal that you can see and read, Giving an intro helps introduce yourself. shocking, I know. This is also a great place to be creative and experiment with the text editor. Have fun!

Completing the weekly journal earns you points towards your grade, as well as getting you in the mindset of documenting progress.

Class notes

Class Notes 8/27 Data/Discrete

Preamble:


-Your soul is now on fire!

-Brief history lesson on tables

-Discussed AI policies, don't do it

-Opening projects: abc0 and btt0, do it

-Next due project, making space invaders (msi0 and after that msi1)

-First four pct's are available as of writing. 0 and 1 are due end of tomorrow.

-Journals / Class documents available

Class Discussion:


msi0 - using malloc'ed ARRAYS of structs, make space invaders. On the screen, the player at the bottom will shoot enemies at the top of the screen. They in the form of a grid, all aligned evenly, and if the player's bolt hits the enemy, they should go away with the bolt. The enemies march to one side of the screen and move down a row. The enemies should also shoot back. The player should die and cause a game over when the enemies either hit the player head-on or if their bolt hits the enemy. Consider have a score count on screen. Other bonus features are optional, like shields or powerups.

In your struct for sprites (sprites being the things on screen), consider an X and Y for each on screen.

*Key instruction, how to form arrays with pointers: Sprite *array = NULL; array = (Sprite *)malloc(sizeof(sprite) * 15);

msi1 - the same project, but converting msi0 to use a linked list instead of an array, possibly the conversation for Thursday 8/29

Matt's class will make you think so hard, it'll make you physically ill!

 

SUBMISSION

To be successful in this project, the following criteria (or their equivalent) must be met:

  • Project must be submit on time, by the deadline.
    • Late submissions will lose 33% credit per day, with the submission window closing on the 3rd day following the deadline.
  • All code must compile cleanly (no warnings or errors)
    • Compile with the -Wall and –std=gnu18 compiler flags
    • all requested functionality must conform to stated requirements (either on this document or in a comment banner in source code files themselves).
  • Executed programs must display in a manner similar to provided output
    • output formatted, where applicable, must match that of project requirements
  • Processing must be correct based on input given and output requested
  • Output, if applicable, must be correct based on values input
  • Code must be nicely and consistently indented
  • Code must be consistently written, to strive for readability from having a consistent style throughout
  • Code must be commented
    • Any “to be implemented” comments MUST be removed
      • these “to be implemented” comments, if still present at evaluation time, will result in points being deducted.
      • Sufficient comments explaining the point of provided logic MUST be present
  • No global variables (without instructor approval), no goto statements, no calling of main()!
  • Track/version the source code in your lab46 semester repository
  • Submit a copy of your source code to me using the submit tool (make submit on lab46 will do this) by the deadline.

Submit Tool Usage

Let's say you have completed work on the project, and are ready to submit, you would do the following:

lab46:~/src/SEMESTER/DESIG/PROJECT$ submit DESIG PROJECT file1 file2 file3 ... fileN

You should get some sort of confirmation indicating successful submission if all went according to plan. If not, check for typos and or locational mismatches.

RUBRIC

I'll be evaluating the project based on the following criteria:

13:abc0:final tally of results (13/13)
*:abc0:submitted information for project by duedate [3/3]
*:abc0:got situated in and used class discord [3/3]
*:abc0:contributed to project documentation [1/1]
*:abc0:committed project related changes to semester repo [3/3]
*:abc0:logged into lab46 via SSH [3/3]

Pertaining to the collaborative authoring of project documentation

  • each class member is to participate in the contribution of relevant information and formatting of the documentation
    • minimal member contributions consist of:
      • within reasonable range of the the average edits (a value of at least four productive edits)
      • within reasonable range of the the content change average (a value of at least 1024 bytes (absolute value of data content change))
      • no zero-sum commits (adding in one commit then later removing in its entirety for the sake of satisfying edit requirements)
    • adding and formatting data in an organized fashion, aiming to create an informative and readable document that anyone in the class can reference
    • content contributions will be factored into a documentation coefficient, a value multiplied against your actual project submission to influence the end result:
      • no contributions, co-efficient is 0.50
      • less than minimum contributions is 0.75
      • met minimum contribution threshold is 1.00

Additionally

  • Solutions not abiding by spirit of project will be subject to a 50% overall deduction
  • Solutions not utilizing descriptive why and how comments will be subject to a 25% overall deduction
  • Solutions not utilizing indentation to promote scope and clarity or otherwise maintaining consistency in code style and presentation will be subject to a 25% overall deduction
  • Solutions not organized and easy to read (assume a terminal at least 90 characters wide, 40 characters tall) are subject to a 25% overall deduction
haas/fall2024/unix/projects/abc0.txt · Last modified: 2024/07/31 13:30 by 127.0.0.1