Sys.pm untested

filter: Statementstmt 0.0% 0 / 1 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub n/a Podpod n/a totaltotal 0.0% 0 / 1 SCAR -
1 package SPVM::Sys;
2  
3 our $VERSION = "0.586";
4  
5 1;
6  
7 =head1 Name
8  
9 SPVM::Sys - System Calls for File IO, Sockets, Time, Process, Signals, Users
10  
11 =head1 Description
12  
13 Sys class in L<SPVM> performs system calls for file IO, sockets, user manipulation, process manipulation, and time.
14  
15 =head1 Usage
16  
17 use Sys;
18
19 my $fd_ref = [(Sys::IO::FileStream)undef];
20 my $file = "a.txt";
21 Sys->open($fd_ref, "<", $file);
22
23 Sys->mkdir("foo");
24
25 Sys->rmdir("foo");
26
27 my $env_path = Sys->env("PATH");
28
29 my $process_id = Sys->process_id;
30  
31 =head1 Details
32  
33 =head2 Windows Unicode Support
34  
35 Windows internally manages filenames using UTF-16LE encoding. In contrast, SPVM interprets strings as raw byte sequences, expecting them to be UTF-8. To bridge this difference, all methods have been implemented to perform this conversion automatically.
36  
37 =head1 Class Methods
38  
39 =head2 STDIN
40  
41 C<static method STDIN : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream> ();>
42  
43 Returns L<stdin|SPVM::Document::NativeAPI/"spvm_stdin"> opened by the SPVM language.
44  
45 =head2 STDOUT
46  
47 C<static method STDOUT : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream> ();>
48  
49 Returns L<stdout|SPVM::Document::NativeAPI/"spvm_stdout"> opened by the SPVM language.
50  
51 =head2 STDERR
52  
53 C<static method STDERR : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream> ();>
54  
55 Returns L<stderr|SPVM::Document::NativeAPI/"spvm_stderr"> opened by the SPVM language.
56  
57 =head2 open
58  
59 C<static method open : void ($stream_ref : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>[], $open_mode : string, $file : string);>
60  
61 Opens a file given the open mode $open_mode and the file name $file.
62  
63 The opened file stream is set to $stream_ref at index 0.
64  
65 The open mode $open_mode is replaced to a representation of L<fopen|https://linux.die.net/man/3/fopen> function before calling L<fopen|https://linux.die.net/man/3/fopen> function.
66  
67 [$open_mode] [The mode of the fopen function]
68 < rb
69 > wb
70 >> wa
71 +< r+b
72 +> w+b
73 +>> a+b
74  
75 If the system supports C<FD_CLOEXEC>, this flag is set to the opened file descriptor using L</"fcntl">.
76  
77 Exceptions:
78  
79 $stream_ref must be defined. Otherwise an exception is thrown.
80  
81 The length of $stream_ref must be equal to 1. Otherwise an exception is thrown.
82  
83 Exceptions thrown by L<Sys::IO#fopen|SPVM::Sys::IO/"fopen"> method could be thrown.
84  
85 =head2 fdopen
86  
87 C<static method fdopen : void ($stream_ref : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>[], $open_mode : string, $fd : int);>
88  
89 Same as L</"open"> method except that this method takes the file descriptor $fd instead of the file name .
90  
91 =head2 fileno
92  
93 C<static method fileno : int ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
94  
95 Return the file descriptor of the file stream $stream.
96  
97 This method calls L<Sys::IO#fileno|SPVM::Sys::IO/"fileno"> method.
98  
99 Exceptions:
100  
101 The file stream $stream must be defined. Otherwise an exception is thrown.
102  
103 If the file stream $stream is already closed, an exception is thrown.
104  
105 Exceptions thrown by L<Sys::IO#fileno|SPVM::Sys::IO/"fileno"> method could be thrown.
106  
107 =head2 read
108  
109 C<static method read : int ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>, $buffer : mutable string, $length : int, $buffer_offset : int = 0);>
110  
111 Reads data from the file stream $stream by the $length, and saves it to the buffer $buffer at offset $buffer_offset.
112  
113 This method calls L<Sys::IO#fread|SPVM::Sys::IO/"fread"> method.
114  
115 Exceptions:
116  
117 The file stream $stream must be defined. Otherwise an exception is thrown.
118  
119 If the file stream $stream is already closed, an exception is thrown.
120  
121 Exceptions thrown by L<Sys::IO#fread|SPVM::Sys::IO/"fread"> method could be thrown.
122  
123 =head2 eof
124  
125 C<static method eof : int ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
126  
127 Checks if the file stream $stream reasches the end of the file.
128  
129 If it does, returns 1, otherwise returns 0.
130  
131 This method calls L<Sys::IO#feof|SPVM::Sys::IO/"feof"> method.
132  
133 Exceptions:
134  
135 The file stream $stream must be defined. Otherwise an exception is thrown.
136  
137 If the file stream $stream is already closed, an exception is thrown.
138  
139 Exceptions thrown by L<Sys::IO#feof|SPVM::Sys::IO/"feof"> method could be thrown.
140  
141 =head2 readline
142  
143 C<static method readline : mutable string ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
144  
145 Reads a line from th file stream $stream and returns it.
146  
147 This method calls L<Sys::IO#feof|SPVM::Sys::IO/"readline"> method.
148  
149 Exceptions:
150  
151 The file stream $stream must be defined. Otherwise an exception is thrown.
152  
153 If the file stream $stream is already closed, an exception is thrown.
154  
155 Exceptions thrown by L</"getc"> method could be thrown.
156  
157 =head2 getc
158  
159 C<static method getc : int ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
160  
161 Gets a charactor from the file stream $stream and returns it.
162  
163 This method calls L<Sys::IO#getc|SPVM::Sys::IO/"getc"> method.
164  
165 Exceptions:
166  
167 The file stream $stream must be defined. Otherwise an exception is thrown.
168  
169 If the file stream $stream is already closed, an exception is thrown.
170  
171 Exceptions thrown by L<Sys::IO#getc|SPVM::Sys::IO/"getc"> method could be thrown.
172  
173 =head2 print
174  
175 C<static method print : void ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>, $string : string);>
176  
177 Prints the string $string to the file stream $stream.
178  
179 This method calls L<Sys::IO#fwrite|SPVM::Sys::IO/"fwrite"> method.
180  
181 Exceptions:
182  
183 The file stream $stream must be defined. Otherwise an exception is thrown.
184  
185 If the file stream $stream is already closed, an exception is thrown.
186  
187 Exceptions thrown by L<Sys::IO#fwrite|SPVM::Sys::IO/"fwrite"> method could be thrown.
188  
189 =head2 printf
190  
191 C<static method printf : void ($stream, $format : string, $args : object[])>
192  
193 Prints the format string $string given the arguments $args to the file stream $stream.
194  
195 Exceptions thrown by L<"print"> method class could be thrown.
196  
197 =head2 say
198  
199 C<static method say : void ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>, $string : string);>
200  
201 Prints the string $string and "\n" to the file stream $stream.
202  
203 Exceptions:
204  
205 Exceptions thrown by L<"print"> method class could be thrown.
206  
207 =head2 close
208  
209 C<static method close : void ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
210  
211 Closes the file stream $stream.
212  
213 This method calls L<Sys::IO#fclose|SPVM::Sys::IO/"fclose"> method.
214  
215 Exceptions:
216  
217 The file stream $stream must be defined. Otherwise an exception is thrown.
218  
219 If the file stream $stream is already closed, an exception is thrown.
220  
221 Exceptions thrown by L<Sys::IO#fclose|SPVM::Sys::IO/"fclose"> method could be thrown.
222  
223 =head2 seek
224  
225 C<static method seek : void ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>, $offset : long, $whence : int);>
226  
227 Moves the read/write position pointed to by the file stream $stream to the offset $offset given $whence.
228  
229 See L<Sys::IO::Constant|SPVM::Sys::IO::Constant> about constant values given to $whence.
230  
231 This method calls L<Sys::IO#fseek|SPVM::Sys::IO/"fseek"> method.
232  
233 Exceptions:
234  
235 The file stream $stream must be defined. Otherwise an exception is thrown.
236  
237 If the file stream $stream is already closed, an exception is thrown.
238  
239 Exceptions thrown by L<Sys::IO#fseek|SPVM::Sys::IO/"fseek"> method could be thrown.
240  
241 =head2 tell
242  
243 C<static method tell : long ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
244  
245 Returns the read/write position pointed to by the file stream $stream.
246  
247 This method calls L<Sys::IO#ftell|SPVM::Sys::IO/"ftell"> method.
248  
249 Exceptions:
250  
251 The file stream $stream must be defined. Otherwise an exception is thrown.
252  
253 If the file stream $stream is already closed, an exception is thrown.
254  
255 Exceptions thrown by L<Sys::IO#ftell|SPVM::Sys::IO/"ftell"> method could be thrown.
256  
257 =head2 sysopen
258  
259 C<static method sysopen : void ($fd_ref : int*, $file : string, $int_mode : int, $perms : int = -1);>
260  
261 Opens a file given, the file path $file, the integer open mode $int_mode and the permissions $perms.
262  
263 The file descriptor of the opened file is set to the value reffered by $fd_ref.
264  
265 If $perms is a negative value, it is set to C<0644 & ~Sys->umask>.
266  
267 See L<Sys::IO::Constant|SPVM::Sys::IO::Constant> about constant values given to the flags $int_mode and the mode $perms.
268  
269 If the system supports C<FD_CLOEXEC>, this flag is set to the opened file descriptor using L</"fcntl">.
270  
271 Exceptions:
272  
273 Exceptions thrown by L<Sys::IO#open|SPVM::Sys::IO/"open"> method could be thrown.
274  
275 =head2 sysread
276  
277 C<static method sysread : int ($fd : int, $buffer : mutable string, $length : int, $buffer_offset : int = 0);>
278  
279 Reads data from the file stream $stream by the $length, and saves it to the buffer $buffer from the offset $buffer_offset.
280  
281 Exceptions:
282  
283 Exceptions thrown by L<Sys::IO#read|SPVM::Sys::IO/"read"> method could be thrown.
284  
285 =head2 syswrite
286  
287 C<static method syswrite : int ($fd : int, $buffer : string, $length : int = -1, $buffer_offset : int = 0);>
288  
289 Writes data to the file stream $stream by the $length from the buffer $buffer at offset $buffer_offset.
290  
291 Exceptions:
292  
293 Exceptions thrown by L<Sys::IO#write|SPVM::Sys::IO/"write"> method could be thrown.
294  
295 =head2 sysread_pipe
296  
297 C<static method sysread_pipe : int ($fd : int, $buffer : mutable string, $length : int, $buffer_offset : int = 0);>
298  
299 Reads data from the pipe $fd by the $length, and saves it to the buffer $buffer from the offset $buffer_offset.
300  
301 Exceptions:
302  
303 Exceptions thrown by L<Sys::IO#read_pipe|SPVM::Sys::IO/"read_pipe"> method could be thrown.
304  
305 =head2 syswrite_pipe
306  
307 C<static method syswrite_pipe : int ($fd : int, $buffer : string, $length : int = -1, $buffer_offset : int = 0);>
308  
309 Writes data to the pipe $fd by the $length from the buffer $buffer at offset $buffer_offset.
310  
311 Exceptions:
312  
313 Exceptions thrown by L<Sys::IO#write_pipe|SPVM::Sys::IO/"write_pipe"> method could be thrown.
314  
315 =head2 sysseek
316  
317 C<static method sysseek : long ($fd : int, $offset : long, $whence : int);>
318  
319 Moves the read/write position pointed to by the file descriptor $fd to the offset $offset given $whence.
320  
321 See L<Sys::IO::Constant|SPVM::Sys::IO::Constant> about constant values given to $whence.
322  
323 Exceptions:
324  
325 Exceptions thrown by L<Sys::IO#lseek|SPVM::Sys::IO/"lseek"> method could be thrown.
326  
327 =head2 fcntl
328  
329 C<static method fcntl : int ($fd : int, $command : int, $command_arg : object of Int|SPVM::Sys::IO::Flock|object = undef);>
330  
331 Calls L<Sys::IO#fcntl|SPVM::Sys::IO/"fcntl"> method and its return value.
332  
333 Exceptions:
334  
335 Exceptions thrown by L<Sys::IO#fcntl|SPVM::Sys::IO/"fcntl"> method could be thrown.
336  
337 =head2 flock
338  
339 C<static method flock : void ($fd : int, $operation : int);>
340  
341 Locks the file specified by the file descriptor $fd given the operation $operation.
342  
343 See L<Sys::IO::Constant|SPVM::Sys::IO::Constant> about constant values given to the operation $operation.
344  
345 Exceptions:
346  
347 Exceptions thrown by L<Sys::IO#flock|SPVM::Sys::IO/"flock"> method could be thrown.
348  
349 =head2 mkdir
350  
351 C<static method mkdir : void ($dir : string, $mode : int = -1);>
352  
353 Creates the directory given the path $dir and the mode $mode.
354  
355 If $mode is less than 0, $mode is set to 0777.
356  
357 The permissions of the created directory are ($mode & ~L<umask|/"umask"> & 0777).
358  
359 In Windows, the mode $mode is ignored.
360  
361 Exceptions:
362  
363 Exceptions thrown by L<Sys::IO#mkdir|SPVM::Sys::IO/"mkdir"> method could be thrown.
364  
365 =head2 umask
366  
367 C<static method umask : int ($perms : int = -1);>
368  
369 Sets the umask for the process to the mode $perms and returns the previous value.
370  
371 If $perms is a negative value, this method returns the current umask permission without setting.
372  
373 Exceptions:
374  
375 Exceptions thrown by L<Sys::IO#umask|SPVM::Sys::IO/"umask"> method could be thrown.
376  
377 =head2 unlink
378  
379 C<static method unlink : void ($file : string);>
380  
381 Deletes a file.
382  
383 Exceptions:
384  
385 Exceptions thrown by L<Sys::IO#unlink|SPVM::Sys::IO/"unlink"> method could be thrown.
386  
387 =head2 rename
388  
389 C<static method rename : void ($old_path : string, $new_path : string);>
390  
391 Raname the file name from the old name $old_path to the new name $new_path.
392  
393 Exceptions:
394  
395 Exceptions thrown by L<Sys::IO#rename|SPVM::Sys::IO/"rename"> method could be thrown.
396  
397 =head2 rmdir
398  
399 C<static method rmdir : void ($dir : string);>
400  
401 Deletes the directory given the path $dir.
402  
403 Exceptions:
404  
405 Exceptions thrown by L<Sys::IO#rmdir|SPVM::Sys::IO/"rmdir"> method could be thrown.
406  
407 =head2 chdir
408  
409 C<static method chdir : void ($dir : string);>
410  
411 Changes the working directory to the path $dir.
412  
413 Exceptions:
414  
415 Exceptions thrown by L<Sys::IO#chdir|SPVM::Sys::IO/"chdir"> method could be thrown.
416  
417 =head2 chmod
418  
419 C<static method chmod : void ($mode :int, $file : string);>
420  
421 Changes the permissions of the file $file to the permission $mode.
422  
423 Exceptions:
424  
425 Exceptions thrown by L<Sys::IO#chmod|SPVM::Sys::IO/"chmod"> method could be thrown.
426  
427 =head2 chown
428  
429 C<static method chown : void ($owner : int, $group : int, $file : string);>
430  
431 Changes the owner and the group of the file $file to $owner and $group.
432  
433 Exceptions:
434  
435 Exceptions thrown by L<Sys::IO#chown|SPVM::Sys::IO/"chown"> method could be thrown.
436  
437 =head2 readlink
438  
439 C<static method readlink : int ($file : string);>
440  
441 Returns the content of the symbolic link file $file.
442  
443 Exceptions:
444  
445 Exceptions thrown by L<Sys::IO#readlink|SPVM::Sys::IO/"readlink"> method could be thrown.
446  
447 =head2 symlink
448  
449 C<static method symlink : int ($old_path : string, $new_path : string);>
450  
451 Creates a path $new_path symbolically linked to the path $old_path.
452  
453 Exceptions:
454  
455 Exceptions thrown by L<Sys::IO#symlink|SPVM::Sys::IO/"symlink"> method could be thrown.
456  
457 =head2 truncate
458  
459 C<static method truncate : void ($fd : int, $legnth : long);>
460  
461 Truncates the file referenced by the file descriptor $fd to a size of precisely length bytes $legnth.
462  
463 Exceptions:
464  
465 Exceptions thrown by L<Sys::IO#ftruncate|SPVM::Sys::IO/"ftruncate"> method could be thrown.
466  
467 =head2 opendir
468  
469 C<static method opendir : void ($dir_stream_ref : L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>[], $dir : string);>
470  
471 Opens the directory stream given the directory $dir.
472  
473 The opened directory stream is set to $dir_stream_ref at index 0.
474  
475 Exceptions:
476  
477 If the directory stream \$dir_stream is already closed, an exception is thrown.
478  
479 This method calls L<Sys::IO#opendir|SPVM::Sys::IO/"opendir"> method.
480  
481 Exceptions thrown by L<Sys::IO#opendir|SPVM::Sys::IO/"opendir"> method could be thrown.
482  
483 =head2 closedir
484  
485 C<static method closedir : void ($dir_stream : L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>);>
486  
487 Closes the directory stream given the directory stream $dir_stream.
488  
489 This method calls L<Sys::IO#closedir|SPVM::Sys::IO/"closedir"> method.
490  
491 Exceptions:
492  
493 If the directory stream \$dir_stream is already closed, an exception is thrown.
494  
495 Exceptions thrown by L<Sys::IO#closedir|SPVM::Sys::IO/"closedir"> method could be thrown.
496  
497 =head2 readdir
498  
499 C<static method readdir : string ($dir_stream : L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>);>
500  
501 Reads a directory entry from the dirctory stream $dir_stream. If it is defined, returns its file name; otherwise returns undef.
502  
503 Implementation:
504  
505 This method calls L<Sys::IO#readdir|SPVM::Sys::IO/"readdir"> method.
506  
507 Exceptions:
508  
509 If the directory stream \$dir_stream is already closed, an exception is thrown.
510  
511 Exceptions thrown by L<Sys::IO#readdir|SPVM::Sys::IO/"readdir"> method could be thrown.
512  
513 =head2 rewinddir
514  
515 C<static method rewinddir : void ($dir_stream : L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>);>
516  
517 Resets the position of the directory stream $dir_stream to the beginning of the directory.
518  
519 This method calls L<Sys::IO#rewinddir|SPVM::Sys::IO/"rewinddir"> method.
520  
521 Exceptions:
522  
523 If the directory stream \$dir_stream is already closed, an exception is thrown.
524  
525 Exceptions thrown by L<Sys::IO#rewinddir|SPVM::Sys::IO/"rewinddir"> method could be thrown.
526  
527 =head2 seekdir
528  
529 C<static method seekdir : void ($dir_stream : L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>, $offset : long);>
530  
531 Sets the current location associated with the directory stream $dir_stream to the offset $offset.
532  
533 This method calls L<Sys::IO#seekdir|SPVM::Sys::IO/"seekdir"> method.
534  
535 Exceptions:
536  
537 If the directory stream \$dir_stream is already closed, an exception is thrown.
538  
539 Exceptions thrown by L<Sys::IO#seekdir|SPVM::Sys::IO/"seekdir"> method could be thrown.
540  
541 =head2 telldir
542  
543 C<static method telldir : long ($dir_stream : L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>);>
544  
545 Returns the current location associated with the directory stream $dir_stream.
546  
547 This method calls L<Sys::IO#telldir|SPVM::Sys::IO/"telldir"> method.
548  
549 Exceptions:
550  
551 If the directory stream \$dir_stream is already closed, an exception is thrown.
552  
553 Exceptions thrown by L<Sys::IO#telldir|SPVM::Sys::IO/"telldir"> method could be thrown.
554  
555 =head2 popen
556  
557 C<static method popen : void ($stream_ref : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>[], $open_mode : string, $command : string);>
558  
559 Opens a file stream that joins a process by creating a pipe given the command $command and the open mode $open_mode.
560  
561 The opened file stream is set to $stream_ref at index 0.
562  
563 The open mode $open_mode is replaced to a representation of L<fopen|https://linux.die.net/man/3/fopen> function before calling L<fopen|https://linux.die.net/man/3/fopen> function.
564  
565 [$open_mode] [The mode of the fopen function]
566 |- wb
567 -| rb
568  
569 Exceptions:
570  
571 Exceptions thrown by L<Sys::IO#popen|SPVM::Sys::IO/"popen"> method or L<Sys::IO#_popen|SPVM::Sys::IO/"_popen"> method could be thrown.
572  
573 =head2 pclose
574  
575 C<static method pclose : void ($stream : L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>);>
576  
577 Closes the file stream $stream created by L</"popen"> method.
578  
579 This method calls L<Sys::IO#pclose|SPVM::Sys::IO/"pclose"> method or L<Sys::IO#_pclose|SPVM::Sys::IO/"_pclose">.
580  
581 Exceptions:
582  
583 The pipe stream $stream must be defined. Otherwise an exception is thrown.
584  
585 If the pipe stream $stream is already closed, an exception is thrown.
586  
587 Exceptions thrown by L<Sys::IO#pclose|SPVM::Sys::IO/"pclose"> method or L<Sys::IO#_pclose|SPVM::Sys::IO/"_pclose"> method could be thrown.
588  
589 =head2 select
590  
591 C<static method select : int ($read_fds : L<Sys::Select::Fd_set|SPVM::Sys::Select::Fd_set>, $write_fds : L<Sys::Select::Fd_set|SPVM::Sys::Select::Fd_set>, $except_fds : L<Sys::Select::Fd_set|SPVM::Sys::Select::Fd_set>, $timeout : double = 0);>
592  
593 Calls L<Sys::Select#select|SPVM::Sys::Select/"select"> method and returns its return value.
594  
595 If $timeout is greter than or equal to 0, it is converted to a L<Sys::Time::Timeval|SPVM::Sys::Time::Timeval> object. Otherwise is converted to undef.
596  
597 $nfds is set to 1024.
598  
599 Exceptions:
600  
601 Exceptions thrown by L<Sys::Select#select|SPVM::Sys::Select/"select"> method method could be thrown.
602  
603 =head2 ioctl
604  
605 C<static method ioctl : int ($fd : int, $request : int, $request_arg_ref : object of byte[]|short[]|int[]|long[]|float[]|double[]|object = undef);>
606  
607 Windows:
608  
609 Calls L<Sys::Ioctl#ioctlsocket|SPVM::Sys::Ioctl/"ioctlsocket"> method and returns its return value.
610  
611 OSs other than Windows:
612  
613 Calls L<Sys::Ioctl#ioctl|SPVM::Sys::Ioctl/"ioctl"> method and returns its return value.
614  
615 Exceptions:
616  
617 Exceptions thrown by L<Sys::Ioctl#ioctl|SPVM::Sys::Ioctl/"ioctl"> method or L<Sys::Ioctl#ioctlsocket|SPVM::Sys::Ioctl/"ioctlsocket"> method could be thrown.
618  
619 =head2 A
620  
621 C<static method A : double ($file : string);>
622  
623 Returns script start time minus file access time of the file $file, in days.
624  
625 This method corresponds to Perl's L<-A|https://perldoc.perl.org/functions/-X>.
626  
627 Exceptions:
628  
629 $file must be defined. Otherwise an exception is thrown.
630  
631 The exceptions thrown by L</"stat"> method could be thrown.
632  
633 =head2 C
634  
635 C<static method C : double ($file : string);>
636  
637 Returns script start time minus file inode change time of the file $file, in days.
638  
639 This method corresponds to Perl's L<-C|https://perldoc.perl.org/functions/-X>.
640  
641 Exceptions:
642  
643 $file must be defined. Otherwise an exception is thrown.
644  
645 The exceptions thrown by L</"stat"> method could be thrown.
646  
647 =head2 M
648  
649 C<static method M : double ($file : string);>
650  
651 Returns script start time minus file modification time of the file $file, in days.
652  
653 This method corresponds to Perl's L<-M|https://perldoc.perl.org/functions/-X>.
654  
655 Exceptions:
656  
657 $file must be defined. Otherwise an exception is thrown.
658  
659 The exceptions thrown by L</"stat"> method could be thrown.
660  
661 =head2 O
662  
663 C<static method O : int ($file : string);>
664  
665 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
666  
667 Othersize if the file $file is owned by real uid, returns 1, otherwise returns 0.
668  
669 This method corresponds to Perl's L<-O|https://perldoc.perl.org/functions/-X>.
670  
671 Exceptions:
672  
673 $file must be defined. Otherwise an exception is thrown.
674  
675 =head2 R
676  
677 C<static method R : int ($file : string);>
678  
679 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
680  
681 Otherwise if the file $file is readable by real uid/gid, returns 1, otherwise returns 0.
682  
683 This method corresponds to Perl's L<-R|https://perldoc.perl.org/functions/-X>.
684  
685 Exceptions:
686  
687 $file must be defined. Otherwise an exception is thrown.
688  
689 =head2 S
690  
691 C<static method S : int ($file : string);>
692  
693 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
694  
695 Otherwise if the file $file is a socket, returns 1, otherwise returns 0.
696  
697 This method corresponds to Perl's L<-S|https://perldoc.perl.org/functions/-X>.
698  
699 Exceptions:
700  
701 $file must be defined. Otherwise an exception is thrown.
702  
703 =head2 W
704  
705 C<static method W : int ($file : string);>
706  
707 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
708  
709 Otherwise if the file $file is writable by real uid/gid, returns 1, otherwise returns 0.
710  
711 This method corresponds to Perl's L<-W|https://perldoc.perl.org/functions/-X>.
712  
713 Exceptions:
714  
715 $file must be defined. Otherwise an exception is thrown.
716  
717 =head2 X
718  
719 C<static method X : int ($file : string);>
720  
721 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
722  
723 Otherwise if the file $file is executable by real uid/gid, returns 1, otherwise returns 0.
724  
725 This method corresponds to Perl's L<-X|https://perldoc.perl.org/functions/-X>.
726  
727 Exceptions:
728  
729 $file must be defined. Otherwise an exception is thrown.
730  
731 =head2 b
732  
733 C<static method b : int ($file : string);>
734  
735 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
736  
737 Otherwise if the file $file is a block special file, returns 1, otherwise returns 0.
738  
739 This method corresponds to Perl's L<-b|https://perldoc.perl.org/functions/-X>.
740  
741 Exceptions:
742  
743 $file must be defined. Otherwise an exception is thrown.
744  
745 =head2 c
746  
747 C<static method c : int ($file : string);>
748  
749 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
750  
751 Otherwise if the file $file is a character special file, returns 1, otherwise returns 0.
752  
753 This method corresponds to Perl's L<-c|https://perldoc.perl.org/functions/-X>.
754  
755 Exceptions:
756  
757 $file must be defined. Otherwise an exception is thrown.
758  
759 =head2 d
760  
761 C<static method d : int ($file : string);>
762  
763 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
764  
765 Otherwise if the file $file is a directory, returns 1, otherwise returns 0.
766  
767 This method corresponds to Perl's L<-d|https://perldoc.perl.org/functions/-X>.
768  
769 Exceptions:
770  
771 $file must be defined. Otherwise an exception is thrown.
772  
773 =head2 e
774  
775 C<static method e : int ($file : string);>
776  
777 If If the file doesn't exist or can't be examined(These checks are done by L</"lstat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
778  
779 This method corresponds to Perl's L<-e|https://perldoc.perl.org/functions/-X>.
780  
781 Exceptions:
782  
783 $file must be defined. Otherwise an exception is thrown.
784  
785 =head2 f
786  
787 C<static method f : int ($file : string);>
788  
789 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
790  
791 Otherwise if the file $file is a plain file, returns 1, otherwise returns 0.
792  
793 This method corresponds to Perl's L<-f|https://perldoc.perl.org/functions/-X>.
794  
795 Exceptions:
796  
797 $file must be defined. Otherwise an exception is thrown.
798  
799 =head2 g
800  
801 C<static method g : int ($file : string);>
802  
803 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
804  
805 Otherwise if the file $file has setgid bit set, returns 1, otherwise returns 0.
806  
807 This method corresponds to Perl's L<-g|https://perldoc.perl.org/functions/-X>.
808  
809 Exceptions:
810  
811 $file must be defined. Otherwise an exception is thrown.
812  
813 =head2 k
814  
815 C<static method k : int ($file : string);>
816  
817 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
818  
819 Otherwise if the file $file has sticky bit set, returns 1, otherwise returns 0.
820  
821 This method corresponds to Perl's L<-k|https://perldoc.perl.org/functions/-X>.
822  
823 Exceptions:
824  
825 $file must be defined. Otherwise an exception is thrown.
826  
827 =head2 l
828  
829 C<static method l : int ($file : string);>
830  
831 If If the file doesn't exist or can't be examined(These checks are done by L</"lstat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
832  
833 Otherwise if the file $file is a symbolic link (false if symlinks aren't supported by the file system), returns 1, otherwise returns 0.
834  
835 This method corresponds to Perl's L<-l|https://perldoc.perl.org/functions/-X>.
836  
837 Exceptions:
838  
839 $file must be defined. Otherwise an exception is thrown.
840  
841 =head2 o
842  
843 C<static method o : int ($file : string);>
844  
845 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
846  
847 Otherwise if the file $file is owned by effective uid, returns 1, otherwise returns 0.
848  
849 This method corresponds to Perl's L<-l|https://perldoc.perl.org/functions/-X>.
850  
851 Exceptions:
852  
853 $file must be defined. Otherwise an exception is thrown.
854  
855 =head2 p
856  
857 C<static method p : int ($file : string);>
858  
859 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
860  
861 Otherwise if the file $file is a named pipe (FIFO), or Filehandle is a pipe, returns 1, otherwise returns 0.
862  
863 This method corresponds to Perl's L<-p|https://perldoc.perl.org/functions/-X>.
864  
865 Exceptions:
866  
867 $file must be defined. Otherwise an exception is thrown.
868  
869 =head2 r
870  
871 C<static method r : int ($file : string);>
872  
873 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
874  
875 Otherwise if the file $file is readable by effective uid/gid, returns 1, otherwise returns 0.
876  
877 This method corresponds to Perl's L<-r|https://perldoc.perl.org/functions/-X>.
878  
879 Exceptions:
880  
881 $file must be defined. Otherwise an exception is thrown.
882  
883 =head2 s
884  
885 C<static method s : long ($file : string);>
886  
887 If the file $file has nonzero size, returns its size in bytes, otherwise returns 0.
888  
889 This method corresponds to Perl's L<-s|https://perldoc.perl.org/functions/-X>.
890  
891 Exceptions:
892  
893 $file must be defined. Otherwise an exception is thrown.
894  
895 The exceptions thrown by L</"stat"> method could be thrown.
896  
897 =head2 u
898  
899 C<static method u : int ($file : string);>
900  
901 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
902  
903 Otherwise if the file $file has setuid bit set, returns 1, otherwise returns 0.
904  
905 This method corresponds to Perl's L<-u|https://perldoc.perl.org/functions/-X>.
906  
907 Exceptions:
908  
909 $file must be defined. Otherwise an exception is thrown.
910  
911 =head2 w
912  
913 C<static method w : int ($file : string);>
914  
915 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
916  
917 Otherwise if the file $file is writable by effective uid/gid, returns 1, otherwise returns 0.
918  
919 This method corresponds to Perl's L<-u|https://perldoc.perl.org/functions/-X>.
920  
921 Exceptions:
922  
923 $file must be defined. Otherwise an exception is thrown.
924  
925 =head2 x
926  
927 C<static method x : int ($file : string);>
928  
929 If If the file doesn't exist or can't be examined(These checks are done by L</"stat"> method), returns 0 and L<errno|SPVM::Errno/"errno"> is set to a positive value.
930  
931 Otherwise if the file $file is executable by effective uid/gid, returns 1, otherwise returns 0.
932  
933 This method corresponds to Perl's L<-x|https://perldoc.perl.org/functions/-X>.
934  
935 Exceptions:
936  
937 $file must be defined. Otherwise an exception is thrown.
938  
939 =head2 z
940  
941 C<static method z : int ($file : string);>
942  
943 If the file $file has zero size (is empty), returns 1, otherwise returns 0.
944  
945 This method corresponds to Perl's L<-z|https://perldoc.perl.org/functions/-X>.
946  
947 Exceptions:
948  
949 $file must be defined. Otherwise an exception is thrown.
950  
951 The exceptions thrown by L</"stat"> method could be thrown.
952  
953 =head2 time
954  
955 C<static method time : long ();>
956  
957 Returns the current epoch time.
958  
959 =head2 localtime
960  
961 C<static method localtime : L<Sys::Time::Tm|SPVM::Sys::Time::Tm> ($epoch : long = 0);>
962  
963 Converts the calendar time $epoch to a broken-down time, expressed relative to the user's specified time zone.
964  
965 If $epoch is not specified, the current time is used.
966  
967 This method calls C<tzset> internally to update time conversion information from the environment variable C<TZ>.
968  
969 Returns a L<Sys::Time::Tm|SPVM::Sys::Time::Tm> object.
970  
971 Exceptions:
972  
973 If the conversion fails, an exception is thrown.
974  
975 =head2 gmtime
976  
977 C<static method gmtime : L<Sys::Time::Tm|SPVM::Sys::Time::Tm> ($epoch : long = 0);>
978  
979 Converts the calendar time $epoch to a broken-down time, expressed in Coordinated Universal Time (UTC).
980  
981 If $epoch is not specified, the current time is used.
982  
983 Returns a L<Sys::Time::Tm|SPVM::Sys::Time::Tm> object.
984  
985 Exceptions:
986  
987 If the conversion fails, an exception is thrown.
988  
989 =head2 utime
990  
991 C<static method utime : void ($atime : long, $mtime : long, $file : string);>
992  
993 Changes the access time and the modification time of the inode specified by the file $file given the access time $atime and the modification time $mtime.
994  
995 If $atime < 0 and $mtime < 0, changes the access time and the modification time to the current time..
996  
997 Exceptions:
998  
999 Exceptions thrown by L<Sys::Time#utime|SPVM::Sys::Time/"utime"> method could be thrown.
1000  
1001 =head2 stat
1002  
1003 C<static method stat : L<Sys::IO::Stat|SPVM::Sys::IO::Stat> ($file : string);>
1004  
1005 Returns information about a file $file.
1006  
1007 Exceptions:
1008  
1009 Exceptions thrown by L<Sys::IO::Stat#stat|SPVM::Sys::IO::Stat/"stat"> method could be thrown.
1010  
1011 =head2 lstat
1012  
1013 C<static method lstat : L<Sys::IO::Stat|SPVM::Sys::IO::Stat> ($file : string);>
1014  
1015 Identical to L</"stat">, except that if path $file is a symbolic link(or directory junction only in Windows), then the link itself is stat-ed, not the file that it refers to.
1016  
1017 Exceptions:
1018  
1019 Exceptions thrown by L<Sys::IO::Stat#lstat|SPVM::Sys::IO::Stat/"lstat"> method could be thrown.
1020  
1021 =head2 fstat
1022  
1023 C<static method fstat : L<Sys::IO::Stat|SPVM::Sys::IO::Stat> ($fd : int);>
1024  
1025 Identical to L</"stat">, except that the file to be stat-ed is specified by the file descriptor $fd.
1026  
1027 Exceptions:
1028  
1029 Exceptions thrown by L<Sys::IO::Stat#fstat|SPVM::Sys::IO::Stat/"fstat"> method could be thrown.
1030  
1031 =head2 env
1032  
1033 C<static method env : string ($name : string);>
1034  
1035 Gets an environment variable with the name $name.
1036  
1037 =head2 set_env
1038  
1039 C<static method set_env : void ($name : string, $value : string);>
1040  
1041 Sets an environment variable with the name $name and the value $value.
1042  
1043 If $value is undef or "", the environment variable is removed.
1044  
1045 Exceptions:
1046  
1047 This method calls the following methods, so exceptions thrown by these methods could be thrown.
1048  
1049 =over 2
1050  
1051 =item * L<_putenv_s|SPVM::Sys::Env/"_putenv_s"> in Sys::Env
1052  
1053 =item * L<setenv|SPVM::Sys::Env/"setenv"> in Sys::Env
1054  
1055 =item * L<unsetenv|SPVM::Sys::Env/"unsetenv"> in Sys::Env
1056  
1057 =back
1058  
1059 =head2 osname
1060  
1061 C<static method osname : string ()>
1062  
1063 Gets the OS name. This method corresponds to Perl's L<$^O|https://perldoc.perl.org/perlvar#$%5EO>.
1064  
1065 =over 2
1066  
1067 =item * C<linux>
1068  
1069 =item * C<darwin>
1070  
1071 =item * C<MSWin32>
1072  
1073 =item * C<freebsd>
1074  
1075 =item * C<openbsd>
1076  
1077 =item * C<solaris>
1078  
1079 =back
1080  
1081 Exceptions:
1082  
1083 If the OS name could not be determined, an exception is thrown.
1084  
1085 =head2 socket
1086  
1087 C<static method socket : void ($socket_fd_ref : int*, $domain : int, $type : int, $protocol : int);>
1088  
1089 Opens a socket given the domain $domain, the type $type, and the protocal $protocol.
1090  
1091 The created socket file descriptor is set to the value referenced by $socket_fd_ref.
1092  
1093 This method calls L<Sys::Socket#socket|SPVM::Sys::Socket/"socket"> method.
1094  
1095 If the system supports C<FD_CLOEXEC>, this flag is set to the value referenced by $socket_fd_ref using L</"fcntl">.
1096  
1097 Exceptions:
1098  
1099 Exceptions thrown by L<Sys::Socket#socket|SPVM::Sys::Socket/"socket"> method could be thrown.
1100  
1101 =head2 connect
1102  
1103 C<static method connect : void ($socket_fd : int, $sockaddr : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr>);>
1104  
1105 Attempts to connect to a remote socket, just like the C<connect> system call.
1106  
1107 This method calls L<Sys::Socket#connect|SPVM::Sys::Socket/"connect"> method.
1108  
1109 Exceptions:
1110  
1111 Exceptions thrown by L<Sys::Socket#connect|SPVM::Sys::Socket/"connect"> method could be thrown.
1112  
1113 =head2 bind
1114  
1115 C<static method bind : void ($socket_fd : int, $sockaddr : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr>);>
1116  
1117 Binds a network address $sockaddr to the socket $socket_fd.
1118  
1119 This method calls L<Sys::Socket#bind|SPVM::Sys::Socket/"bind"> method.
1120  
1121 Exceptions:
1122  
1123 Exceptions thrown by L<Sys::Socket#bind|SPVM::Sys::Socket/"bind"> method could be thrown.
1124  
1125 =head2 listen
1126  
1127 C<static method listen : void ($socket_fd : int, $backlog : int);>
1128  
1129 Does the same thing that the C<listen> system call does.
1130  
1131 This method calls L<Sys::Socket#listen|SPVM::Sys::Socket/"listen"> method.
1132  
1133 Exceptions:
1134  
1135 Exceptions thrown by L<Sys::Socket#listen|SPVM::Sys::Socket/"listen"> method could be thrown.
1136  
1137 =head2 accept
1138  
1139 C<static method accept : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> ($client_fd_ref : int*, $server_fd : int);>
1140  
1141 Performs accept operation.
1142  
1143 Implementation:
1144  
1145 Thie methods calls L<Sys::Socket#accept|SPVM::Sys::Socket/"accept"> method given the file descriptor $server_fd, a client address for output, the size of the client address.
1146  
1147 The client address for output and the size of the client address are automatically created.
1148  
1149 $$client_fd_ref is set to the return value.
1150  
1151 The client address is upgraded to a child class of L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> using L<upgrade|SPVM::Sys::Socket::Sockaddr/"upgrade"> method.
1152  
1153 If the system supports C<FD_CLOEXEC>, The file descriptor flag of $$client_fd_ref is set to C<FD_CLOEXEC> using L</"fcntl"> method.
1154  
1155 Exceptions:
1156  
1157 Exceptions thrown by L<Sys::Socket#accept|SPVM::Sys::Socket/"accept"> method could be thrown.
1158  
1159 =head2 recv
1160  
1161 C<static method recv : int ($socket_fd : int, $buffer : mutable string, $length : int, $flags : int, $buffer_offset : int = 0);>
1162  
1163 Receives a message on a socket.
1164  
1165 This method calls L<Sys::Socket#recv|SPVM::Sys::Socket/"recv"> method given the arguments given to this method and returns its return value.
1166  
1167 Exceptions:
1168  
1169 Exceptions thrown by L<Sys::Socket#recv|SPVM::Sys::Socket/"recv"> method could be thrown.
1170  
1171 =head2 recvfrom
1172  
1173 C<static method recvfrom : int ($socket_fd : int, $buffer : mutable string, $length : int, $flags : int, $sockaddr_ref : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr>[], $buffer_offset : int = 0);>
1174  
1175 Receives a message on a socket given the array $sockaddr_ref for a peer socket address for output.
1176  
1177 This method calls L<Sys::Socket#recvfrom|SPVM::Sys::Socket/"recvfrom"> method given the arguments given to this method and returns its return value.
1178  
1179 $addrlen_ref is set to an int reference.
1180  
1181 If $sockaddr_ref is given, $sockaddr is set to a L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> object.
1182  
1183 In this case, $sockaddr is upgraded by calling L<Sys::Socket::Sockaddr#upgrade|SPVM::Sys::Socket::Sockaddr/"upgrade"> method and $sockaddr_ref at index 0 is set to it.
1184  
1185 Exceptions:
1186  
1187 If $sockaddr_ref for an array for a peer socket address for output is defined, the length must be 1.
1188  
1189 Exceptions thrown by L<Sys::Socket#recvfrom|SPVM::Sys::Socket/"recvfrom"> method could be thrown.
1190  
1191 =head2 send
1192  
1193 C<static method send : int ($socket_fd : int, $buffer : string, $flags : int, $length : int = -1, $buffer_offset : int = 0);>
1194  
1195 Sends a message on a socket.
1196  
1197 This method calls L<Sys::Socket#send|SPVM::Sys::Socket/"send"> method given the arguments given to this method and returns its return value.
1198  
1199 If $length is less than 0, $length is set to the length of $buffer.
1200  
1201 Exceptions:
1202  
1203 Exceptions thrown by L<Sys::Socket#sendto|SPVM::Sys::Socket/"send"> method could be thrown.
1204  
1205 =head2 sendto
1206  
1207 C<static method sendto : int ($socket_fd : int, $buffer : string, $flags : int, $sockaddr : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr>, $length : int = -1, $buffer_offset : int = 0);>
1208  
1209 Sends a message on a socket given the peer socket address $sockaddr.
1210  
1211 This method calls L<Sys::Socket#sendto|SPVM::Sys::Socket/"sendto"> method given the arguments given to this method and returns its return value.
1212  
1213 If $length is less than 0, $length is set to the length of $buffer.
1214  
1215 Exceptions:
1216  
1217 Exceptions thrown by L<Sys::Socket#sendto|SPVM::Sys::Socket/"sendto"> method could be thrown.
1218  
1219 =head2 shutdown
1220  
1221 C<static method shutdown : void ($socket_fd : int, $how : int);>
1222  
1223 Shuts down a socket connection $socket_fd in the manner indicated by $how.
1224  
1225 This method calls L<Sys::Socket#shutdown|SPVM::Sys::Socket/"shutdown"> method.
1226  
1227 Exceptions:
1228  
1229 Exceptions thrown by L<Sys::Socket#shutdown|SPVM::Sys::Socket/"shutdown"> method could be thrown.
1230  
1231 =head2 getpeername
1232  
1233 C<static method getpeername : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> ($socket_fd : int);>
1234  
1235 Returns the packed sockaddr address of the other end of the socket connection $socket_fd.
1236  
1237 This method calls L<Sys::Socket#getpeername|SPVM::Sys::Socket/"getpeername"> method.
1238  
1239 The returned packed sockaddr address is upgraded to a child class of L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> using L<upgrade|SPVM::Sys::Socket::Sockaddr/"upgrade"> method.
1240  
1241 Exceptions:
1242  
1243 Exceptions thrown by L<Sys::Socket#getpeername|SPVM::Sys::Socket/"getpeername"> method could be thrown.
1244  
1245 =head2 getsockname
1246  
1247 C<static method getsockname : L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> ($socket_fd : int)>
1248  
1249 Returns the packed sockaddr address of this end of the socket connection $socket_fd.
1250
1251 Thie method calls L<Sys::Socket#getsockname|SPVM::Sys::Socket/"getsockname"> method.
1252  
1253 The returned packed sockaddr address is upgraded to a child class of L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr> using L<upgrade|SPVM::Sys::Socket::Sockaddr/"upgrade"> method.
1254  
1255 Exceptions:
1256  
1257 Exceptions thrown by L<Sys::Socket#getsockname|SPVM::Sys::Socket/"getsockname"> method could be thrown.
1258  
1259 =head2 socketpair
1260  
1261 C<static method socketpair : void ($socket_fd1_ref : int*, $socket_fd2_ref : int*, $domain : int, $type : int, $protocol : int);>
1262  
1263 Creates an unnamed pair of sockets in the specified domain, of
1264 the specified type. The domain $domain, the type $type, the protocal $protocol are specified the
1265 same as for the syscall of the same name.
1266  
1267 The opened reading file descripor is set to the value referenced by $socket_fd1_ref.
1268  
1269 The opened writing file descripor is set to the value referenced by $socket_fd2_ref.
1270  
1271 This method calls L<Sys::Socket#socketpair|SPVM::Sys::Socket/"socketpair"> method .
1272  
1273 If the system supports C<FD_CLOEXEC>, this flag is set to $$socket_fd1_ref and $$socket_fd2_ref using L</"fcntl">.
1274  
1275 Exceptions:
1276  
1277 Exceptions thrown by L<Sys::Socket#socketpair|SPVM::Sys::Socket/"socketpair"> method could be thrown.
1278  
1279 =head2 setsockopt
1280  
1281 C<static method setsockopt : void ($socket_fd : int, $level : int, $option_name : int, $option_value : object of string|Int);>
1282  
1283 Sets the socket option requested.
1284  
1285 This method calls L<Sys::Socket#getsockopt|SPVM::Sys::Socket/"getsockopt"> method.
1286  
1287 Exceptions:
1288  
1289 $option_value must be defined. Otherwise an exception is thrown.
1290  
1291 The type of \$option_value must be the Int or string type.
1292  
1293 Exceptions thrown by L<Sys::Socket#getsockopt|SPVM::Sys::Socket/"getsockopt"> method could be thrown.
1294  
1295 =head2 getsockopt
1296  
1297 C<static method getsockopt : string ($socket_fd : int, $level : int, $option_name : int, $option_value_length : int = -1);>
1298  
1299 If $option_value_length is less than 0, it is set to 4.
1300  
1301 This method calls L<Sys::Socket#getsockopt|SPVM::Sys::Socket/"getsockopt"> method.
1302  
1303 Examples:
1304  
1305 Getting an int value:
1306  
1307 my $reuseaddr_packed = Sys->getsockopt($socket, SOCKET->SOL_SOCKET, SOCKET->SO_REUSEADDR);
1308 my $reuseaddr_ref = [0];
1309 Fn->memcpy($reuseaddr_ref, 0, $reuseaddr_packed, 0, 4);
1310 my $reuseaddr = $reuseaddr_ref->[0];
1311  
1312 Exceptions:
1313  
1314 Exceptions thrown by L<Sys::Socket#getsockopt|SPVM::Sys::Socket/"getsockopt"> method could be thrown.
1315  
1316 =head2 signal
1317  
1318 C<static method signal : void ($signal_number : int, $handler_name : string);>
1319  
1320 Sets a signal handler with its name $handler_name for the given signal number $signal_number.
1321  
1322 If $handler_name is "DEFAULT", the signal handler is L<"SIG_DFL"|SPVM::Sys::Signal/"SIG_DFL">.
1323  
1324 If $handler_name is "IGNORE", the signal handler is L<"SIG_IGN"|SPVM::Sys::Signal/"SIG_IGN">.
1325  
1326 See L<Sys::Signal#signal|SPVM::Sys::Signal/"signal"> method in detail.
1327  
1328 Exceptions:
1329  
1330 If $handler_name is not available, an exception is thrown.
1331  
1332 The exceptions thrown by L<Sys::Signal#signal|SPVM::Sys::Signal/"signal"> method could be thrown.
1333  
1334 =head2 kill
1335  
1336 C<static method kill : void ($signal_number : int, $process_id : int);>
1337  
1338 Send a signal $signal_number to the process whose process ID is $process_id.
1339  
1340 See L<Sys::Signal#kill|SPVM::Sys::Signal/"kill"> method in detail.
1341  
1342 In Windows, see L<Sys::Signal#raise|SPVM::Sys::Signal/"raise"> method in detail.
1343  
1344 Exceptions:
1345  
1346 The exceptions thrown by L<Sys::Signal#alarm|SPVM::Sys::Signal/"alarm"> method could be thrown.
1347  
1348 The exceptions thrown by L<Sys::Signal#raise|SPVM::Sys::Signal/"raise"> method could be thrown.
1349  
1350 $process_id must be equal to Sys->process_id in Windows. Otherwise an exception is thrown.
1351  
1352 =head2 alarm
1353  
1354 C<static method alarm : int ($seconds : int);>
1355  
1356 Sets a alarm signal sent after seconds $seconds.
1357  
1358 See L<Sys::Signal#alarm|SPVM::Sys::Signal/"alarm"> method in detail.
1359  
1360 Exceptions:
1361  
1362 The exceptions thrown by L<Sys::Signal#alarm|SPVM::Sys::Signal/"alarm"> method could be thrown.
1363  
1364 =head2 fork
1365  
1366 C<static method fork : int ();>
1367  
1368 Forks the process by calling L<Sys::Process#fork|SPVM::Sys::Process/"fork"> method.
1369  
1370 It returns the child process ID to the parent process, or returns 0 to the child process.
1371  
1372 Exceptions:
1373  
1374 Exceptions thrown by L<Sys::Process#fork|SPVM::Sys::Process/"fork"> method could be thrown.
1375  
1376 =head2 getpriority
1377  
1378 C<static method getpriority : int ($which : int, $who : int);>
1379  
1380 Return the scheduling priority of the process, process group, or user, as indicated by $which and $who is obtained.
1381  
1382 Exceptions:
1383  
1384 Exceptions thrown by L<Sys::Process#getpriority|SPVM::Sys::Process/"getpriority"> method could be thrown.
1385  
1386 =head2 setpriority
1387  
1388 C<static method setpriority : void ($which : int, $who : int, $priority : int)>
1389  
1390 Sets the scheduling priority of the process, process group, or user, as indicated by $which and $who is obtained.
1391  
1392 Exceptions:
1393  
1394 Exceptions thrown by L<Sys::Process#setpriority|SPVM::Sys::Process/"setpriority"> method could be thrown.
1395  
1396 =head2 sleep
1397  
1398 C<static method sleep : int ($seconds : int);>
1399  
1400 Sleeps for the seconds $seconds.
1401  
1402 =head2 wait
1403  
1404 C<static method wait : int ($wstatus_ref : int*);>
1405  
1406 Waits for state changes in a child of the calling process, and returns a process ID whose state is changed.
1407  
1408 The status about the child whose state has changed is set to $wstatus_ref.
1409  
1410 The following methods in L<Sys::Process|SPVM::Sys::Process> class checks the value of $wstatus_ref.
1411  
1412 =over 2
1413  
1414 =item * L<WIFEXITED|SPVM::Sys::Process/"WIFEXITED">
1415  
1416 =item * L<WEXITSTATUS|SPVM::Sys::Process/"WEXITSTATUS">
1417  
1418 =item * L<WIFSIGNALED|SPVM::Sys::Process/"WIFSIGNALED">
1419  
1420 =item * L<WTERMSIG|SPVM::Sys::Process/"WTERMSIG">
1421  
1422 =item * L<WCOREDUMP|SPVM::Sys::Process/"WCOREDUMP">
1423  
1424 =item * L<WIFEXITED|SPVM::Sys::Process/"WIFEXITED">
1425  
1426 =item * L<WIFSTOPPED|SPVM::Sys::Process/"WIFSTOPPED">
1427  
1428 =item * L<WSTOPSIG|SPVM::Sys::Process/"WSTOPSIG">
1429  
1430 =item * L<WIFCONTINUED|SPVM::Sys::Process/"WIFCONTINUED">
1431  
1432 =back
1433  
1434 Exceptions:
1435  
1436 Exceptions thrown by L<Sys::Process#wait|SPVM::Sys::Process/"wait"> method could be thrown.
1437  
1438 =head2 waitpid
1439  
1440 C<static method waitpid : int ($process_id : in, $options : int, $wstatus_ref : int*);>
1441  
1442 Same as L</"wait"> method, but can give the process ID $process_id and the options $options.
1443  
1444 See L<Sys::Process::Constant|SPVM::Sys::Process::Constant> about constant values given to $options.
1445  
1446 Exceptions:
1447  
1448 Exceptions thrown by L<Sys::Process#waitpid|SPVM::Sys::Process/"waitpid"> method could be thrown.
1449  
1450 =head2 system
1451  
1452 C<static method system : int ($command : string);>
1453  
1454 Executes a command specified in command using shell and return L</"wait"> status.
1455  
1456 =head2 exit
1457  
1458 C<static method exit : void ($status : int);>
1459  
1460 Terminates the calling process immediately with the status $status.
1461  
1462 =head2 pipe
1463  
1464 C<static method pipe : void ($read_fd_ref : int*, $write_fd_ref : int*);>
1465  
1466 Opens a pair of pipes.
1467  
1468 =head2 getpgrp
1469  
1470 C<static method getpgrp : int ($process_id : int);>
1471  
1472 Gets the process group number given the process ID $process_id of the running this program.
1473  
1474 =head2 setpgrp
1475  
1476 C<static method setpgrp : void ($process_id : int, $process_group_id : int);>
1477  
1478 Sets the process group number $process_group_id given the process ID $process_id of the running this program.
1479  
1480 =head2 process_id
1481  
1482 C<static method process_id : int ();>
1483  
1484 Gets the process number of the running this program.
1485  
1486 =head2 getppid
1487  
1488 C<static method getppid : int ();>
1489  
1490 Returns the process ID of the parent of the calling process.
1491  
1492 =head2 exec
1493  
1494 C<static method exec : void ($program_with_args : string[], $options : object[] = undef);>
1495  
1496 Executes the program with the arguments $program_with_args by using C<execvp>.
1497  
1498 The 1th argument of C<execvp> is $program_with_args->[0], the 2th argument is $program_with_args.
1499  
1500 Options:
1501  
1502 =over 2
1503  
1504 =item * C<program>
1505  
1506 A program to be run. The 1th argument of C<execvp>.
1507  
1508 =back
1509
1510
1511 Examples:
1512  
1513 Sys->exec(["/bin/echo", "-n", "Hello"]);
1514  
1515 Sys->exec(["echo", "-n", "Hello"], {program => "/bin/echo"});
1516  
1517 =head2 real_user_id
1518  
1519 C<static method real_user_id : int ();>
1520  
1521 Gets the real user ID of the current process.
1522  
1523 This method calls L<Sys::User#getuid|SPVM::Sys::User/"getuid"> method and returns its return value.
1524  
1525 Exceptions:
1526  
1527 Exceptions thrown by L<Sys::User#getuid|SPVM::Sys::User/"getuid"> method could be thrown.
1528  
1529 =head2 effective_user_id
1530  
1531 C<static method effective_user_id : int ();>
1532  
1533 Gets the effective user ID of the current process.
1534  
1535 This method calls L<Sys::User#geteuid|SPVM::Sys::User/"geteuid"> method and returns its return value.
1536  
1537 Exceptions:
1538  
1539 Exceptions thrown by L<Sys::User#geteuid|SPVM::Sys::User/"geteuid"> method could be thrown.
1540  
1541 =head2 real_group_id
1542  
1543 C<static method real_group_id : int ();>
1544  
1545 Gets the real group ID of the current process.
1546  
1547 This method calls L<Sys::User#getgid|SPVM::Sys::User/"getgid"> method and returns its return value.
1548  
1549 Exceptions:
1550  
1551 Exceptions thrown by L<Sys::User#getgid|SPVM::Sys::User/"getgid"> method could be thrown.
1552  
1553 =head2 effective_group_id
1554  
1555 C<static method effective_group_id : int ();>
1556  
1557 Gets the effective group ID of the current process.
1558  
1559 This method calls L<Sys::User#getegid|SPVM::Sys::User/"getegid"> method and returns its return value.
1560  
1561 Exceptions:
1562  
1563 Exceptions thrown by L<Sys::User#getegid|SPVM::Sys::User/"getegid"> method could be thrown.
1564  
1565 =head2 set_real_user_id
1566  
1567 C<static method set_real_user_id : void ($uid : int);>
1568  
1569 Sets the real user ID of the current process.
1570  
1571 This method calls L<Sys::User#setuid|SPVM::Sys::User/"setuid"> method given the argument given to this method.
1572  
1573 Exceptions:
1574  
1575 Exceptions thrown by L<Sys::User#setuid|SPVM::Sys::User/"setuid"> method could be thrown.
1576  
1577 =head2 set_effective_user_id
1578  
1579 C<static method set_effective_user_id : void ($euid : int);>
1580  
1581 Sets the effective user ID of the current process.
1582  
1583 This method calls L<Sys::User#seteuid|SPVM::Sys::User/"seteuid"> method given the argument given to this method.
1584  
1585 Exceptions:
1586  
1587 Exceptions thrown by L<Sys::User#seteuid|SPVM::Sys::User/"seteuid"> method could be thrown.
1588  
1589 =head2 set_real_group_id
1590  
1591 C<static method set_real_group_id : void ($real_group_id : int);>
1592  
1593 Sets the real group ID of the current process.
1594  
1595 This method calls L<Sys::User#setgid|SPVM::Sys::User/"setgid"> method given the argument given to this method.
1596  
1597 Exceptions:
1598  
1599 Exceptions thrown by L<Sys::User#setgid|SPVM::Sys::User/"setgid"> method could be thrown.
1600  
1601 =head2 set_effective_group_id
1602  
1603 C<static method set_effective_group_id : void ($effective_group_id : int);>
1604  
1605 Sets the effective group ID of the current process.
1606  
1607 This method calls L<Sys::User#getegid|SPVM::Sys::User/"getegid"> method given the argument given to this method.
1608  
1609 Exceptions:
1610  
1611 Exceptions thrown by L<Sys::User#getegid|SPVM::Sys::User/"getegid"> method could be thrown.
1612  
1613 =head2 setpwent
1614  
1615 C<static method setpwent : void ();>
1616  
1617 Rewinds to the beginning of the password database.
1618  
1619 =head2 endpwent
1620  
1621 C<static method endpwent : void ();>
1622  
1623 Closes the password database after all processing has been performed.
1624  
1625 =head2 getpwent
1626  
1627 C<static method getpwent : L<Sys::User::Passwd|SPVM::Sys::User::Passwd> ();>
1628  
1629 Gets a next password entry.
1630  
1631 =head2 setgrent
1632  
1633 C<static method setgrent : void ();>
1634  
1635 Rewinds to the beginning of the group database.
1636  
1637 =head2 endgrent
1638  
1639 C<static method endgrent : void ();>
1640  
1641 Closes the group database after all processing has been performed.
1642  
1643 =head2 getgrent
1644  
1645 C<static method getgrent : L<Sys::User::Group|SPVM::Sys::User::Group> ();>
1646  
1647 Gets a next group entry.
1648  
1649 =head2 getgroups
1650  
1651 C<static method getgroups : int[] ();>
1652  
1653 Returns the supplementary group IDs of the calling process.
1654  
1655 =head2 setgroups
1656  
1657 C<static method setgroups : void ($group_ids : int[]);>
1658  
1659 Sets the supplementary group IDs for the calling process.
1660  
1661 =head2 getpwuid
1662  
1663 C<static method getpwuid : L<Sys::User::Passwd|SPVM::Sys::User::Passwd> ($id : int);>
1664  
1665 Searches a password entry given The user ID $id. If found, returns the password entry, otherwise return undef.
1666  
1667 =head2 getpwnam
1668  
1669 C<static method getpwnam : L<Sys::User::Passwd|SPVM::Sys::User::Passwd> ($name : string);>
1670  
1671 Searches a password entry given The user name $name. If found, returns the password entry, otherwise return undef.
1672  
1673 =head2 getgrgid
1674  
1675 C<static method getgrgid : L<Sys::User::Group|SPVM::Sys::User::Group> ($id : int);>
1676  
1677 Searches a group entry given The group ID $id. If found, returns the group entry, otherwise return undef.
1678  
1679 =head2 getgrnam
1680  
1681 C<static method getgrnam : L<Sys::User::Group|SPVM::Sys::User::Group> ($name : string);>
1682  
1683 Searches a group entry given The group name $name. If found, returns the group entry, otherwise return undef.
1684  
1685 =head2 srand
1686  
1687 C<static method srand : void ($seed : int);>
1688  
1689 Sets the random number $seed for L</"rand"> method.
1690  
1691 Implementation:
1692  
1693 Calls L<Fn#set_seed|SPVM::Fn/"set_seed"> method given $seed.
1694  
1695 =head2 rand
1696  
1697 C<static method rand : double ($max : int = 1);>
1698  
1699 Returns a random fractional number greater than or equal to 0 and less than $max.
1700  
1701 If you change the random seed, you can use L</"srand"> method.
1702  
1703 Implementation:
1704  
1705 If C<seed> stack variable is initialized, the random seed is got from the variable.
1706  
1707 Otherwise the random seed is created from the process ID and epoch time.
1708  
1709 And calls L<Fn#rand|SPVM::Fn/"rand"> method given the reference of the seed, $max.
1710  
1711 And calls L</"srand"> method given the returned seed to update C<seed> stack variable.
1712  
1713 Exceptions:
1714  
1715 Exceptions thrown by L<Fn#rand|SPVM::Fn/"rand"> method could be thrown.
1716  
1717 =head2 set_tcp_keepalive
1718  
1719 C<static method set_tcp_keepalive : void ($socket_fd : int, $onoff : int, $keepidle_sec : int, $keepintvl_sec : int = -1);>
1720  
1721 B<DEPRECATED>. Will be removed.
1722  
1723 Same as L<Sys::Socket::Util#set_tcp_keepalive|SPVM::Sys::Socket::Util/"set_tcp_keepalive">
1724  
1725 =head2 glob
1726  
1727 C<static method glob : string[] ($pattern : string);>
1728  
1729 Perl's L<bsd_glob|https://metacpan.org/pod/File::Glob#bsd_glob> porting.
1730  
1731 This method calls L<Sys::IO::Glob#bsd_glob|SPVM::Sys::IO::Glob/"bsd_glob"> method internally.
1732  
1733 See L<Sys::IO::Glob#bsd_glob|SPVM::Sys::IO::Glob/"bsd_glob"> in detail.
1734  
1735 =head2 pipepair
1736  
1737 C<static method pipepair : void ($fd1_ref : int*, $fd2_ref : int*, $non_blocking : int = 0);>
1738  
1739 Generates a pair of connected sockets or named pipes for bidirectional communication.
1740  
1741 See L<Sys::IO#pipepair|SPVM::Sys::IO/"pipepair"> in detail.
1742  
1743 If the system supports C<FD_CLOEXEC>, this flag is set to $$fd1_ref and $$fd1_ref using L</"fcntl">.
1744  
1745 =head1 Modules
1746  
1747 =over 2
1748  
1749 =item * L<Sys::Env|SPVM::Sys::Env>
1750  
1751 =item * L<Sys::IO|SPVM::Sys::IO>
1752  
1753 =item * L<Sys::IO::Constant|SPVM::Sys::IO::Constant>
1754  
1755 =item * L<Sys::Ioctl|SPVM::Sys::Ioctl>
1756  
1757 =item * L<Sys::Ioctl::Constant|SPVM::Sys::Ioctl::Constant>
1758  
1759 =item * L<Sys::IO::Dirent|SPVM::Sys::IO::Dirent>
1760  
1761 =item * L<Sys::IO::DirStream|SPVM::Sys::IO::DirStream>
1762  
1763 =item * L<Sys::IO::FileStream|SPVM::Sys::IO::FileStream>
1764  
1765 =item * L<Sys::IO::Flock|SPVM::Sys::IO::Flock>
1766  
1767 =item * L<Sys::IO::Glob|SPVM::Sys::IO::Glob>
1768  
1769 =item * L<Sys::IO::Stat|SPVM::Sys::IO::Stat>
1770  
1771 =item * L<Sys::OS|SPVM::Sys::OS>
1772  
1773 =item * L<Sys::Poll|SPVM::Sys::Poll>
1774  
1775 =item * L<Sys::Poll::Constant|SPVM::Sys::Poll::Constant>
1776  
1777 =item * L<Sys::Poll::PollfdArray|SPVM::Sys::Poll::PollfdArray>
1778  
1779 =item * L<Sys::Process|SPVM::Sys::Process>
1780  
1781 =item * L<Sys::Process::Constant|SPVM::Sys::Process::Constant>
1782  
1783 =item * L<Sys::Select|SPVM::Sys::Select>
1784  
1785 =item * L<Sys::Select::Constant|SPVM::Sys::Select::Constant>
1786  
1787 =item * L<Sys::Select::Fd_set|SPVM::Sys::Select::Fd_set>
1788  
1789 =item * L<Sys::Signal|SPVM::Sys::Signal>
1790  
1791 =item * L<Sys::Signal::Constant|SPVM::Sys::Signal::Constant>
1792  
1793 =item * L<Sys::Signal::Handler|SPVM::Sys::Signal::Handler>
1794  
1795 =item * L<Sys::Socket|SPVM::Sys::Socket>
1796  
1797 =item * L<Sys::Socket::Addrinfo|SPVM::Sys::Socket::Addrinfo>
1798  
1799 =item * L<Sys::Socket::AddrinfoLinkedList|SPVM::Sys::Socket::AddrinfoLinkedList>
1800  
1801 =item * L<Sys::Socket::Constant|SPVM::Sys::Socket::Constant>
1802  
1803 =item * L<Sys::Socket::Errno|SPVM::Sys::Socket::Errno>
1804  
1805 =item * L<Sys::Socket::Error|SPVM::Sys::Socket::Error>
1806  
1807 =item * L<Sys::Socket::Error::InetInvalidNetworkAddress|SPVM::Sys::Socket::Error::InetInvalidNetworkAddress>
1808  
1809 =item * L<Sys::Socket::In6_addr|SPVM::Sys::Socket::In6_addr>
1810  
1811 =item * L<Sys::Socket::In_addr|SPVM::Sys::Socket::In_addr>
1812  
1813 =item * L<Sys::Socket::In_addr_base|SPVM::Sys::Socket::In_addr_base>
1814  
1815 =item * L<Sys::Socket::Ip_mreq|SPVM::Sys::Socket::Ip_mreq>
1816  
1817 =item * L<Sys::Socket::Ip_mreq_source|SPVM::Sys::Socket::Ip_mreq_source>
1818  
1819 =item * L<Sys::Socket::Ipv6_mreq|SPVM::Sys::Socket::Ipv6_mreq>
1820  
1821 =item * L<Sys::Socket::Sockaddr|SPVM::Sys::Socket::Sockaddr>
1822  
1823 =item * L<Sys::Socket::Sockaddr::In|SPVM::Sys::Socket::Sockaddr::In>
1824  
1825 =item * L<Sys::Socket::Sockaddr::In6|SPVM::Sys::Socket::Sockaddr::In6>
1826  
1827 =item * L<Sys::Socket::Sockaddr::Storage|SPVM::Sys::Socket::Sockaddr::Storage>
1828  
1829 =item * L<Sys::Socket::Sockaddr::Un|SPVM::Sys::Socket::Sockaddr::Un>
1830  
1831 =item * L<Sys::Socket::Util|SPVM::Sys::Socket::Util>
1832  
1833 =item * L<Sys::Time|SPVM::Sys::Time>
1834  
1835 =item * L<Sys::Time::Constant|SPVM::Sys::Time::Constant>
1836  
1837 =item * L<Sys::Time::Itimerval|SPVM::Sys::Time::Itimerval>
1838  
1839 =item * L<Sys::Time::Timespec|SPVM::Sys::Time::Timespec>
1840  
1841 =item * L<Sys::Time::Timeval|SPVM::Sys::Time::Timeval>
1842  
1843 =item * L<Sys::Time::Timezone|SPVM::Sys::Time::Timezone>
1844  
1845 =item * L<Sys::Time::Tm|SPVM::Sys::Time::Tm>
1846  
1847 =item * L<Sys::Time::Tms|SPVM::Sys::Time::Tms>
1848  
1849 =item * L<Sys::Time::Util|SPVM::Sys::Time::Util>
1850  
1851 =item * L<Sys::Time::Utimbuf|SPVM::Sys::Time::Utimbuf>
1852  
1853 =item * L<Sys::User|SPVM::Sys::User>
1854  
1855 =item * L<Sys::User::Group|SPVM::Sys::User::Group>
1856  
1857 =item * L<Sys::User::Passwd|SPVM::Sys::User::Passwd>
1858  
1859 =back
1860  
1861 =head1 See Also
1862  
1863 =over 2
1864  
1865 =item * L<IO|SPVM::IO> - File IO, Sockets
1866  
1867 =item * L<File::Spec|SPVM::File::Spec>
1868  
1869 =item * L<File::Temp|SPVM::File::Temp>
1870  
1871 =item * L<File::Copy|SPVM::File::Copy>
1872  
1873 =item * L<File::Find|SPVM::File::Find>
1874  
1875 =item * L<File::Glob|SPVM::File::Glob>
1876  
1877 =item * L<Cwd|SPVM::Cwd>
1878  
1879 =item * L<Time::HiRes|SPVM::Time::HiRes>
1880  
1881 =item * L<Go|SPVM::Go>
1882  
1883 =back
1884  
1885 =head1 Repository
1886  
1887 L<SPVM::Sys - Github|https://github.com/yuki-kimoto/SPVM-Sys>
1888  
1889 =head1 Author
1890  
1891 Yuki Kimoto(L<https://github.com/yuki-kimoto>)
1892  
1893 =head1 Contributors
1894  
1895 Gabor Szabo(L<https://github.com/szabgab>)
1896  
1897 =head1 Copyright & License
1898  
1899 Copyright (c) 2023 Yuki Kimoto
1900  
1901 MIT License