i686-linux-gnu-4.7/usr/include/rpcsvc/mount.x

   1 /* @(#)mount.x  2.1 88/08/01 4.0 RPCSRC */
   2
   3 /*
   4  * Copyright (c) 2010, Oracle America, Inc.
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions are
   7  * met:
   8  *
   9  *     * Redistributions of source code must retain the above copyright
  10  *       notice, this list of conditions and the following disclaimer.
  11  *     * Redistributions in binary form must reproduce the above
  12  *       copyright notice, this list of conditions and the following
  13  *       disclaimer in the documentation and/or other materials
  14  *       provided with the distribution.
  15  *     * Neither the name of the "Oracle America, Inc." nor the names of its
  16  *       contributors may be used to endorse or promote products derived
  17  *       from this software without specific prior written permission.
  18  *
  19  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20  *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21  *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  22  *   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  23  *   COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
  24  *   INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25  *   DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
  26  *   GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  27  *   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  28  *   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  29  *   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  30  *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31  */
  32
  33 /*
  34  * Protocol description for the mount program
  35  */
  36
  37
  38 const MNTPATHLEN = 1024;        /* maximum bytes in a pathname argument */
  39 const MNTNAMLEN = 255;          /* maximum bytes in a name argument */
  40 const FHSIZE = 32;              /* size in bytes of a file handle */
  41
  42 /*
  43  * The fhandle is the file handle that the server passes to the client.
  44  * All file operations are done using the file handles to refer to a file
  45  * or a directory. The file handle can contain whatever information the
  46  * server needs to distinguish an individual file.
  47  */
  48 typedef opaque fhandle[FHSIZE];
  49
  50 /*
  51  * If a status of zero is returned, the call completed successfully, and
  52  * a file handle for the directory follows. A non-zero status indicates
  53  * some sort of error. The status corresponds with UNIX error numbers.
  54  */
  55 union fhstatus switch (unsigned fhs_status) {
  56 case 0:
  57         fhandle fhs_fhandle;
  58 default:
  59         void;
  60 };
  61
  62 /*
  63  * The type dirpath is the pathname of a directory
  64  */
  65 typedef string dirpath<MNTPATHLEN>;
  66
  67 /*
  68  * The type name is used for arbitrary names (hostnames, groupnames)
  69  */
  70 typedef string name<MNTNAMLEN>;
  71
  72 /*
  73  * A list of who has what mounted
  74  */
  75 typedef struct mountbody *mountlist;
  76 struct mountbody {
  77         name ml_hostname;
  78         dirpath ml_directory;
  79         mountlist ml_next;
  80 };
  81
  82 /*
  83  * A list of netgroups
  84  */
  85 typedef struct groupnode *groups;
  86 struct groupnode {
  87         name gr_name;
  88         groups gr_next;
  89 };
  90
  91 /*
  92  * A list of what is exported and to whom
  93  */
  94 typedef struct exportnode *exports;
  95 struct exportnode {
  96         dirpath ex_dir;
  97         groups ex_groups;
  98         exports ex_next;
  99 };
 100
 101 program MOUNTPROG {
 102         /*
 103          * Version one of the mount protocol communicates with version two
 104          * of the NFS protocol. The only connecting point is the fhandle
 105          * structure, which is the same for both protocols.
 106          */
 107         version MOUNTVERS {
 108                 /*
 109                  * Does no work. It is made available in all RPC services
 110                  * to allow server response testing and timing
 111                  */
 112                 void
 113                 MOUNTPROC_NULL(void) = 0;
 114
 115                 /*
 116                  * If fhs_status is 0, then fhs_fhandle contains the
 117                  * file handle for the directory. This file handle may
 118                  * be used in the NFS protocol. This procedure also adds
 119                  * a new entry to the mount list for this client mounting
 120                  * the directory.
 121                  * Unix authentication required.
 122                  */
 123                 fhstatus
 124                 MOUNTPROC_MNT(dirpath) = 1;
 125
 126                 /*
 127                  * Returns the list of remotely mounted filesystems. The
 128                  * mountlist contains one entry for each hostname and
 129                  * directory pair.
 130                  */
 131                 mountlist
 132                 MOUNTPROC_DUMP(void) = 2;
 133
 134                 /*
 135                  * Removes the mount list entry for the directory
 136                  * Unix authentication required.
 137                  */
 138                 void
 139                 MOUNTPROC_UMNT(dirpath) = 3;
 140
 141                 /*
 142                  * Removes all of the mount list entries for this client
 143                  * Unix authentication required.
 144                  */
 145                 void
 146                 MOUNTPROC_UMNTALL(void) = 4;
 147
 148                 /*
 149                  * Returns a list of all the exported filesystems, and which
 150                  * machines are allowed to import it.
 151                  */
 152                 exports
 153                 MOUNTPROC_EXPORT(void)  = 5;
 154
 155                 /*
 156                  * Identical to MOUNTPROC_EXPORT above
 157                  */
 158                 exports
 159                 MOUNTPROC_EXPORTALL(void) = 6;
 160         } = 1;
 161 } = 100005;