42_INT_07_minishell

global features :
- prompt show a prompt
- history use history with arrows
- binaries fetch and launch the right executable
- ' " ; \ don't interpret special characters and unclosed quotes
pipes : video on pipes
- | pipes
expensions :
- $ variable expension
- $? exit return of last executed process meaning-of $?
quotes : quotes in bash
- ' (ignore any special characters)
- " (ignore any special characters except '$')
redirections & heredocs : redirections / heredocs
- < redirect input
- > redirect output
- << read input until empty line --
- >> redirect and append
signals :
- ^C close process
- ^D exit minishell
- ^\ do nothing
builtins : (can't be executed in child process)
- cd <relative path>
- cd <absolute path>
- pwd
- export
- unset
- exit
builtins : (but they don't need to be)
- env
- echo
- echo -n

allowed external functions :

(extracts of manuals) readline :

readline : char *readline (const char *prompt); will read a line from the terminal and return it, using prompt as a prompt
rl_clear_history : void rl_clear_history (void) clear the history list by deleting all of the entries, in the same manner as the History library's clear_history() function
rl_on_new_line : int rl_on_new_line (void) tell the update functions that we have moved onto a new (empty) line, usually after outputting a newline
rl_replace_line : void rl_replace_line (const char *text, int clear_undo) replace the contents of rl_line_buffer with text. The point and mark are preserved, if possible. If clear_undo is non-zero, the undo list associated with the current line is cleared
rl_redisplay : void rl_redisplay (void) change what's displayed on the screen to reflect the current contents of rl_line_buffer
add_history : bool readline_add_history (string $prompt) save the line away in a history list of such lines files :
access : int access(const char *pathname, int mode); checks whether the calling process can access the file pathname
open : int open(const char *pathname, int flags, [mode_t mode]); system call opens the file specified by pathname
read : ssize_t read(int fd, void *buf, size_t count); attempts to read up to count bytes from file descriptor fd into the buffer starting at buf
close : int close(int fd); closes a file descriptor, so that it no longer refers to any file and may be reused
dup : int dup(int oldfd); creates a copy of the file descriptor oldfd, using the lowest-numbered unused file descriptor for the new descriptor
dup2 : int dup2(int oldfd, int newfd); performs the same task as dup(), but instead of using the lowest-numbered unused file descriptor, it uses the file descriptor number specified in newfd
pipe : int pipe(int pipefd[2]); creates a pipe, a unidirectional data channel that can be used for interprocess communication. The array pipefd is used to return two file descriptors referring to the ends of the pipe. pipefd[0] refers to the read end of the pipe. pipefd[1] refers to the write end of the pipe
stat : int stat(const char *pathname, struct stat *statbuf); returns information about a file, in the buffer pointed to by statbuf
lstat : int fstat(int fd, struct stat *statbuf); lstat() is identical to stat(), except that if pathname is a symbolic link, then it returns information about the link itself, not the file that it refers to
fstat : int lstat(const char *pathname, struct stat *statbuf); fstat() is identical to stat(), except that the file about which information is to be retrieved is specified by the file descriptor fd
unlink : int unlink(const char *pathname); unlink() deletes a name from the filesystem process :
fork : pid_t fork(void); creates a new process by duplicating the calling process. The new process is referred to as the child process. The calling process is referred to as the parent process
wait : pid_t wait(int *wstatus); suspends execution of the calling process until one of its children terminates. The call wait(&wstatus) is equivalent to: waitpid(-1, &wstatus, 0);
waitpid : pid_t waitpid(pid_t pid, int *wstatus, int options); suspends execution of the calling process until a child specified by pid argument has changed state
wait3 : pid_t wait3(int *wstatus, int options, struct rusage *rusage); obsolete; use waitpid(2). similar to waitpid(2), but additionally return resource usage information about the child in the structure pointed to by rusage
wait4 : pid_t wait4(pid_t pid, int *wstatus, int options, struct rusage *rusage); like wait3() but additionally can be used to select a specific child
exit : void exit(int status); causes normal process termination and the value of status & 0377 is returned to the parent (see wait()) signals :
signal : sighandler_t signal(int signum, sighandler_t handler(int)); sets the disposition of the signal signum to handler, which is either SIG_IGN, SIG_DFL, or the address of a programmer-defined function (a "signal handler")
sigaction : int sigaction(int signum, const struct sigaction *act, struct sigaction *oldact); change the action taken by a process on receipt of a specific signal.
kill : int kill(pid_t pid, int sig); send any signal to any process group or process directories :
getcwd : char *getcwd(char *buf, size_t size); returns a null-terminated string containing an absolute pathname that is the current working directory of the calling process
chdir : int chdir(const char *path); changes the current working directory of the calling process to the directory specified in path
execve : int execve(const char *filename, char *const argv[], char *const envp[]); executes the program pointed to by filename
opendir : DIR *opendir(const char *name); opens a directory stream corresponding to the directory name, and returns a pointer to the directory stream
readdir : struct dirent *readdir(DIR *dirp); returns a pointer to a dirent structure representing the next directory entry in the directory stream pointed to by dirp
closedir : int closedir(DIR *dirp); closes the directory stream associated with dirp errors :
strerror : char *strerror(int errnum); returns a pointer to a string that describes the error code passed in the argument errnum
perror : void perror(const char *s); produces a message on standard error describing the last error encountered during a call to a system or library function termcap : The termcap data base describes the capabilities of hundreds of different display terminals in great detail The termcap library is provided for easy access this data base in programs that want to do terminal-independent character-based display output
tgetent : int tgetent (char *buffer, char *termtype); finds the description of the terminal type and remembers it internally so that you can interrogate it about specific terminal capabilities

Each piece of information recorded in a terminal description is called a capability There are three functions to use to get the value of a capability :

tgetflag : int tgetflag (char *name); get a boolean value
tgetnum : int tgetnum (char *name); get a capability value that is numeric
tgetstr : char *tgetstr (char *name, char **area); get a string value two more functions :
tgoto : char *tgoto (char *cstring, int hpos, int vpos) encoding numeric parameters such as cursor positions into the terminal-specific form required for display commands
tputs : int tputs (char *string, int nlines, int (*outfun) ()); output a string containing an optional padding spec

other :

printf : int printf(const char *format, ...); produce output to stdout according to a specified format
malloc : void *malloc(size_t size); allocates size bytes and returns a pointer to the allocated memory. The memory is not initialized
free : void free(void *ptr); frees the memory space pointed to by ptr, which must have been returned by a previous call to malloc()
write : ssize_t write(int fd, const void *buf, size_t count); writes up to bytes from the buffer starting at to the file referred to by the file descriptor
isatty : int isatty(int fd); tests whether fd is an open file descriptor referring to a terminal
ttyname : char *ttyname(int fd); returns a pointer to the null-terminated pathname of the terminal device that is open on the file descriptor fd, or NULL on error (for example, if fd is not connected to a terminal)
ttyslot : int ttyslot(void); returns the index of the current user's entry in some file
ioctl : int ioctl(int fd, unsigned long request, ...); manipulates the underlying device parameters of special files. In particular, many operating characteristics of character special files (e.g., terminals) may be controlled with ioctl() requests. The argument fd must be an open file descriptor
getenv : char *getenv(const char *name); searches the environment list to find the environment variable name, and returns a pointer to the corresponding value string, or NULL if not found
tcsetattr : int tcsetattr(int fd, int optional_actions, const struct termios *termios_p); tcsetattr() only works in an environment where either a controlling terminal exists, or stdin and stderr refer to tty devices. Specifically, it does not work in a TSO environment. Changes the attributes associated with a terminal. New attributes are specified with a termios control structure. Programs should always issue a tcgetattr() first, modify the desired fields, and then issue a tcsetattr(). tcsetattr() should never be issued using a termios structure that was not obtained using tcgetattr(). tcsetattr() should use only a termios structure that was obtained by tcgetattr()
tcgetattr : int tcgetattr(int fildes, struct termios *termptr); Gets a termios structure, which contains control information for a terminal associated with fildes. It stores that information in a memory location that termptr points to. The contents of a termios structure are described in tcsetattr()

README.md

1. todo list :

allowed external functions :

other :

ressources :