5 // Jonathan Pryor (jonpryor@vt.edu)
7 // (C) 2004-2006 Jonathan Pryor
9 // Permission is hereby granted, free of charge, to any person obtaining
10 // a copy of this software and associated documentation files (the
11 // "Software"), to deal in the Software without restriction, including
12 // without limitation the rights to use, copy, modify, merge, publish,
13 // distribute, sublicense, and/or sell copies of the Software, and to
14 // permit persons to whom the Software is furnished to do so, subject to
15 // the following conditions:
17 // The above copyright notice and this permission notice shall be
18 // included in all copies or substantial portions of the Software.
20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
30 using System.Collections;
32 using System.Runtime.InteropServices;
34 using Mono.Unix.Native;
36 namespace Mono.Unix.Native {
41 public enum Errno : int {
42 // errors & their values liberally copied from
43 // FC2 /usr/include/asm/errno.h
45 EPERM = 1, // Operation not permitted
46 ENOENT = 2, // No such file or directory
47 ESRCH = 3, // No such process
48 EINTR = 4, // Interrupted system call
50 ENXIO = 6, // No such device or address
51 E2BIG = 7, // Arg list too long
52 ENOEXEC = 8, // Exec format error
53 EBADF = 9, // Bad file number
54 ECHILD = 10, // No child processes
55 EAGAIN = 11, // Try again
56 ENOMEM = 12, // Out of memory
57 EACCES = 13, // Permission denied
58 EFAULT = 14, // Bad address
59 ENOTBLK = 15, // Block device required
60 EBUSY = 16, // Device or resource busy
61 EEXIST = 17, // File exists
62 EXDEV = 18, // Cross-device link
63 ENODEV = 19, // No such device
64 ENOTDIR = 20, // Not a directory
65 EISDIR = 21, // Is a directory
66 EINVAL = 22, // Invalid argument
67 ENFILE = 23, // File table overflow
68 EMFILE = 24, // Too many open files
69 ENOTTY = 25, // Not a typewriter
70 ETXTBSY = 26, // Text file busy
71 EFBIG = 27, // File too large
72 ENOSPC = 28, // No space left on device
73 ESPIPE = 29, // Illegal seek
74 EROFS = 30, // Read-only file system
75 EMLINK = 31, // Too many links
76 EPIPE = 32, // Broken pipe
77 EDOM = 33, // Math argument out of domain of func
78 ERANGE = 34, // Math result not representable
79 EDEADLK = 35, // Resource deadlock would occur
80 ENAMETOOLONG = 36, // File name too long
81 ENOLCK = 37, // No record locks available
82 ENOSYS = 38, // Function not implemented
83 ENOTEMPTY = 39, // Directory not empty
84 ELOOP = 40, // Too many symbolic links encountered
85 EWOULDBLOCK = EAGAIN, // Operation would block
86 ENOMSG = 42, // No message of desired type
87 EIDRM = 43, // Identifier removed
88 ECHRNG = 44, // Channel number out of range
89 EL2NSYNC = 45, // Level 2 not synchronized
90 EL3HLT = 46, // Level 3 halted
91 EL3RST = 47, // Level 3 reset
92 ELNRNG = 48, // Link number out of range
93 EUNATCH = 49, // Protocol driver not attached
94 ENOCSI = 50, // No CSI structure available
95 EL2HLT = 51, // Level 2 halted
96 EBADE = 52, // Invalid exchange
97 EBADR = 53, // Invalid request descriptor
98 EXFULL = 54, // Exchange full
99 ENOANO = 55, // No anode
100 EBADRQC = 56, // Invalid request code
101 EBADSLT = 57, // Invalid slot
105 EBFONT = 59, // Bad font file format
106 ENOSTR = 60, // Device not a stream
107 ENODATA = 61, // No data available
108 ETIME = 62, // Timer expired
109 ENOSR = 63, // Out of streams resources
110 ENONET = 64, // Machine is not on the network
111 ENOPKG = 65, // Package not installed
112 EREMOTE = 66, // Object is remote
113 ENOLINK = 67, // Link has been severed
114 EADV = 68, // Advertise error
115 ESRMNT = 69, // Srmount error
116 ECOMM = 70, // Communication error on send
117 EPROTO = 71, // Protocol error
118 EMULTIHOP = 72, // Multihop attempted
119 EDOTDOT = 73, // RFS specific error
120 EBADMSG = 74, // Not a data message
121 EOVERFLOW = 75, // Value too large for defined data type
122 ENOTUNIQ = 76, // Name not unique on network
123 EBADFD = 77, // File descriptor in bad state
124 EREMCHG = 78, // Remote address changed
125 ELIBACC = 79, // Can not access a needed shared library
126 ELIBBAD = 80, // Accessing a corrupted shared library
127 ELIBSCN = 81, // .lib section in a.out corrupted
128 ELIBMAX = 82, // Attempting to link in too many shared libraries
129 ELIBEXEC = 83, // Cannot exec a shared library directly
130 EILSEQ = 84, // Illegal byte sequence
131 ERESTART = 85, // Interrupted system call should be restarted
132 ESTRPIPE = 86, // Streams pipe error
133 EUSERS = 87, // Too many users
134 ENOTSOCK = 88, // Socket operation on non-socket
135 EDESTADDRREQ = 89, // Destination address required
136 EMSGSIZE = 90, // Message too long
137 EPROTOTYPE = 91, // Protocol wrong type for socket
138 ENOPROTOOPT = 92, // Protocol not available
139 EPROTONOSUPPORT = 93, // Protocol not supported
140 ESOCKTNOSUPPORT = 94, // Socket type not supported
141 EOPNOTSUPP = 95, // Operation not supported on transport endpoint
142 EPFNOSUPPORT = 96, // Protocol family not supported
143 EAFNOSUPPORT = 97, // Address family not supported by protocol
144 EADDRINUSE = 98, // Address already in use
145 EADDRNOTAVAIL = 99, // Cannot assign requested address
146 ENETDOWN = 100, // Network is down
147 ENETUNREACH = 101, // Network is unreachable
148 ENETRESET = 102, // Network dropped connection because of reset
149 ECONNABORTED = 103, // Software caused connection abort
150 ECONNRESET = 104, // Connection reset by peer
151 ENOBUFS = 105, // No buffer space available
152 EISCONN = 106, // Transport endpoint is already connected
153 ENOTCONN = 107, // Transport endpoint is not connected
154 ESHUTDOWN = 108, // Cannot send after transport endpoint shutdown
155 ETOOMANYREFS = 109, // Too many references: cannot splice
156 ETIMEDOUT = 110, // Connection timed out
157 ECONNREFUSED = 111, // Connection refused
158 EHOSTDOWN = 112, // Host is down
159 EHOSTUNREACH = 113, // No route to host
160 EALREADY = 114, // Operation already in progress
161 EINPROGRESS = 115, // Operation now in progress
162 ESTALE = 116, // Stale NFS file handle
163 EUCLEAN = 117, // Structure needs cleaning
164 ENOTNAM = 118, // Not a XENIX named type file
165 ENAVAIL = 119, // No XENIX semaphores available
166 EISNAM = 120, // Is a named type file
167 EREMOTEIO = 121, // Remote I/O error
168 EDQUOT = 122, // Quota exceeded
170 ENOMEDIUM = 123, // No medium found
171 EMEDIUMTYPE = 124, // Wrong medium type
180 ENOTRECOVERABLE = 131,
182 // OS X-specific values: OS X value + 1000
183 EPROCLIM = 1067, // Too many processes
184 EBADRPC = 1072, // RPC struct is bad
185 ERPCMISMATCH = 1073, // RPC version wrong
186 EPROGUNAVAIL = 1074, // RPC prog. not avail
187 EPROGMISMATCH = 1075, // Program version wrong
188 EPROCUNAVAIL = 1076, // Bad procedure for program
189 EFTYPE = 1079, // Inappropriate file type or format
190 EAUTH = 1080, // Authentication error
191 ENEEDAUTH = 1081, // Need authenticator
192 EPWROFF = 1082, // Device power is off
193 EDEVERR = 1083, // Device error, e.g. paper out
194 EBADEXEC = 1085, // Bad executable
195 EBADARCH = 1086, // Bad CPU type in executable
196 ESHLIBVERS = 1087, // Shared library version mismatch
197 EBADMACHO = 1088, // Malformed Macho file
198 ENOATTR = 1093, // Attribute not found
199 ENOPOLICY = 1103, // No such policy registered
206 public sealed class FilePosition : MarshalByRefObject, IDisposable
207 , IEquatable <FilePosition>
210 private static readonly int FilePositionDumpSize =
211 Stdlib.DumpFilePosition (null, new HandleRef (null, IntPtr.Zero), 0);
213 private HandleRef pos;
215 public FilePosition ()
217 IntPtr p = Stdlib.CreateFilePosition ();
218 if (p == IntPtr.Zero)
219 throw new OutOfMemoryException ("Unable to malloc fpos_t!");
220 pos = new HandleRef (this, p);
223 internal HandleRef Handle {
227 public void Dispose ()
230 GC.SuppressFinalize (this);
233 private void Cleanup ()
235 if (pos.Handle != IntPtr.Zero) {
236 Stdlib.free (pos.Handle);
237 pos = new HandleRef (this, IntPtr.Zero);
241 public override string ToString ()
243 return "(" + base.ToString () + " " + GetDump () + ")";
246 private string GetDump ()
248 if (FilePositionDumpSize <= 0)
249 return "internal error";
251 StringBuilder buf = new StringBuilder (FilePositionDumpSize+1);
253 if (Stdlib.DumpFilePosition (buf, Handle, FilePositionDumpSize+1) <= 0)
254 return "internal error dumping fpos_t";
256 return buf.ToString ();
259 public override bool Equals (object obj)
261 FilePosition fp = obj as FilePosition;
262 if (obj == null || fp == null)
264 return ToString().Equals (obj.ToString());
267 public bool Equals (FilePosition value)
269 if (object.ReferenceEquals (this, value))
271 return ToString().Equals (value.ToString());
274 public override int GetHashCode ()
276 return ToString ().GetHashCode ();
284 public static bool operator== (FilePosition lhs, FilePosition rhs)
286 return Object.Equals (lhs, rhs);
289 public static bool operator!= (FilePosition lhs, FilePosition rhs)
291 return !Object.Equals (lhs, rhs);
296 public enum SignalAction {
303 // Right now using this attribute gives an assert because it
304 // isn't implemented.
306 #if UNMANAGED_FN_PTR_SUPPORT_FIXED
307 [UnmanagedFunctionPointer (CallingConvention.Cdecl)]
309 public delegate void SignalHandler (int signal);
312 internal class XPrintfFunctions
314 internal delegate object XPrintf (object[] parameters);
316 internal static XPrintf printf;
317 internal static XPrintf fprintf;
318 internal static XPrintf snprintf;
319 internal static XPrintf syslog;
321 static XPrintfFunctions ()
323 CdeclFunction _printf = new CdeclFunction (Stdlib.LIBC, "printf", typeof(int));
324 printf = new XPrintf (_printf.Invoke);
326 CdeclFunction _fprintf = new CdeclFunction (Stdlib.LIBC, "fprintf", typeof(int));
327 fprintf = new XPrintf (_fprintf.Invoke);
329 CdeclFunction _snprintf = new CdeclFunction (Stdlib.MPH,
330 "Mono_Posix_Stdlib_snprintf", typeof(int));
331 snprintf = new XPrintf (_snprintf.Invoke);
333 CdeclFunction _syslog = new CdeclFunction (Syscall.MPH,
334 "Mono_Posix_Stdlib_syslog2", typeof(int));
335 syslog = new XPrintf (_syslog.Invoke);
340 // Convention: Functions that are part of the C standard library go here.
342 // For example, the man page should say something similar to:
345 // ISO 9899 (''ANSI C'')
347 // The intent is that members of this class should be portable to any system
348 // supporting the C runtime (read: non-Unix, including Windows). Using
349 // anything from Syscall is non-portable, but restricting yourself to just
350 // Stdlib is intended to be portable.
352 // The only methods in here should be:
353 // (1) low-level functions (as defined above).
354 // (2) "Trivial" function overloads. For example, if the parameters to a
355 // function are related (e.g. fwrite(3))
356 // (3) The return type SHOULD NOT be changed. If you want to provide a
357 // convenience function with a nicer return type, place it into one of
358 // the Mono.Unix.Std* wrapper classes, and give it a .NET-styled name.
359 // - EXCEPTION: No public functions should have a `void' return type.
360 // `void' return types should be replaced with `int'.
361 // Rationality: `void'-return functions typically require a
362 // complicated call sequence, such as clear errno, then call, then
363 // check errno to see if any errors occurred. This sequence can't
364 // be done safely in managed code, as errno may change as part of
365 // the P/Invoke mechanism.
366 // Instead, add a MonoPosixHelper export which does:
369 // return errno == 0 ? 0 : -1;
370 // This lets managed code check the return value in the usual manner.
371 // (4) Exceptions SHOULD NOT be thrown. EXCEPTIONS:
372 // - If you're wrapping *broken* methods which make assumptions about
373 // input data, such as that an argument refers to N bytes of data.
374 // This is currently limited to cuserid(3) and encrypt(3).
375 // - If you call functions which themselves generate exceptions.
376 // This is the case for using NativeConvert, which will throw an
377 // exception if an invalid/unsupported value is used.
381 internal const string LIBC = "msvcrt";
382 internal const string MPH = "MonoPosixHelper";
384 // It is possible for Mono.Posix and MonoPosixHelper to get out of sync,
385 // for example if NuGet does something weird. To mitigate this, anyone
386 // editing Mono.Posix needs to observe two rules:
387 // 1. When introducing C-interface changes to MonoPosixHelper, update
388 // the version strings in VersionCheck below and also
389 // Mono_Unix_VersionString in the C sources.
390 // 2. Any class which performs a DllImport on Stdlib.MPH needs to call
391 // Stdlib.VersionCheck in its static constructor.
393 [DllImport (Stdlib.MPH, CallingConvention=CallingConvention.Cdecl,
394 EntryPoint="Mono_Unix_VersionString")]
395 private static extern IntPtr VersionStringPtr ();
396 private static bool versionCheckPerformed = false;
397 internal static void VersionCheck ()
399 if (versionCheckPerformed)
402 // This string is arbitrary; it matters only that it is unique.
403 string assemblyVersion = "MonoProject-2015-12-1";
404 string nativeVersion = Marshal.PtrToStringAnsi (VersionStringPtr ());
405 if (assemblyVersion != nativeVersion)
407 throw new Exception ("Mono.Posix assembly loaded with a different version (\""
408 + assemblyVersion + "\") than MonoPosixHelper (\"" + nativeVersion
409 + "\"). You may need to reinstall Mono.Posix.");
412 versionCheckPerformed = true;
420 internal Stdlib () {}
422 #region <errno.h> Declarations
424 // <errno.h> -- COMPLETE
427 public static Errno GetLastError ()
429 int errno = Marshal.GetLastWin32Error ();
430 return NativeConvert.ToErrno (errno);
433 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
434 EntryPoint="Mono_Posix_Stdlib_SetLastError")]
435 private static extern void SetLastError (int error);
437 protected static void SetLastError (Errno error)
439 int _error = NativeConvert.FromErrno (error);
440 SetLastError (_error);
448 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
449 EntryPoint="Mono_Posix_Stdlib_InvokeSignalHandler")]
450 internal static extern void InvokeSignalHandler (int signum, IntPtr handler);
452 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
453 EntryPoint="Mono_Posix_Stdlib_SIG_DFL")]
454 private static extern IntPtr GetDefaultSignal ();
456 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
457 EntryPoint="Mono_Posix_Stdlib_SIG_ERR")]
458 private static extern IntPtr GetErrorSignal ();
460 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
461 EntryPoint="Mono_Posix_Stdlib_SIG_IGN")]
462 private static extern IntPtr GetIgnoreSignal ();
464 private static readonly IntPtr _SIG_DFL = GetDefaultSignal ();
465 private static readonly IntPtr _SIG_ERR = GetErrorSignal ();
466 private static readonly IntPtr _SIG_IGN = GetIgnoreSignal ();
468 private static void _ErrorHandler (int signum)
470 Console.Error.WriteLine ("Error handler invoked for signum " +
471 signum + ". Don't do that.");
474 private static void _DefaultHandler (int signum)
476 Console.Error.WriteLine ("Default handler invoked for signum " +
477 signum + ". Don't do that.");
480 private static void _IgnoreHandler (int signum)
482 Console.Error.WriteLine ("Ignore handler invoked for signum " +
483 signum + ". Don't do that.");
486 [CLSCompliant (false)]
487 public static readonly SignalHandler SIG_DFL = new SignalHandler (_DefaultHandler);
488 [CLSCompliant (false)]
489 public static readonly SignalHandler SIG_ERR = new SignalHandler (_ErrorHandler);
490 [CLSCompliant (false)]
491 public static readonly SignalHandler SIG_IGN = new SignalHandler (_IgnoreHandler);
493 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl,
494 SetLastError=true, EntryPoint="signal")]
495 private static extern IntPtr sys_signal (int signum, SignalHandler handler);
497 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl,
498 SetLastError=true, EntryPoint="signal")]
499 private static extern IntPtr sys_signal (int signum, IntPtr handler);
501 [CLSCompliant (false)]
502 [Obsolete ("This is not safe; " +
503 "use Mono.Unix.UnixSignal for signal delivery or SetSignalAction()")]
504 public static SignalHandler signal (Signum signum, SignalHandler handler)
506 int _sig = NativeConvert.FromSignum (signum);
508 Delegate[] handlers = handler.GetInvocationList ();
509 for (int i = 0; i < handlers.Length; ++i) {
510 Marshal.Prelink (handlers [i].Method);
514 if (handler == SIG_DFL)
515 r = sys_signal (_sig, _SIG_DFL);
516 else if (handler == SIG_ERR)
517 r = sys_signal (_sig, _SIG_ERR);
518 else if (handler == SIG_IGN)
519 r = sys_signal (_sig, _SIG_IGN);
521 r = sys_signal (_sig, handler);
522 return TranslateHandler (r);
525 private static SignalHandler TranslateHandler (IntPtr handler)
527 if (handler == _SIG_DFL)
529 if (handler == _SIG_ERR)
531 if (handler == _SIG_IGN)
533 return (SignalHandler) Marshal.GetDelegateForFunctionPointer (handler, typeof(SignalHandler));
536 public static int SetSignalAction (Signum signal, SignalAction action)
538 return SetSignalAction (NativeConvert.FromSignum (signal), action);
541 public static int SetSignalAction (RealTimeSignum rts, SignalAction action)
543 return SetSignalAction (NativeConvert.FromRealTimeSignum (rts), action);
546 private static int SetSignalAction (int signum, SignalAction action)
548 IntPtr handler = IntPtr.Zero;
550 case SignalAction.Default:
553 case SignalAction.Ignore:
556 case SignalAction.Error:
560 throw new ArgumentException ("Invalid action value.", "action");
562 IntPtr r = sys_signal (signum, handler);
568 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, EntryPoint="raise")]
569 private static extern int sys_raise (int sig);
571 [CLSCompliant (false)]
572 public static int raise (Signum sig)
574 return sys_raise (NativeConvert.FromSignum (sig));
577 public static int raise (RealTimeSignum rts)
579 return sys_raise (NativeConvert.FromRealTimeSignum (rts));
583 // <stdio.h> -- COMPLETE except for :
584 // - the scanf(3) family .
585 // - vararg functions.
586 // - Horribly unsafe functions (gets(3)).
588 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
589 EntryPoint="Mono_Posix_Stdlib__IOFBF")]
590 private static extern int GetFullyBuffered ();
592 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
593 EntryPoint="Mono_Posix_Stdlib__IOLBF")]
594 private static extern int GetLineBuffered ();
596 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
597 EntryPoint="Mono_Posix_Stdlib__IONBF")]
598 private static extern int GetNonBuffered ();
600 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
601 EntryPoint="Mono_Posix_Stdlib_BUFSIZ")]
602 private static extern int GetBufferSize ();
604 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
605 EntryPoint="Mono_Posix_Stdlib_CreateFilePosition")]
606 internal static extern IntPtr CreateFilePosition ();
608 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
609 EntryPoint="Mono_Posix_Stdlib_DumpFilePosition")]
610 internal static extern int DumpFilePosition (StringBuilder buf, HandleRef handle, int len);
612 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
613 EntryPoint="Mono_Posix_Stdlib_EOF")]
614 private static extern int GetEOF ();
616 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
617 EntryPoint="Mono_Posix_Stdlib_FILENAME_MAX")]
618 private static extern int GetFilenameMax ();
620 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
621 EntryPoint="Mono_Posix_Stdlib_FOPEN_MAX")]
622 private static extern int GetFopenMax ();
624 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
625 EntryPoint="Mono_Posix_Stdlib_L_tmpnam")]
626 private static extern int GetTmpnamLength ();
628 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
629 EntryPoint="Mono_Posix_Stdlib_stdin")]
630 private static extern IntPtr GetStandardInput ();
632 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
633 EntryPoint="Mono_Posix_Stdlib_stdout")]
634 private static extern IntPtr GetStandardOutput ();
636 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
637 EntryPoint="Mono_Posix_Stdlib_stderr")]
638 private static extern IntPtr GetStandardError ();
640 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
641 EntryPoint="Mono_Posix_Stdlib_TMP_MAX")]
642 private static extern int GetTmpMax ();
644 [CLSCompliant (false)]
645 public static readonly int _IOFBF = GetFullyBuffered ();
646 [CLSCompliant (false)]
647 public static readonly int _IOLBF = GetLineBuffered ();
648 [CLSCompliant (false)]
649 public static readonly int _IONBF = GetNonBuffered ();
650 [CLSCompliant (false)]
651 public static readonly int BUFSIZ = GetBufferSize ();
652 [CLSCompliant (false)]
653 public static readonly int EOF = GetEOF ();
654 [CLSCompliant (false)]
655 public static readonly int FOPEN_MAX = GetFopenMax ();
656 [CLSCompliant (false)]
657 public static readonly int FILENAME_MAX = GetFilenameMax ();
658 [CLSCompliant (false)]
659 public static readonly int L_tmpnam = GetTmpnamLength ();
660 public static readonly IntPtr stderr = GetStandardError ();
661 public static readonly IntPtr stdin = GetStandardInput ();
662 public static readonly IntPtr stdout = GetStandardOutput ();
663 [CLSCompliant (false)]
664 public static readonly int TMP_MAX = GetTmpMax ();
666 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, SetLastError=true)]
667 public static extern int remove (
668 [MarshalAs (UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(FileNameMarshaler))]
671 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, SetLastError=true)]
672 public static extern int rename (
673 [MarshalAs (UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(FileNameMarshaler))]
675 [MarshalAs (UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(FileNameMarshaler))]
678 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
679 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_tmpfile")]
680 public static extern IntPtr tmpfile ();
682 private static object tmpnam_lock = new object ();
684 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl,
685 SetLastError=true, EntryPoint="tmpnam")]
686 private static extern IntPtr sys_tmpnam (StringBuilder s);
688 [Obsolete ("Syscall.mkstemp() should be preferred.")]
689 public static string tmpnam (StringBuilder s)
691 if (s != null && s.Capacity < L_tmpnam)
692 throw new ArgumentOutOfRangeException ("s", "s.Capacity < L_tmpnam");
694 IntPtr r = sys_tmpnam (s);
695 return UnixMarshal.PtrToString (r);
699 [Obsolete ("Syscall.mkstemp() should be preferred.")]
700 public static string tmpnam ()
703 IntPtr r = sys_tmpnam (null);
704 return UnixMarshal.PtrToString (r);
708 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
709 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fclose")]
710 public static extern int fclose (IntPtr stream);
712 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
713 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fflush")]
714 public static extern int fflush (IntPtr stream);
716 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
717 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fopen")]
718 public static extern IntPtr fopen (
719 [MarshalAs (UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(FileNameMarshaler))]
720 string path, string mode);
722 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
723 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_freopen")]
724 public static extern IntPtr freopen (
725 [MarshalAs (UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(FileNameMarshaler))]
726 string path, string mode, IntPtr stream);
728 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
729 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_setbuf")]
730 public static extern int setbuf (IntPtr stream, IntPtr buf);
732 [CLSCompliant (false)]
733 public static unsafe int setbuf (IntPtr stream, byte* buf)
735 return setbuf (stream, (IntPtr) buf);
738 [CLSCompliant (false)]
739 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
740 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_setvbuf")]
741 public static extern int setvbuf (IntPtr stream, IntPtr buf, int mode, ulong size);
743 [CLSCompliant (false)]
744 public static unsafe int setvbuf (IntPtr stream, byte* buf, int mode, ulong size)
746 return setvbuf (stream, (IntPtr) buf, mode, size);
749 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
750 EntryPoint="Mono_Posix_Stdlib_fprintf")]
751 private static extern int sys_fprintf (IntPtr stream, string format, string message);
753 public static int fprintf (IntPtr stream, string message)
755 return sys_fprintf (stream, "%s", message);
758 [Obsolete ("Not necessarily portable due to cdecl restrictions.\n" +
759 "Use fprintf (IntPtr, string) instead.")]
760 public static int fprintf (IntPtr stream, string format, params object[] parameters)
762 object[] _parameters = new object[checked(parameters.Length+2)];
763 _parameters [0] = stream;
764 _parameters [1] = format;
765 Array.Copy (parameters, 0, _parameters, 2, parameters.Length);
766 return (int) XPrintfFunctions.fprintf (_parameters);
769 /* SKIP: fscanf(3) */
771 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl,
772 EntryPoint="printf")]
773 private static extern int sys_printf (string format, string message);
775 public static int printf (string message)
777 return sys_printf ("%s", message);
780 [Obsolete ("Not necessarily portable due to cdecl restrictions.\n" +
781 "Use printf (string) instead.")]
782 public static int printf (string format, params object[] parameters)
784 object[] _parameters = new object[checked(parameters.Length+1)];
785 _parameters [0] = format;
786 Array.Copy (parameters, 0, _parameters, 1, parameters.Length);
787 return (int) XPrintfFunctions.printf (_parameters);
792 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
793 EntryPoint="Mono_Posix_Stdlib_snprintf")]
794 private static extern int sys_snprintf (StringBuilder s, ulong n,
795 string format, string message);
797 [CLSCompliant (false)]
798 public static int snprintf (StringBuilder s, ulong n, string message)
800 if (n > (ulong) s.Capacity)
801 throw new ArgumentOutOfRangeException ("n", "n must be <= s.Capacity");
802 return sys_snprintf (s, n, "%s", message);
805 public static int snprintf (StringBuilder s, string message)
807 return sys_snprintf (s, (ulong) s.Capacity, "%s", message);
810 [CLSCompliant (false)]
811 [Obsolete ("Not necessarily portable due to cdecl restrictions.\n" +
812 "Use snprintf (StringBuilder, string) instead.")]
813 public static int snprintf (StringBuilder s, ulong n,
814 string format, params object[] parameters)
816 if (n > (ulong) s.Capacity)
817 throw new ArgumentOutOfRangeException ("n", "n must be <= s.Capacity");
819 object[] _parameters = new object[checked(parameters.Length+3)];
822 _parameters [2] = format;
823 Array.Copy (parameters, 0, _parameters, 3, parameters.Length);
824 return (int) XPrintfFunctions.snprintf (_parameters);
827 [CLSCompliant (false)]
828 [Obsolete ("Not necessarily portable due to cdecl restrictions.\n" +
829 "Use snprintf (StringBuilder, string) instead.")]
830 public static int snprintf (StringBuilder s,
831 string format, params object[] parameters)
833 object[] _parameters = new object[checked(parameters.Length+3)];
835 _parameters [1] = (ulong) s.Capacity;
836 _parameters [2] = format;
837 Array.Copy (parameters, 0, _parameters, 3, parameters.Length);
838 return (int) XPrintfFunctions.snprintf (_parameters);
854 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
855 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fgetc")]
856 public static extern int fgetc (IntPtr stream);
858 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
859 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fgets")]
860 private static extern IntPtr sys_fgets (StringBuilder sb, int size, IntPtr stream);
862 public static StringBuilder fgets (StringBuilder sb, int size, IntPtr stream)
864 IntPtr r = sys_fgets (sb, size, stream);
865 if (r == IntPtr.Zero)
870 public static StringBuilder fgets (StringBuilder sb, IntPtr stream)
872 return fgets (sb, sb.Capacity, stream);
875 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
876 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fputc")]
877 public static extern int fputc (int c, IntPtr stream);
879 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
880 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fputs")]
881 public static extern int fputs (string s, IntPtr stream);
883 public static int getc (IntPtr stream)
885 return fgetc (stream);
888 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, SetLastError=true)]
889 public static extern int getchar ();
893 public static int putc (int c, IntPtr stream)
895 return fputc (c, stream);
898 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, SetLastError=true)]
899 public static extern int putchar (int c);
901 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, SetLastError=true)]
902 public static extern int puts (string s);
904 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
905 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_ungetc")]
906 public static extern int ungetc (int c, IntPtr stream);
908 [CLSCompliant (false)]
909 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
910 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fread")]
911 public static extern ulong fread (IntPtr ptr, ulong size, ulong nmemb, IntPtr stream);
913 [CLSCompliant (false)]
914 public static unsafe ulong fread (void* ptr, ulong size, ulong nmemb, IntPtr stream)
916 return fread ((IntPtr) ptr, size, nmemb, stream);
919 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
920 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fread")]
921 private static extern ulong sys_fread ([Out] byte[] ptr,
922 ulong size, ulong nmemb, IntPtr stream);
924 [CLSCompliant (false)]
925 public static ulong fread (byte[] ptr, ulong size, ulong nmemb, IntPtr stream)
927 if ((size * nmemb) > (ulong) ptr.Length)
928 throw new ArgumentOutOfRangeException ("nmemb");
929 return sys_fread (ptr, size, nmemb, stream);
932 [CLSCompliant (false)]
933 public static ulong fread (byte[] ptr, IntPtr stream)
935 return fread (ptr, 1, (ulong) ptr.Length, stream);
938 [CLSCompliant (false)]
939 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
940 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fwrite")]
941 public static extern ulong fwrite (IntPtr ptr, ulong size, ulong nmemb, IntPtr stream);
943 [CLSCompliant (false)]
944 public static unsafe ulong fwrite (void* ptr, ulong size, ulong nmemb, IntPtr stream)
946 return fwrite ((IntPtr) ptr, size, nmemb, stream);
949 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
950 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fwrite")]
951 private static extern ulong sys_fwrite (byte[] ptr,
952 ulong size, ulong nmemb, IntPtr stream);
954 [CLSCompliant (false)]
955 public static ulong fwrite (byte[] ptr, ulong size, ulong nmemb, IntPtr stream)
957 if ((size * nmemb) > (ulong) ptr.Length)
958 throw new ArgumentOutOfRangeException ("nmemb");
959 return sys_fwrite (ptr, size, nmemb, stream);
962 [CLSCompliant (false)]
963 public static ulong fwrite (byte[] ptr, IntPtr stream)
965 return fwrite (ptr, 1, (ulong) ptr.Length, stream);
968 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
969 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fgetpos")]
970 private static extern int sys_fgetpos (IntPtr stream, HandleRef pos);
972 public static int fgetpos (IntPtr stream, FilePosition pos)
974 return sys_fgetpos (stream, pos.Handle);
977 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
978 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fseek")]
979 private static extern int sys_fseek (IntPtr stream, long offset, int origin);
981 [CLSCompliant (false)]
982 public static int fseek (IntPtr stream, long offset, SeekFlags origin)
984 int _origin = NativeConvert.FromSeekFlags (origin);
985 return sys_fseek (stream, offset, _origin);
988 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
989 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_fsetpos")]
990 private static extern int sys_fsetpos (IntPtr stream, HandleRef pos);
992 public static int fsetpos (IntPtr stream, FilePosition pos)
994 return sys_fsetpos (stream, pos.Handle);
997 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
998 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_ftell")]
999 public static extern long ftell (IntPtr stream);
1001 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1002 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_rewind")]
1003 public static extern int rewind (IntPtr stream);
1005 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1006 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_clearerr")]
1007 public static extern int clearerr (IntPtr stream);
1009 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1010 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_feof")]
1011 public static extern int feof (IntPtr stream);
1013 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1014 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_ferror")]
1015 public static extern int ferror (IntPtr stream);
1017 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1018 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_perror")]
1019 private static extern int perror (string s, int err);
1021 public static int perror (string s)
1023 return perror (s, Marshal.GetLastWin32Error ());
1029 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1030 EntryPoint="Mono_Posix_Stdlib_EXIT_FAILURE")]
1031 private static extern int GetExitFailure();
1033 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1034 EntryPoint="Mono_Posix_Stdlib_EXIT_SUCCESS")]
1035 private static extern int GetExitSuccess ();
1037 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1038 EntryPoint="Mono_Posix_Stdlib_MB_CUR_MAX")]
1039 private static extern int GetMbCurMax ();
1041 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1042 EntryPoint="Mono_Posix_Stdlib_RAND_MAX")]
1043 private static extern int GetRandMax ();
1045 [CLSCompliant (false)]
1046 public static readonly int EXIT_FAILURE = GetExitFailure ();
1047 [CLSCompliant (false)]
1048 public static readonly int EXIT_SUCCESS = GetExitSuccess ();
1049 [CLSCompliant (false)]
1050 public static readonly int MB_CUR_MAX = GetMbCurMax ();
1051 [CLSCompliant (false)]
1052 public static readonly int RAND_MAX = GetRandMax ();
1054 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl)]
1055 public static extern int rand ();
1057 [CLSCompliant (false)]
1058 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl)]
1059 public static extern void srand (uint seed);
1062 // void *calloc (size_t nmemb, size_t size);
1063 [CLSCompliant (false)]
1064 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1065 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_calloc")]
1066 public static extern IntPtr calloc (ulong nmemb, ulong size);
1068 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1069 EntryPoint="Mono_Posix_Stdlib_free")]
1070 public static extern void free (IntPtr ptr);
1073 // void *malloc(size_t size);
1074 [CLSCompliant (false)]
1075 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1076 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_malloc")]
1077 public static extern IntPtr malloc (ulong size);
1080 // void *realloc(void *ptr, size_t size);
1081 [CLSCompliant (false)]
1082 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1083 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_realloc")]
1084 public static extern IntPtr realloc (IntPtr ptr, ulong size);
1086 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl)]
1087 public static extern void abort ();
1089 /* SKIP: atexit(3) -- the GC should have collected most references by the
1090 * time this runs, so no delegates should exist, making it pointless. */
1092 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl)]
1093 public static extern void exit (int status);
1095 [CLSCompliant (false)]
1096 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl)]
1097 public static extern void _Exit (int status);
1099 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, EntryPoint="getenv")]
1100 private static extern IntPtr sys_getenv (string name);
1102 public static string getenv (string name)
1104 IntPtr r = sys_getenv (name);
1105 return UnixMarshal.PtrToString (r);
1108 [CLSCompliant (false)]
1109 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl, SetLastError=true)]
1110 public static extern int system (string @string);
1116 private static object strerror_lock = new object ();
1118 [DllImport (LIBC, CallingConvention=CallingConvention.Cdecl,
1119 SetLastError=true, EntryPoint="strerror")]
1120 private static extern IntPtr sys_strerror (int errnum);
1122 [CLSCompliant (false)]
1123 public static string strerror (Errno errnum)
1125 int e = NativeConvert.FromErrno (errnum);
1126 lock (strerror_lock) {
1127 IntPtr r = sys_strerror (e);
1128 return UnixMarshal.PtrToString (r);
1133 // size_t strlen(const char *s);
1134 [CLSCompliant (false)]
1135 [DllImport (MPH, CallingConvention=CallingConvention.Cdecl,
1136 SetLastError=true, EntryPoint="Mono_Posix_Stdlib_strlen")]
1137 public static extern ulong strlen (IntPtr s);
1140 #endregion // Classes