a575963da9
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
382 lines
18 KiB
XML
382 lines
18 KiB
XML
<Type Name="FileHandleOperations" FullName="Mono.Unix.FileHandleOperations">
|
|
<TypeSignature Language="C#" Value="public sealed class FileHandleOperations" />
|
|
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit FileHandleOperations extends System.Object" />
|
|
<AssemblyInfo>
|
|
<AssemblyName>Mono.Posix</AssemblyName>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
|
|
<Base>
|
|
<BaseTypeName>System.Object</BaseTypeName>
|
|
</Base>
|
|
<Interfaces />
|
|
<Docs>
|
|
<summary>Operations that can be performed on a file handle.</summary>
|
|
<remarks>
|
|
The <see cref="T:Mono.Unix.FileHandleOperations" /> class provides
|
|
access to operating system operations that effect file handles, such as
|
|
<see cref="T:System.IO.FileStream" />s,
|
|
<see cref="T:Mono.Unix.UnixStream" />s, and
|
|
Unix file descriptors.
|
|
</remarks>
|
|
</Docs>
|
|
<Members>
|
|
<Member MemberName="AdviseFileAccessPattern">
|
|
<MemberSignature Language="C#" Value="public static void AdviseFileAccessPattern (Mono.Unix.UnixStream stream, Mono.Unix.FileAccessPattern pattern);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void AdviseFileAccessPattern(class Mono.Unix.UnixStream stream, valuetype Mono.Unix.FileAccessPattern pattern) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="stream" Type="Mono.Unix.UnixStream" />
|
|
<Parameter Name="pattern" Type="Mono.Unix.FileAccessPattern" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="stream">File stream to advise.</param>
|
|
<param name="pattern">
|
|
A <see cref="T:Mono.Unix.FileAccessPattern" /> containing the file
|
|
access pattern to suggest.
|
|
</param>
|
|
<summary>Advises a file access pattern for a file stream.</summary>
|
|
<remarks>
|
|
<para>
|
|
<c>AdviseFileAccessPattern</c> is used to announce an intention
|
|
to access file data with a specific pattern, allowing the kernel to
|
|
perform appropriate optimizations.</para>
|
|
<para>
|
|
<paramref name="pattern" /> applies from beginning of file to end
|
|
of file.</para>
|
|
<para>The specified pattern is not binding; it merely constitutes an
|
|
expectation on behalf of the application.</para>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="stream" /> is not a valid file stream.
|
|
</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="advice" /> is not a value.
|
|
</para>
|
|
</exception>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="stream" />
|
|
is <see langword="null" />.</exception>
|
|
<exception cref="T:System.IO.IOException">
|
|
<paramref name="stream" />
|
|
refers to a pipe or FIFO.</exception>
|
|
<altmember cref="M:Mono.Unix.Native.Syscall.posix_fadvise" />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="AdviseFileAccessPattern">
|
|
<MemberSignature Language="C#" Value="public static void AdviseFileAccessPattern (int fd, Mono.Unix.FileAccessPattern pattern);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void AdviseFileAccessPattern(int32 fd, valuetype Mono.Unix.FileAccessPattern pattern) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="fd" Type="System.Int32" />
|
|
<Parameter Name="pattern" Type="Mono.Unix.FileAccessPattern" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="fd">
|
|
A <see cref="T:System.Int32" /> containing the file descriptor to advise.
|
|
</param>
|
|
<param name="pattern">
|
|
A <see cref="T:Mono.Unix.FileAccessPattern" /> containing the file
|
|
access pattern to suggest.
|
|
</param>
|
|
<summary>Advises a file access pattern for a Unix file descriptor.</summary>
|
|
<remarks>
|
|
<para>
|
|
<c>AdviseFileAccessPattern</c> is used to announce an intention
|
|
to access file data with a specific pattern, allowing the kernel to
|
|
perform appropriate optimizations.</para>
|
|
<para>
|
|
<paramref name="pattern" /> applies from beginning of file to end
|
|
of file.</para>
|
|
<para>The specified pattern is not binding; it merely constitutes an
|
|
expectation on behalf of the application.</para>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="fd" /> is not a valid file descriptor.
|
|
</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="advice" /> is not a valid value.
|
|
</para>
|
|
</exception>
|
|
<exception cref="T:System.IO.IOException">
|
|
<paramref name="fd" />
|
|
refers to a pipe or FIFO.</exception>
|
|
<altmember cref="M:Mono.Unix.Native.Syscall.posix_fadvise" />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="AdviseFileAccessPattern">
|
|
<MemberSignature Language="C#" Value="public static void AdviseFileAccessPattern (System.IO.FileStream file, Mono.Unix.FileAccessPattern pattern);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void AdviseFileAccessPattern(class System.IO.FileStream file, valuetype Mono.Unix.FileAccessPattern pattern) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="file" Type="System.IO.FileStream" />
|
|
<Parameter Name="pattern" Type="Mono.Unix.FileAccessPattern" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="file">File stream to advise.</param>
|
|
<param name="pattern">
|
|
A <see cref="T:Mono.Unix.FileAccessPattern" /> containing the file
|
|
access pattern to suggest.
|
|
</param>
|
|
<summary>Advises a file access pattern for a file stream.</summary>
|
|
<remarks>
|
|
<para>
|
|
<c>AdviseFileAccessPattern</c> is used to announce an intention
|
|
to access file data with a specific pattern, allowing the kernel to
|
|
perform appropriate optimizations.</para>
|
|
<para>
|
|
<paramref name="pattern" /> applies from beginning of file to end
|
|
of file.</para>
|
|
<para>The specified pattern is not binding; it merely constitutes an
|
|
expectation on behalf of the application.</para>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="file" /> is not a valid file stream.
|
|
</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="advice" /> is not a valid value.
|
|
</para>
|
|
</exception>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="file" />
|
|
is <see langword="null" />.</exception>
|
|
<exception cref="T:System.IO.IOException">
|
|
<paramref name="file" />
|
|
refers to a pipe or FIFO.</exception>
|
|
<altmember cref="M:Mono.Unix.Native.Syscall.posix_fadvise" />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="AdviseFileAccessPattern">
|
|
<MemberSignature Language="C#" Value="public static void AdviseFileAccessPattern (Mono.Unix.UnixStream stream, Mono.Unix.FileAccessPattern pattern, long offset, long len);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void AdviseFileAccessPattern(class Mono.Unix.UnixStream stream, valuetype Mono.Unix.FileAccessPattern pattern, int64 offset, int64 len) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="stream" Type="Mono.Unix.UnixStream" />
|
|
<Parameter Name="pattern" Type="Mono.Unix.FileAccessPattern" />
|
|
<Parameter Name="offset" Type="System.Int64" />
|
|
<Parameter Name="len" Type="System.Int64" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="stream">File stream to advise.</param>
|
|
<param name="pattern">
|
|
A <see cref="T:Mono.Unix.FileAccessPattern" /> containing the file
|
|
access pattern to suggest.
|
|
</param>
|
|
<param name="offset">
|
|
A <see cref="T:System.Int64" /> containing the start of the range to suggest
|
|
the <paramref name="pattern" /> access pattern.
|
|
</param>
|
|
<param name="len">
|
|
A <see cref="T:System.Int64" /> containing the length of the range
|
|
to suggest the <paramref name="pattern" />
|
|
access pattern. If <c>0</c>, <paramref name="pattern" /> is suggested
|
|
until end-of-file.
|
|
</param>
|
|
<summary>Advises a file access pattern for a file stream.</summary>
|
|
<remarks>
|
|
<para>
|
|
<c>AdviseFileAccessPattern</c> is used to announce an intention
|
|
to access file data with a specific pattern, allowing the kernel to
|
|
perform appropriate optimizations.</para>
|
|
<para>
|
|
<paramref name="pattern" /> applies to a region starting at
|
|
<paramref name="offset" /> and extending for <paramref name="len" />
|
|
bytes (or until end-of-file if <paramref name="len" /> is <c>0</c>)
|
|
within the file specified by <paramref name="stream" />. The specified
|
|
region need not currently exist.</para>
|
|
<para>The specified pattern is not binding; it merely constitutes an
|
|
expectation on behalf of the application.</para>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="stream" /> is not a valid file stream.
|
|
</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="advice" /> is not a value.
|
|
</para>
|
|
</exception>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="stream" /> is <see langword="null" />.</exception>
|
|
<exception cref="T:System.IO.IOException">
|
|
<paramref name="stream" />
|
|
refers to a pipe or FIFO.</exception>
|
|
<altmember cref="M:Mono.Unix.Native.Syscall.posix_fadvise" />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="AdviseFileAccessPattern">
|
|
<MemberSignature Language="C#" Value="public static void AdviseFileAccessPattern (int fd, Mono.Unix.FileAccessPattern pattern, long offset, long len);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void AdviseFileAccessPattern(int32 fd, valuetype Mono.Unix.FileAccessPattern pattern, int64 offset, int64 len) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="fd" Type="System.Int32" />
|
|
<Parameter Name="pattern" Type="Mono.Unix.FileAccessPattern" />
|
|
<Parameter Name="offset" Type="System.Int64" />
|
|
<Parameter Name="len" Type="System.Int64" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="fd">
|
|
A <see cref="T:System.Int32" /> containing the file descriptor to advise.
|
|
</param>
|
|
<param name="pattern">
|
|
A <see cref="T:Mono.Unix.FileAccessPattern" /> containing the file
|
|
access pattern to suggest.
|
|
</param>
|
|
<param name="offset">
|
|
A <see cref="T:System.Int64" /> containing the start of the range to suggest
|
|
the <paramref name="pattern" /> access pattern.
|
|
</param>
|
|
<param name="len">
|
|
A <see cref="T:System.Int64" /> containing the length of the range
|
|
to suggest the <paramref name="pattern" />
|
|
access pattern. If <c>0</c>, <paramref name="pattern" /> is suggested
|
|
until end-of-file.
|
|
</param>
|
|
<summary>Advises a file access pattern for a Unix file descriptor.</summary>
|
|
<remarks>
|
|
<para>
|
|
<c>AdviseFileAccessPattern</c> is used to announce an intention
|
|
to access file data with a specific pattern, allowing the kernel to
|
|
perform appropriate optimizations.</para>
|
|
<para>
|
|
<paramref name="pattern" /> applies to a region starting at
|
|
<paramref name="offset" /> and extending for <paramref name="len" />
|
|
bytes (or until end-of-file if <paramref name="len" /> is <c>0</c>)
|
|
within the file specified by <paramref name="fd" />. The specified
|
|
region need not currently exist.</para>
|
|
<para>The specified pattern is not binding; it merely constitutes an
|
|
expectation on behalf of the application.</para>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="fd" /> is not a valid file descriptor.
|
|
</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="advice" /> is not a valid value.
|
|
</para>
|
|
</exception>
|
|
<exception cref="T:System.IO.IOException">
|
|
<paramref name="fd" />
|
|
refers to a pipe or FIFO.</exception>
|
|
<altmember cref="M:Mono.Unix.Native.Syscall.posix_fadvise" />
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName="AdviseFileAccessPattern">
|
|
<MemberSignature Language="C#" Value="public static void AdviseFileAccessPattern (System.IO.FileStream file, Mono.Unix.FileAccessPattern pattern, long offset, long len);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void AdviseFileAccessPattern(class System.IO.FileStream file, valuetype Mono.Unix.FileAccessPattern pattern, int64 offset, int64 len) cil managed" />
|
|
<MemberType>Method</MemberType>
|
|
<AssemblyInfo>
|
|
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
|
|
<AssemblyVersion>2.0.0.0</AssemblyVersion>
|
|
<AssemblyVersion>4.0.0.0</AssemblyVersion>
|
|
</AssemblyInfo>
|
|
<ReturnValue>
|
|
<ReturnType>System.Void</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters>
|
|
<Parameter Name="file" Type="System.IO.FileStream" />
|
|
<Parameter Name="pattern" Type="Mono.Unix.FileAccessPattern" />
|
|
<Parameter Name="offset" Type="System.Int64" />
|
|
<Parameter Name="len" Type="System.Int64" />
|
|
</Parameters>
|
|
<Docs>
|
|
<param name="file">File stream to advise.</param>
|
|
<param name="pattern">
|
|
A <see cref="T:Mono.Unix.FileAccessPattern" /> containing the file
|
|
access pattern to suggest.
|
|
</param>
|
|
<param name="offset">
|
|
A <see cref="T:System.Int64" /> containing the start of the range to suggest
|
|
the <paramref name="pattern" /> access pattern.
|
|
</param>
|
|
<param name="len">
|
|
A <see cref="T:System.Int64" /> containing the length of the range
|
|
to suggest the <paramref name="pattern" />
|
|
access pattern. If <c>0</c>, <paramref name="pattern" /> is suggested
|
|
until end-of-file.
|
|
</param>
|
|
<summary>Advises a file access pattern for a Unix file descriptor.</summary>
|
|
<remarks>
|
|
<para>
|
|
<c>AdviseFileAccessPattern</c> is used to announce an intention
|
|
to access file data with a specific pattern, allowing the kernel to
|
|
perform appropriate optimizations.</para>
|
|
<para>
|
|
<paramref name="pattern" /> applies to a region starting at
|
|
<paramref name="offset" /> and extending for <paramref name="len" />
|
|
bytes (or until end-of-file if <paramref name="len" /> is <c>0</c>)
|
|
within the file specified by <paramref name="file" />. The specified
|
|
region need not currently exist.</para>
|
|
<para>The specified pattern is not binding; it merely constitutes an
|
|
expectation on behalf of the application.</para>
|
|
</remarks>
|
|
<exception cref="T:System.ArgumentException">
|
|
<para>
|
|
<paramref name="file" /> is not a valid file stream.
|
|
</para>
|
|
<para>-or-</para>
|
|
<para>
|
|
<paramref name="advice" /> is not a valid value.
|
|
</para>
|
|
</exception>
|
|
<exception cref="T:System.ArgumentNullException">
|
|
<paramref name="file" />
|
|
is <see langword="null" />.</exception>
|
|
<exception cref="T:System.IO.IOException">
|
|
<paramref name="file" />
|
|
refers to a pipe or FIFO.</exception>
|
|
<altmember cref="M:Mono.Unix.Native.Syscall.posix_fadvise" />
|
|
</Docs>
|
|
</Member>
|
|
</Members>
|
|
</Type>
|