<WRAP centeralign round box>
<WRAP><color red><fs 200%>Corning Community College</fs></color></WRAP>
<WRAP><fs 150%>CSCS1730 UNIX/Linux Fundamentals</fs></WRAP>
</WRAP>

~~TOC~~

======Project: ANOTHER PUZZLEBOX (pbx1)======

=====Errata=====

  * any bugfixes or project updates will be posted here

=====Objective=====
To continue to cultivate your problem solving skills, and to demonstrate your basic scripting skills for task automation.

=====Commentary=====
The first puzzlebox was in many ways a test of your observational skills. To many, the frustrations emerged from what was being taken for granted. But once you took proper notice, and could apply the appropriate skills, its secrets could be obtained.

This second puzzlebox will test both your observation skills (in a slightly different way) and reasoning skills in an abstract manner. Along with that, your scripting skills are being put to the test as well: your submission will more heavily rely upon a fully functional steps file that will entirely automate the process. If you are observant, the information you need is presented early on, but is a few layers of abstraction out of reach. Patience and perseverance will be key to victory.

=====Toolbox=====
You might want to consult the following manual pages before commencing on the project:

  * **cat**(1)
  * **cut**(1)
  * **grep**(1)
  * **head**(1)
  * **paste**(1)
  * **sort**(1)
  * **tail**(1)
  * **tr**(1)
  * **uudecode**(1)
  * **uniq**(1)

=====Obtain the file=====
This week's project is located in the **pbx1/** sub-directory of the UNIX Public Directory, under a directory by the name of your username, there should be 2 files. One named **README**, and the other containing **pbx1** in its name.

Make a copy into your home directory somewhere and set to work.

**NOTE:** Hopefully it has been standard practice to locate project files in their own unique subdirectory, such as under **src/unix/**, where you can then add/commit/push the results to your repository (you ARE regularly putting stuff in your repository, aren't you?)
 
=====Process=====
As with the first puzzle box, you are on your own. Use your skills, your observations, and your experiences gained to unravel this new puzzle.

Be observant, explore ideas, read about and learn how to use various tools (both familiar, but in potentially new/different ways, as well as entirely new tools).

Your **pbx1steps** file is expected to be an operational script that will fully automate the project (from initial copy/creation of local project data directories right up until, but not including, the final submit line).

As such, you are expected to make use of various shell features, such as:
  * wildcards
  * variables
  * I/O redirection

These features will also serve to simplify your script, allowing it to be cleaner and less error-prone.
=====Verification=====
The final file, when correctly unscrambled and assembled, can be verified by generating its **md5sum** hash.

This hash should match the hash stored inside the **MANIFEST** file located in the project directory (in the public directory).

=====Submission=====
In addition to the file produced during the completion of this project, I would also like for you to create a detailed step-by-step text file called **pbx1steps** which includes the valid command-lines that will document for me the steps you took from project commencement through completion. You will submit this file at the end in accordance with the instructions.

When you see an ordered english-readable file with ASCII art in it, you have reached the conclusion of the unraveling. Submit that file (by the appropriate name), along with the **pbx1steps** file.

To successfully complete this project, the following criteria must be met:

  * Submit your **pbx1.results**
  * Submit your **pbx1steps** file

To submit this program to me using the **submit** tool, run the following command at your lab46 prompt:

<cli>
$ submit unix pbx1 pbx1.results pbx1steps
Submitting unix project "pbx1":
    -> pbx1.results(OK)
    -> pbx1steps(OK)

SUCCESSFULLY SUBMITTED
</cli>

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:

<code>
52:pbx1:final tally of results (52/52)
*:pbx1:submitted pbx1.results file via submit tool [4/4]
*:pbx1:submitted pbx1steps file via submit tool [4/4]
*:pbx1:pbx1.results and pbx1steps pushed to lab46 repository [4/4]
*:pbx1:pbx1.results is correctly unscrambled and assembled [4/4]
*:pbx1:pbx1.results md5sum matches project MANIFEST [4/4]
*:pbx1:pbx1steps has valid list of non-interactive instructions [4/4]
*:pbx1:pbx1steps uses shell features like wildcards, IO redir [4/4]
*:pbx1:pbx1steps contains comments explaining process [4/4]
*:pbx1:pbx1steps sets up local project directories [4/4]
*:pbx1:pbx1steps copy data files with with absolute path [4/4]
*:pbx1:pbx1steps all other paths are relative [4/4]
*:pbx1:pbx1steps automates the project when executed [4/4]
*:pbx1:pbx1steps only outputs user-generated messages [4/4]
</code>