incubator-nuttx/fs/nfs/nfs_mount.h

/****************************************************************************
 * fs/nfs/nfs_mount.h
 *
 *   Copyright (C) 2012 Gregory Nutt. All rights reserved.
 *   Copyright (C) 2012 Jose Pablo Rojas Vargas. All rights reserved.
 *   Author: Jose Pablo Rojas Vargas <jrojas@nx-engineering.com>
 *           Gregory Nutt <gnutt@nuttx.org>
 *
 * Leveraged from OpenBSD:
 *
 *  Copyright (c) 1989, 1993
 *  The Regents of the University of California.  All rights reserved.
 *
 * This code is derived from software contributed to Berkeley by
 * Rick Macklem at The University of Guelph.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 4. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 ****************************************************************************/

#ifndef __FS_NFS_NFS_MOUNT_H
#define __FS_NFS_NFS_MOUNT_H

/****************************************************************************
 * Included Files
 ****************************************************************************/

#include <sys/socket.h>
#include <nuttx/mutex.h>

#include "rpc.h"

/****************************************************************************
 * Pre-processor Definitions
 ****************************************************************************/

/****************************************************************************
 * Public Types
 ****************************************************************************/

/* Mount structure. One mount structure is allocated for each NFS mount. This
 * structure holds NFS specific information for mount.
 */

struct nfsmount
{
  FAR struct nfsnode       *nm_head;          /* A list of all files opened on this mountpoint */
  mutex_t                   nm_lock;          /* Used to assure thread-safe access */
  FAR nfsfh_t              *nm_fh;            /* File handle of root dir */
  char                      nm_path[90];      /* server's path of the directory being mounted */
  struct nfs_fattr          nm_fattr;         /* nfs file attribute cache */
  FAR struct rpcclnt       *nm_rpcclnt;       /* RPC state */
  struct sockaddr_storage   nm_nam;           /* Addr of server */
  uint8_t                   nm_fhsize;        /* Size of root file handle (host order) */
  uint16_t                  nm_rsize;         /* Max size of read RPC */
  uint16_t                  nm_wsize;         /* Max size of write RPC */
  uint16_t                  nm_readdirsize;   /* Size of a readdir RPC */
  uint16_t                  nm_buflen;        /* Size of I/O buffer */

  /* Set aside memory on the stack to hold the largest call message.
   * NOTE that for the case of the write call message, it is the reply
   * message that is in this union.
   */

  union
  {
    struct rpc_call_create  create;
    struct rpc_call_lookup  lookup;
    struct rpc_call_read    read;
    struct rpc_call_remove  removef;
    struct rpc_call_rename  renamef;
    struct rpc_call_mkdir   mkdir;
    struct rpc_call_rmdir   rmdir;
    struct rpc_call_readdir readdir;
    struct rpc_call_fs      fsstat;
    struct rpc_call_setattr setattr;
    struct rpc_call_fs      fsinfo;
    struct rpc_reply_write  write;
  } nm_msgbuffer;

  /* I/O buffer (must be a aligned to 32-bit boundaries).  This buffer used
   * for all reply messages EXCEPT for the WRITE RPC. In that case it is used
   * for the WRITE call message that contains the data to be written.  This
   * buffer must be dynamically sized based on the characteristics of the
   * server and upon the configuration of the NuttX network.  It must be
   * sized to hold the largest possible WRITE call message or READ response
   * message.
   */

  uint32_t                  nm_iobuffer[1];   /* Actual size is given by nm_buflen */
};

/* The size of the nfsmount structure will depend on the size of the
 * allocated I/O buffer.
 */

#define SIZEOF_nfsmount(n) (sizeof(struct nfsmount) + ((n + 3) & ~3) - sizeof(uint32_t))

/* Mount parameters structure.
 * This structure is use in nfs_decode_args function before one
 * mount structure is allocated in each NFS mount.
 */

struct nfs_mount_parameters
{
  uint8_t          timeo;                  /* Timeout value (in deciseconds) */
  uint8_t          retry;                  /* Max retries */
  uint16_t         rsize;                  /* Max size of read RPC */
  uint16_t         wsize;                  /* Max size of write RPC */
  uint16_t         readdirsize;            /* Size of a readdir RPC */
};

#endif