Description
Purpose: Become more familiar with operating system interaction, file input/output operations, and file I/O buffering. Points: 250 (grading will include functionality, documentation, and coding style) Assignment: Write an assembly language program that will read a file, add lines numbers in ASCII/Base-13 format, and write the new line (line number with the original line) to another file. The program should read both file names from the command line. The program should allow the arguments to be entered in either order (input file or output file first). The program must perform error checking. If no command line input was entered, invalid or incorrect file names were entered, or no file matching the specification was found an appropriate error message should be generated and the program terminated. An example command line is: ed-vm% ./addlines -i file.txt -o nfile.txt The line numbers must be BASE13_STR_LEN characters long which includes the base-13 string with leading 0’s, terminated in a colon “:” followed by one space. For example, if the original file line was “Hello World”, the new line to be written into the new file would be “00000001: Hello World”. To ensure efficiency, the program must perform buffered input. The buffer size should be set to BUFFSIZE which is declared as a constant. Note, the buffer size will be changed in the next assignment, so all code should reference the buffer size constant (not hard code the number). The provided main program calls the following routines: ● A value returning function, getFileDescriptors(), that reads and checks the command line arguments. The command line arguments must be in the format of: -i -o in either order. To check the file name, attempt to open the file. If the files open, the routine should return the file descriptors. If there is an error, an appropriate error message should be displayed (see examples). The function should return a boolean result (FALSE or TRUE). ● A value returning function, getLine(), that should return a single line of text. In order to perform this efficiently, the routine must perform input buffering. As necessary, data from the file should be read into a primary buffer (BUFFSIZE). If the line is longer than the passed maximum length, MAX_LINE_LEN (which includes the NULL), the over limit bolean should be set to TRUE and set to FALSE otherwise. If the line limit is reached, a line feed should be added to the line being return (MAX_LINE-LEN-2 characters, LF, and a NULL). The remaining characters must be read but not returned (and are thus lost). When the primary buffer is empty, the routine should fill the primary buffer by reading the file. The function must handle any unexpected read errors. The function should return FALSE if there are not more characters and TRUE otherwise. ● A void function, addLineNumber(), that will add the line number (in base-13). A new line will be created from the current line (max lenght is passed) and the ASCII/Base-13 line number (max length is passed). The integer to ASCII/base-13 conversion function, cvtint2B13(), will be called by this function. The integer and current line address are passed, and the maximum line length are passed to the cvtint2B13() function. The new line index must be updated by the passed maximum line length to skip over the line number in the new line. ● Void function cvtint2B13() to convert the passed integer into a base-13 string. This function will be called by the addLineNumber() function. The integer and the starting address of the string should be passed ● A value returning function, writeNewLine(), to write the new text line (with line number) to the output file. The function must handle any unexpected write errors by displaying a message (pre-defined). The function should return a boolean result (FALSE or TRUE). A main program and a functions template will be provided. All functions must be in a separate source file, a11procs.asm, that is independently assembled. Only the functions file, not the provided main, will be submitted on-line. As such, you must not change the provided main! You may use static variables as needed (no requirement to create stack-dynamic locals). Submission: • All source files must assemble and execute on Ubuntu and assemble with yasm. • Submit source files ◦ Submit a copy of the program source file via the on-line submission. ◦ Note, only the functions file (a11procs.asm) will be submitted. • Once you submit, the system will score the project and provide feedback. ◦ If you do not get full score, you can (and should) correct and resubmit. ◦ You can re-submit an unlimited number of times before the due date/time. • Late submissions will be accepted for a period of 24 hours after the due date/time for any given lab. Late submissions will be subject to a ~2% reduction in points per an hour late. If you submit 1 minute – 1 hour late -2%, 1-2 hours late -4%, … , 23-24 hours late -50%. This means after 24 hours late submissions will receive an automatic 0. Program Header Block All source files must include your name, section number, assignment, NSHE number, and program description. The required format is as follows: ; Name: ; NSHE ID: ; Section:
