Documentation and testing enhancement for RustPosix

[yashaswi2000]

Description

With the goal of improving the documentation of all the supported System calls inside RustPOSIX and create a more comprehensive test suite that helps us catch bugs early on and maintain a consistent behaviour in line with the Linux POSIX Standard.

The below list tracks the progress across the syscalls

• ⬜️ - yet to start
• 🚧 - Work in Progress
• ✅ - Completed and Merged

Task Checklist

Task	Assignee	Completed	Pull Request
FS Calls
open_syscall	@namanlalitnyu	✅	[#264]
mkdir_syscall	@namanlalitnyu	✅	[#255]
mknod_syscall	@namanlalitnyu	✅	[#274]
link_syscall	@namanlalitnyu	✅	[#284]
unlink_syscall	@namanlalitnyu	✅	[#284]
creat_syscall	@namanlalitnyu	✅	[#287]
read_syscall	@namanlalitnyu	✅	[#293]
pread_syscall	@namanlalitnyu	✅	[#293]
write_syscall	@namanlalitnyu	✅	[#304]
pwrite_syscall	@namanlalitnyu	✅	[#304]
lseek_syscall	@namanlalitnyu	✅	[#311]
close_syscall	@namanlalitnyu	✅	[#311]
writev_syscall	@rupeshkoushik07	🚧
dup_syscall	@rupeshkoushik07	✅	[#285]
dup2_syscall	@rupeshkoushik07	✅	[#285]
getdents_syscall	@rupeshkoushik07	✅	[#286]
ffcntl_syscall	@ve1nard	✅	[#259]
ioctl_syscall	@ve1nard	✅	[#265]
chmod_syscall	@ve1nard	✅	[#275]
fchmod_syscall	@ve1nard	✅	[#275]
getcwd_syscall	@ve1nard	✅	[#280]
fchdir_syscall	@ve1nard	✅	[#294]
chdir_syscall	@ve1nard	✅	[#294]
rmdir_syscall	@ve1nard	✅	[#289]
mmap_syscall	@ve1nard	✅	[#300]
munmap_syscall	@ve1nard	✅	[#300]
pipe_syscall	@rennergade	✅	[#279]
stat_syscall	@pranav-bhatt	✅	[#301]
fstat_syscall	@pranav-bhatt	✅	[#301]
statfs_syscall	@pranav-bhatt	✅	[#316]
fstatfs_syscall	@pranav-bhatt	✅	[#316]
access_syscall	@pranav-bhatt	🚧
rename_syscall	@pranav-bhatt	🚧
fsync_syscall		⬜️
fdatasync_syscall		⬜️
sync_file_range_syscall		⬜️
ftruncate_syscall		⬜️
truncate_syscall		⬜️
shmget_syscall	@Anway-Agte	⬜️
shmat_syscall	@Anway-Agte	⬜️
shmdt_syscall	@Anway-Agte	⬜️
shmctl_syscall	@Anway-Agte	⬜️
Sys Calls
unmap_shm_mappings	@Anway-Agte	⬜️
fork_syscall	@Anway-Agte	🚧	[#281]
exec_syscall	@Anway-Agte	⬜️
exit_syscall	@Anway-Agte	⬜️
getpid_syscall	@Anway-Agte	✅	[#270]
getppid_syscall	@Anway-Agte	✅	[#270]
getgid_syscall	@Anway-Agte	✅	[#270]
getegid_syscall	@Anway-Agte	✅	[#270]
Net Calls
bind_syscall	@davidge20	✅	[#262]
connect_syscall	@davidge20	✅	[#277]
accept_syscall	@davidge20	✅	[#292]
sendto_syscall	@davidge20	✅	[#314]
send_syscall	@davidge20	✅	[#314]
revcfrom_syscall	@davidge20	✅	[#314]
recv_syscall	@davidge20	✅	[#314]
listen_syscall	@davidge20	✅	[#298]
socketpair_syscall	@qianxichen233	✅	[#256]
select_syscall	@qianxichen233	✅	[#271]
getsockopt_syscall	@qianxichen233	✅	[#315]
setsockopt_syscall	@qianxichen233	✅	[#315]
getpeername_syscall	@qianxichen233	✅	[#307]
getsockname_syscall	@qianxichen233	✅	[#307]
gethostname_syscall	@qianxichen233	✅	[#307]
poll_syscall	@qianxichen233	✅	[#296]
epoll_create_syscall	@qianxichen233	✅	[#297]
epoll_ctl_syscall	@qianxichen233	✅	[#297]
epoll_wait_syscall	@qianxichen233	✅	[#297]
netshutdown_syscall	@qianxichen233	✅	[#313]

[rennergade]

As discussed over the last few days I switched the accept and net shutdown syscalls for @davidge20 and @qianxichen233 as well as transferring the shared memory functions to @Anway-Agte