Differences

This shows you the differences between two versions of the page.

--- notes:discrete:fall2022:projects:bdb0 [2022/09/11 22:38] – [OUTPUT SPECIFICATIONS] abarbcal
+++ notes:discrete:fall2022:projects:bdb0 [2022/09/14 23:30] (current) – [PROGRAM] zswartwo
@@ Line 19: / Line 19: @@
 *Our task is to ask questions on Discord or in class and document our findings on this wiki page collaboratively, regarding the functionality of this project.
+**WIKI EDGE PAGE**
 *For anybody interested in editing the wiki page, here is the dokuwiki user guide: https://www.dokuwiki.org/wiki:syntax#basic_text_formatting -Ash
 =====PROGRAM=====
+When checking to verify that one's project functions as intended, it should be borne in mind that the verify program included in the grabit does not work, so it will ultimately be up to you to check the program. Ways this may be done include using the diff and xxd commands, and testing your project with with the files included in the in sub-directory. I myself found it useful to custom-create a few files in order to ensure certain edge cases occurred, such that they may be tested for (bear in mind this project is a debugger to assist us in future projects, so leaving flaws is likely sub-optimal).
 =====OUTPUT SPECIFICATIONS=====
 This is an example of the output of the program:
+<cli>
+lab46:~/src/SEMESTER/DESIG/PROJECT$ ./bdb0 example0 example1
+==============================================================================================================
+|000000e0 | 5325 2525 2525 2574 2525 7474 2574 7474   ||   5325 2525 2525 2574 2525 7474 2574 7474 | 000000e0|
+|000000f0 | 5252 5252 5252 5245 4545 4545 4545 4545   ||   5525 1b5b 303b 353b 3337 3b34 366d 401b | 000000f0|
+|00000100 | 5b30 3b31 3b33 363b 3437 6d53 1b5b 303b   ||   5b30 3b31 3b33 363b 3437 6d53 1b5b 303b | 00000100|
+==============================================================================================================
+</cli>
 {{ :notes:discrete:fall2022:projects:bdb0.jpg?nolink |}}
@@ Line 32: / Line 41: @@
 The middle line, called mismatch, is the focus of the program, and it should be displayed in a different color with the use of ANSI escape codes.
-The program is to display 16 bytes prior to, 16 bytes of, and 16 bytes after the first byte of difference detected in the two files. If either the 16 bytes prior or 16 bytes after the mismatch are not data from the file, in other words, you've reached the end of the file and there is no more data to display, you may display it with a NULL character (0x00, '\n').
+The program is to display 16 bytes prior to, 16 bytes of, and 16 bytes after the first byte of difference detected in the two files. If either the 16 bytes prior or 16 bytes after the mismatch are not data from the file, in other words, you've reached the end of the file and there is no more data to display, you may display it with a NULL character (0x00, '\n'). You can display it with other characters, should you prefer dots, dashes, or other characters that could represent the end of the file. However, make sure these cannot be possible reoccurrences elsewhere in the file.
 Example:
 {{ :notes:discrete:fall2022:projects:ouput.jpg?nolink |}}
+//In this example you see a mismatch happening right on the very first bytes of the file. Since there is no previous data to fetch, this lack of data is then displayed as NULL.//
 The **address** portion is a line count in hexadecimal format.
@@ Line 44: / Line 54: @@
 Your program should only print the **FIRST** mismatch, __**NOT**__ the entire document neither every mismatched line of bytes. JUST THE FIRST ONE along the previous and next bytes.
+Also make sure that you deal with edge cases in your program. Your file should be able to handle mismatches at the very start of the compared files and the very end of the compared files.
@@ Line 51: / Line 62: @@
 When running the program with two SAME files, the program should display nothing.
+The normal process of using **make check** to check your file against the desired result won't work in this case. The verify file is that of a different year when different specifications were desired. Running it this time around will lead you to many mismatches and headaches. You can check your output against the pictures provided above as a general guideline but other than that it is essential that if you have any questions to just ask in discord instead of guessing and hoping it is what is desired. Most of the desired output is already located on the project page.
+=====Approaches=====
+I think there are two approaches people have taken with the display of information with this project:
+\\
+{{:notes:discrete:fall2022:projects:screen_shot_2022-09-13_at_6.45.45_pm.png?800|}}
+\\
+===or===
+\\
+{{:notes:discrete:fall2022:projects:screenshot_2022-09-13_185444.png?800|}}
+\\
+The main thing of note here is the position of the first mismatched bit in its line. In the first implementation, bytes are displayed chronologically, with the leftmost bit always being a multiple of 16. The second implementation has the mismatched bit always in the leftmost position and never in the middle of a line. The approach you take comes down to personal preference as is with a lot of this project, since we don't have a strict verify script to check output with.

Lab46 Wiki

User Tools

Site Tools

Differences

Page Tools