Table of Contents

Corning Community College

CSCS1320 C/C++ Programming

Project: CCI0

Errata

This section will document any updates applied to the project since original release:

Objective

In this project, we get started with some course initialization activities.

Project Overview

Course Homepage

You're reading this, so you've likely already found your way to the course homepage. It consists of the syllabus plus additional course resources.

Please familiarize yourself with it, bookmarking important resources as appropriate, so that you can refer back when needed.

I'd recommend knowing how to get to the projects page (where you found the link for this project), as new content will be posted there.

Syllabus

Be sure to read through and over the syllabus, ensuring there are no questions on the material and organization of the course.

Wiki

The course homepage/syllabus, your journal, and other resources are made available to you via the lab46 wiki. In order to better access your web resources for the course, you must log in:

Go ahead and familiarize yourself with these resources.

Journal Intro

Clicking on your journal link:

Familiarize yourself with your Journal, and once there:

NOTE: Week 1 journal entry will be due before the week1 journal deadline, the remainder of the intro Journal content will be due by this project's deadline.

Mailing List

I intend to establish a mailing list which I will use for class announcements (along with irc, the notes wiki page, your journal, etc.).

During project submission, please provide one or more e-mail addresses you check somewhat regularly so that I can subscribe you to the list.

To do this, place your preferred e-mail address(es) in an info.text file, prefixed via an “e-mail: ” descriptor.

For example:

name: John Smith
e-mail: jsmith1234@site.com

Class Chat (IRC)

Run the “chat” script at a lab46 prompt to get established in the class chat.

You will likely be joining multiple channels. Pay attention to the blue status bar at the bottom.

To switch between channels:

To detach from the class chat, type: ctrl+a d

(press and hold control when you tap 'a'; release both keys and press 'd').

Lab46 Shell

For many of you, this will be your first experience in the LAIR and/or logging onto Lab46.

If you are new, the first day I will have your login information which will be provided, and we will spend a few moments getting everyone logged in.

If you are already familiar, please ensure you can still log into the pods and lab46.

Personal/Per-User Lab46 Mercurial Repository

NOTE: If you have already done this in a prior semester, you do NOT need to do it again.

To both aid you and help you develop better development skills, I'd like for you to make regular commits and pushes to your Lab46 mercurial repository.

This way, you can have a regular snapshot of your work as you go along, plus have the ability to grab an older copy should something go wrong.

Like the Journal, I will be looking for a minimal amount of repository-related activity PER WEEK.

To set up your repository, run the “fixrepo” script:

lab46:~$ fixrepo

For basic repository operation, when you make new files you'd like to track, or see the status of any tracked files that have changed:

lab46:~$ cd src
lab46:~/src$ hg status
A .hgignore
lab46:~/src$ 

Once cloned (to your ~/src directory), you will be able to add, commit, and push changes made:

lab46:~/src$ hg add
lab46:~/src$ hg commit -m "brief message describing the changes"
lab46:~/src$ hg push

On the push, you will be prompted to provide your lab46 password.

And that's it! Repeat this process (NOT the 'fixrepo'; only do that once) for any changes you make to your repository.

Program to Implement

As a first week exercise, I would like you to implement, successfully compile, and verify correct execution of the best first program every great programmer writes: Hello World

Code will be as follows:

1
/*
 * hello.c - the first best C program ever
 *
 * written by: your name
 */
#include <stdio.h>
 
int main()                              // every program needs a start, main() is ours
{
    fprintf(stdout, "Hello, World!\n"); // display a message to STDOUT
    return (0);                         // return a success status to OS
}

Your task will be to transcribe this code (sans line numbers), into a source file (call it hello.c for simplicity), within some subdirectory of your lab46 account (~/src/cprog/cci0/ may be a good choice).

lab46:~$ mkdir src/cprog/cci0
lab46:~$ cd src/cprog/cci0
lab46:~/src/cprog/cci0$ 

You may want to use the nano text editor for this:

lab46:~/src/cprog/cci0$ nano hello.c

The nano text editor is a simple editor that provides basic functionality (commands listed at the bottom of the screen. You press the CONTROL key in combination with whatever letter invokes the desired functionality).

To save the file: CTRL+o

To save and exit (or exit if there are no changes made): CTRL+x

Note that if there are any changes, you will be prompted whether or not you'd like to save them (the changes are in memory (aka the buffer), and nano will prompt if you'd like to save the modified buffer). You will then be prompted for the filename (filling in the current filename, if there is one). Just press enter to accept these changes.

Verify you typed in everything correctly by compiling it; you want no warnings or errors:

lab46:~/src/cprog/cci0$ gcc -o hello hello.c
lab46:~/src/cprog/cci0$ 

Get to know/ask questions about that gcc line… this will not be the only time you see it.

Finally, verify the program runs as anticipated:

lab46:~/src/cprog/cci0$ ./hello
Hello, World!
lab46:~/src/cprog/cci0$ 

Once satisfied, be sure to submit the program as indicated below.

Submission Criteria

To be successful in this project, the following criteria must be met:

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/cprog/cci0$ submit cprog cci0 hello.c info.text
Submitting cprog project "cci0":
    -> hello.c(OK) 
    -> info.text(OK)

SUCCESSFULLY SUBMITTED
lab46:~/src/cprog/cci0$ 

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.

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

13:cci0:final tally of results (13/13)
*:cci0:customized journal (title and intro) [1/1]
*:cci0:joined class irc chat [1/1]
*:cci0:submitted proper info.text file [1/1]
*:cci0:cloned lab46 mercurial repository into ~/src [1/1]
*:cci0:submitted file called hello.c [1/1]
*:cci0:committed and pushed hello.c to repository [1/1]
*:cci0:adequate and consistent indentation in hello.c [1/1]
*:cci0:sufficient comments in hello.c [1/1]
*:cci0:executable runs without issue [1/1]
*:cci0:output conforms to project specifications [1/1]
*:cci0:adequate modifications in hello.c [1/1]
*:cci0:no compiler warnings for hello.c [1/1]
*:cci0:no compiler errors for hello.c [1/1]

Additionally: