NAME    [Toc]    [Back]

       async_daemon - Create a local NFS asynchronous I/O server

SYNOPSIS    [Toc]    [Back]

       async_daemon(
               unsigned long iod_num,
               unsigned long magic );

PARAMETERS    [Toc]    [Back]

       Specifies  the  number  of  I/O threads to run.  For Tru64
       UNIX, this is 950410. If a different value is used,  seven
       NFS I/O threads are run.

DESCRIPTION    [Toc]    [Back]

       The use of the async_daemon() function is not supported in
       customer applications, and the  interface  is  subject  to
       change  without  notice.  It is intended for use solely by
       nfsiod(8).

       The async_daemon() function starts iod_num NFS I/O  kernel
       threads  that  are  used  to  improve NFS I/O performance.
       This function does not return to the caller,  but  remains
       in  the  kernel to provide additional support for NFS over
       TCP.

RETURN VALUES    [Toc]    [Back]

       The async_daemon() function has no successful return.   In
       fact,  it frees the text and data segments associated with
       the calling program so there is nothing to return to. When
       interrupted  by  a KILL signal, the I/O threads are terminated
 and the process exits. If the  async_daemon()  function
 encounters errors, -1 is returned and errno is set to
       indicate the error.

ERRORS    [Toc]    [Back]

       If the async_daemon() function fails, errno is set to  one
       of  the  following values: The async_daemon() function has
       already been called by another process.  The caller is not
       the  superuser.   More than 64 I/O threads were requested.
       The kernel memory allocator has no memory.

SEE ALSO    [Toc]    [Back]

       Functions: nfssvc(2)

       Commands: nfsiod(8)



                                                  async_daemon(2)