Subject

Minishell

As beautiful as a shell

　쉘만큼이나 아름다운 그것

Summary: This project is about creating a simple shell. Yes, your own little bash. You will learn a lot about processes and file descriptors. Version: 6

　요약: 이번 프로젝트의 목표는 간단한 쉘을 만드는 것입니다. 맞아요, 당신만의 작은 bash. 프로세스 그리고 파일 디스크립터에 대해 아주 많이 배우게 될 겁니다. v6

Contents

Chapter	Contents	page
I	Introduction	2
II	Common Instructions	3
III	Mandatory part	4
IV	Bonus part	6

Chapter 1

Introduction

The existence of shells is linked to the very existence of IT. At the time, all coders agreed that communicating with a computer using aligned 1/0 switches was seriously irritating. It was only logical that they came up with the idea of creating a software to communicate with a computer using interactive lines of commands in a language somewhat close to the human language.

　쉘은 IT의 태초부터 함께했습니다. 그 당시, 모든 개발자들은 1과 0으로만 이루어진 스위치로 컴퓨터와 통신하는 것은 굉장히 성가시다는 점에 동의했어요. 그들이 인간의 언어에 어느 정도 가까운 언어로 된 대화형 명령 라인을 사용하여 컴퓨터와 통신하는 소프트웨어를 만드는 아이디어를 내놓은 것은 당연한 수순이었습니다.

Thanks to Minishell, you’ll be able to travel through time and come back to problems people faced when Windows didn’t exist.

　Minishell덕분에, Windows가 존재하지 않았을 시절 사람들이 겪었던 문제를 마주해볼 수 있습니다.

Chapter 2

Common Instructions

• Your project must be written in C.
  
  　프로젝트는 반드시 C로 작성되어야 합니다.

• Your project must be written in accordance with the Norm. If you have bonus files/functions, they are included in the norm check and you will receive a 0 if there is a norm error inside.
  
  　프로젝트는 Norm을 준수하여 작성되어야 합니다. 만일 보너스 파일이나 함수가 있는경우, 이 또한 norm 검사에 포함되며 norm error가 있는 경우 0점을 받게 된다.

• Your functions should not quit unexpectedly (segmentation fault, bus error, double free, etc) apart from undefined behaviors. If this happens, your project will be considered non functional and will receive a 0 during the evaluation.
  
  　정의되지 않은 행동(undefined behaviors)을 제외하고 함수는 예상치 못하게 종료되면 안된다.(segmentation fault, bus error, double free, etc) 이 경우 프로젝트가 작동하지 않는 것으로 간주하며 평가 중에 0점을 받게 된다.

• All heap allocated memory space must be properly freed when necessary. No leaks will be tolerated.
  
  　필요한 경우 heap에 할당된 메모리 공간을 적절하게 해제해야 합니다. 메모리 누수는 허용되지 않습니다.

• If the subject requires it, you must submit a Makefile which will compile your source files to the required output with the flags -Wall, -Wextra and -Werror, use cc, and your Makefile must not relink.
  
  　과제에서 필요한 경우, 결과물을 만들기 위해 소스 파일을 -Wall -Wextra -Werror 플래그와 cc를 사용하여 컴파일할 Makefile을 제출 해야하고 이는 리링크가 되면 안됩니다.

• Your Makefile must at least contain the rules $(NAME), all, clean, fclean and re.
  
  　Makefile은 최소한 $(NAME), all, clean, fclean, re 규칙을 포함해야 합니다.

• To turn in bonuses to your project, you must include a rule bonus to your Makefile, which will add all the various headers, librairies or functions that are forbidden on the main part of the project. Bonuses must be in a different file _bonus.{c/h} if the subject does not specify anything else. Mandatory and bonus part evaluation is done separately.
  
  　프로젝트에 보너스를 제출하려면 Makefile에 bonus 규칙을 포함해야 합니다. bonus에서는 프로젝트의 mandatory part에서 금지된 모든 다양한 헤더, 라이브러리 또는 함수를 추가합니다. 과제에서 특별하게 다른 항목을 지정하지 않은 경우 bonus는 _bonus.{c/h}로 끝나는 다른 파일에 있어야합니다. Mandatory와 bonus part 평가는 별도로 수행됩니다.

• If your project allows you to use your libft, you must copy its sources and its associated Makefile in a libft folder with its associated Makefile. Your project’s Makefile must compile the library by using its Makefile, then compile the project.
  
  　만약 프로젝트가 libft의 사용을 허용한다면, libft의 소스파일과 Makefile을 libft 폴더 안에 복사해야 합니다. 프로젝트의 Makefile은 libft의 Makefile을 사용하여 라이브러리를 컴파일 한 다음에 프로젝트를 컴파일해야 합니다.

• We encourage you to create test programs for your project even though this work won’t have to be submitted and won’t be graded. It will give you a chance to easily test your work and your peers’ work. You will find those tests especially useful during your defence. Indeed, during defence, you are free to use your tests and/or the tests of the peer you are evaluating.
  
  　이 프로젝트를 제출할 필요가 없고 점수가 매겨지지 않더라도 프로젝트를 위한 테스트 프로그램을 만들어 볼 것을 권장합니다. 이는 여러분의 결과물과 동료들의 결과물을 쉽게 테스트할 수 있는 기회를 줄 것입니다. 여러분은 이 테스트들이 디펜스 중에 특히 유용하다는 것을 알게 될 것 입니다. 실제로, 디펜스를 하는 동안 여러분이나 평가 중인 동료의 테스트를 자유롭게 사용할 수 있습니다.

• Submit your work to your assigned git repository. Only the work in the git repository will be graded. If Deepthought is assigned to grade your work, it will be done after your peer-evaluations. If an error happens in any section of your work during Deepthought’s grading, the evaluation will stop.
  
  　할당된 Git 저장소에 결과물을 제출합니다. Git 저장소에 있는 결과물만 채점됩니다. 만약 Deepthought가 여러분의 작업을 채점하도록 지정된다면, 이는 동료평가 종료 후에 이뤄질 것입니다. Deepthought가 채점하는 동안 오류가 발생하면 평가가 종료됩니다.

Chapter 3

Mandatory part

프로그램 이름	minishell
제출할 파일	Makefile, *.h, *.c
Makefile	NAME, all, clean, fclean, re
인자
사용가능한   외부 함수	readline, rl_clear_history, rl_on_new_line, rl_replace_line, rl_redisplay, add_history, printf, malloc, free, write, access, open, read, close, fork, wait, waitpid, wait3, wait4, signal, sigaction, sigemptyset, sigaddset, kill, exit, getcwd, chdir, stat, lstat, fstat, unlink, execve, dup, dup2, pipe, opendir, readdir, closedir, strerror, perror, isatty, ttyname, ttyslot, ioctl, getenv, tcsetattr, tcgetattr, tgetent, tgetflag, tgetnum, tgetstr, tgoto, tputs
직접 만든 libft	사용 가능
설명	쉘을 작성하세요

Your shell should:

당신의 쉘은:

• Display a prompt when waiting for a new command.

  새 명령을 기다릴 때 프롬프트를 표시해야 합니다.

• Have a working history.

  작업 히스토리를 갖고 있어야 합니다.

• Search and launch the right executable (based on the PATH variable or using a relative or an absolute path).

  (PATH 변수나 상대, 절대 경로를 활용하여) 올바른 실행 파일을 찾아 실행할 수 있어야 합니다.

• Not use more than one global variable. Think about it. You will have to explain its purpose.

  최대 1개의 전역 변수를 사용해야 합니다. 왜 전역 변수를 사용했는지 생각해보고 그 목적을 설명할 수 있어야 합니다.

• Not interpret unclosed quotes or special characters which are not required by the subject such as \ (backslash) or ; (semicolon).

  닫히지 않은 따옴표나 (백슬래시) 나 ;(세미콜론)과 같이 과제에 필요하지 않은 특수문자를 해석하지 않아야 합니다.

• Handle ’ (single quote) which should prevent the shell from interpreting the metacharacters in the quoted sequence.

  쉘이 quoted sequence 안에 있는 metacharacters를 해석하지 못하도록 하는 ‘(single quote)를 처리해야 합니다.

• Handle " (double quote) which should prevent the shell from interpreting the metacharacters in the quoted sequence except for $ (dollar sign).

  쉘이 $(달러 기호)를 제외한 quoted sequence 안에 있는 metacharacters를 해석하지 못하도록 하는 “(double quote)를 처리해야 합니다.

• Implement redirections:
  
  　리다이렉션 구현

  • < should redirect input.
    
    　 < 는 입력을 리다이렉트 해야 합니다.

  • > should redirect output.
    
    　 > 는 출력을 리다이렉트 해야 합니다.

  • << should be given a delimiter, then read the input until a line containing the delimiter is seen. However, it doesn’t have to update the history!
    
    　 << 는 delimiter를 지정한 다음 delimiter를 포함한 줄을 만나기 전까지 입력값을 읽습니다. 그러나, 히스토리를 업데이트 할 필요는 없습니다.

  • >> should redirect output in append mode.
    
    　 >> 는 append mode로 출력을 리다이렉트 합니다.

• Implement pipes (| character). The output of each command in the pipeline is connected to the input of the next command via a pipe.

　파이프 (| 문자) 구현 각 파이프라인마다 명령어의 출력은 파이프를 통해 다음 명령어의 입력으로 들어가야 합니다.

• Handle environment variables ($ followed by a sequence of characters) which should expand to their values.

　 환경 변수($ 뒤에 일련의 문자열이 오는 형식)이 그들의 값으로 확장될 수 있도록 처리해야 합니다.

• Handle $? which should expand to the exit status of the most recently executed foreground pipeline.

　 $?는 가장 최근에 실행한 foreground 파이프라인의 종료 상태를 확장하도록 처리해야 합니다.

• Handle ctrl-C, ctrl-D and ctrl-\ which should behave like in bash.

　 ctrl-C, ctrl-D, ctrl-\는 bash처럼 동작하도록 처리해야 합니다.

• In interactive mode:

　대화형 모드에서:

• ctrl-C displays a new prompt on a new line.
  
  　 ctrl-C는 새로운 줄에 새로운 프롬프트를 표시해야 합니다.

• ctrl-D exits the shell.
  
  　 ctrl-D는 쉘을 종료합니다.

• ctrl-\ does nothing.
  
  　 ctrl-\은 아무런 동작도 하지 않습니다.

• Your shell must implement the following builtins:
  
  　여러분의 쉘은 다음 내장 기능을 구현해야 합니다.

  • echo with option -n
    
    　-n 옵션을 사용할 수 있는 echo

  • cd with only a relative or absolute path
    
    　오직 상대 또는 절대경로만 사용하는 cd

  • pwd with no options
    
    　옵션이 없는 pwd

  • export with no options
    
    　옵션이 없는 export

  • unset with no options
    
    　옵션이 없는 unset

  • env with no options or arguments
    
    　옵션이나 인자값이 없는 env

  • exit with no options
    
    　옵션이 없는 exit

  The readline() function can cause memory leaks. You don’t have to fix them. But that doesn’t mean your own code, yes the code you wrote, can have memory leaks.

readline() 함수로 인해 메모리 누수가 발생할 수 있지만 이것을 고칠 필요는 없습니다. 하지만 이것이 여러분이 작성한 코드가 메모리 누수가 있어도 된다는 것은 아닙니다.

ℹ️ You should limit yourself to the subject description. Anything that is not asked is not required. If you have any doubt about a requirement, take bash as a reference.

과제에서 요구한 설명에 여러분을 제한해야 합니다. 요구하지 않은 것은 필요하지 않습니다. 요구사항에 대해 의문점이 생긴다면 [bash] 를 참고하세요.

Chapter 4

Bonus part

Your program has to implement:

여러분의 프로그램은 다음을 구현해야 합니다:

• && and || with parenthesis for priorities.

  　괄호를 이용해 우선순위를 표현한 &&, ||

• Wildcards * should work for the current working directory.

  　와일드카드 *가 현재 작업 디렉토리에 대해 동작하여야 합니다.

🚫 The bonus part will only be assessed if the mandatory part is PERFECT. Perfect means the mandatory part has been integrally done and works without malfunctioning. If you have not passed ALL the mandatory requirements, your bonus part will not be evaluated at all.

bonus part는 mandatory part가 완벽한 경우에만 평가됩니다. 완벽하다는 것은 mandatory part가 오류 없이 완전하게 작동하는 것을 의미합니다. mandatory part의 요구사항을 모두 통과하지 못했다면, bonus part는 전혀 평가되지 않습니다.

Chapter V

Submission and peer-evaluation

Turn in your assignment in your Git repository as usual. Only the work inside your repository will be evaluated during the defense. Don’t hesitate to double check the names of your files to ensure they are correct.

평소처럼 Git 저장소에 과제를 제출하세요. 디펜스 중에는 저장소 내부의 작업물만 평가됩니다. 다시 검사하는 것을 망설이지 말고 파일 이름이 올바른지 확인하세요.