HardenedBSD src tree
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

nfsmount.h 4.7 KiB

21 years ago
Implement support for RPCSEC_GSS authentication to both the NFS client and server. This replaces the RPC implementation of the NFS client and server with the newer RPC implementation originally developed (actually ported from the userland sunrpc code) to support the NFS Lock Manager. I have tested this code extensively and I believe it is stable and that performance is at least equal to the legacy RPC implementation. The NFS code currently contains support for both the new RPC implementation and the older legacy implementation inherited from the original NFS codebase. The default is to use the new implementation - add the NFS_LEGACYRPC option to fall back to the old code. When I merge this support back to RELENG_7, I will probably change this so that users have to 'opt in' to get the new code. To use RPCSEC_GSS on either client or server, you must build a kernel which includes the KGSSAPI option and the crypto device. On the userland side, you must build at least a new libc, mountd, mount_nfs and gssd. You must install new versions of /etc/rc.d/gssd and /etc/rc.d/nfsd and add 'gssd_enable=YES' to /etc/rc.conf. As long as gssd is running, you should be able to mount an NFS filesystem from a server that requires RPCSEC_GSS authentication. The mount itself can happen without any kerberos credentials but all access to the filesystem will be denied unless the accessing user has a valid ticket file in the standard place (/tmp/krb5cc_<uid>). There is currently no support for situations where the ticket file is in a different place, such as when the user logged in via SSH and has delegated credentials from that login. This restriction is also present in Solaris and Linux. In theory, we could improve this in future, possibly using Brooks Davis' implementation of variant symlinks. Supporting RPCSEC_GSS on a server is nearly as simple. You must create service creds for the server in the form 'nfs/<fqdn>@<REALM>' and install them in /etc/krb5.keytab. The standard heimdal utility ktutil makes this fairly easy. After the service creds have been created, you can add a '-sec=krb5' option to /etc/exports and restart both mountd and nfsd. The only other difference an administrator should notice is that nfsd doesn't fork to create service threads any more. In normal operation, there will be two nfsd processes, one in userland waiting for TCP connections and one in the kernel handling requests. The latter process will create as many kthreads as required - these should be visible via 'top -H'. The code has some support for varying the number of service threads according to load but initially at least, nfsd uses a fixed number of threads according to the value supplied to its '-n' option. Sponsored by: Isilon Systems MFC after: 1 month
12 years ago
Implement support for RPCSEC_GSS authentication to both the NFS client and server. This replaces the RPC implementation of the NFS client and server with the newer RPC implementation originally developed (actually ported from the userland sunrpc code) to support the NFS Lock Manager. I have tested this code extensively and I believe it is stable and that performance is at least equal to the legacy RPC implementation. The NFS code currently contains support for both the new RPC implementation and the older legacy implementation inherited from the original NFS codebase. The default is to use the new implementation - add the NFS_LEGACYRPC option to fall back to the old code. When I merge this support back to RELENG_7, I will probably change this so that users have to 'opt in' to get the new code. To use RPCSEC_GSS on either client or server, you must build a kernel which includes the KGSSAPI option and the crypto device. On the userland side, you must build at least a new libc, mountd, mount_nfs and gssd. You must install new versions of /etc/rc.d/gssd and /etc/rc.d/nfsd and add 'gssd_enable=YES' to /etc/rc.conf. As long as gssd is running, you should be able to mount an NFS filesystem from a server that requires RPCSEC_GSS authentication. The mount itself can happen without any kerberos credentials but all access to the filesystem will be denied unless the accessing user has a valid ticket file in the standard place (/tmp/krb5cc_<uid>). There is currently no support for situations where the ticket file is in a different place, such as when the user logged in via SSH and has delegated credentials from that login. This restriction is also present in Solaris and Linux. In theory, we could improve this in future, possibly using Brooks Davis' implementation of variant symlinks. Supporting RPCSEC_GSS on a server is nearly as simple. You must create service creds for the server in the form 'nfs/<fqdn>@<REALM>' and install them in /etc/krb5.keytab. The standard heimdal utility ktutil makes this fairly easy. After the service creds have been created, you can add a '-sec=krb5' option to /etc/exports and restart both mountd and nfsd. The only other difference an administrator should notice is that nfsd doesn't fork to create service threads any more. In normal operation, there will be two nfsd processes, one in userland waiting for TCP connections and one in the kernel handling requests. The latter process will create as many kthreads as required - these should be visible via 'top -H'. The code has some support for varying the number of service threads according to load but initially at least, nfsd uses a fixed number of threads according to the value supplied to its '-n' option. Sponsored by: Isilon Systems MFC after: 1 month
12 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. /*-
  2. * SPDX-License-Identifier: BSD-3-Clause
  3. *
  4. * Copyright (c) 1989, 1993
  5. * The Regents of the University of California. All rights reserved.
  6. *
  7. * This code is derived from software contributed to Berkeley by
  8. * Rick Macklem at The University of Guelph.
  9. *
  10. * Redistribution and use in source and binary forms, with or without
  11. * modification, are permitted provided that the following conditions
  12. * are met:
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions and the following disclaimer.
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in the
  17. * documentation and/or other materials provided with the distribution.
  18. * 3. Neither the name of the University nor the names of its contributors
  19. * may be used to endorse or promote products derived from this software
  20. * without specific prior written permission.
  21. *
  22. * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  23. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25. * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31. * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32. * SUCH DAMAGE.
  33. *
  34. * @(#)nfsmount.h 8.3 (Berkeley) 3/30/95
  35. * $FreeBSD$
  36. */
  37. #ifndef _NFSCLIENT_NFSMOUNT_H_
  38. #define _NFSCLIENT_NFSMOUNT_H_
  39. #include <sys/socket.h>
  40. #include <nfs/nfs_mountcommon.h>
  41. #include <rpc/types.h>
  42. #include <rpc/auth.h>
  43. #include <rpc/clnt.h>
  44. #include <rpc/rpcsec_gss.h>
  45. /*
  46. * Mount structure.
  47. * One allocated on every NFS mount.
  48. * Holds NFS specific information for mount.
  49. */
  50. struct nfsmount {
  51. struct nfsmount_common nm_com; /* Common fields for nlm */
  52. int nm_numgrps; /* Max. size of groupslist */
  53. u_char nm_fh[NFSX_V4FH]; /* File handle of root dir */
  54. int nm_fhsize; /* Size of root file handle */
  55. int nm_sotype; /* Type of socket */
  56. int nm_soproto; /* and protocol */
  57. int nm_soflags; /* pr_flags for socket protocol */
  58. struct sockaddr *nm_nam; /* Addr of server */
  59. int nm_deadthresh; /* Threshold of timeouts-->dead server*/
  60. int nm_rsize; /* Max size of read rpc */
  61. int nm_wsize; /* Max size of write rpc */
  62. int nm_readdirsize; /* Size of a readdir rpc */
  63. int nm_readahead; /* Num. of blocks to readahead */
  64. int nm_wcommitsize; /* Max size of commit for write */
  65. int nm_acdirmin; /* Directory attr cache min lifetime */
  66. int nm_acdirmax; /* Directory attr cache max lifetime */
  67. int nm_acregmin; /* Reg file attr cache min lifetime */
  68. int nm_acregmax; /* Reg file attr cache max lifetime */
  69. u_char nm_verf[NFSX_V3WRITEVERF]; /* V3 write verifier */
  70. TAILQ_HEAD(, buf) nm_bufq; /* async io buffer queue */
  71. short nm_bufqlen; /* number of buffers in queue */
  72. short nm_bufqwant; /* process wants to add to the queue */
  73. int nm_bufqiods; /* number of iods processing queue */
  74. u_int64_t nm_maxfilesize; /* maximum file size */
  75. struct nfs_rpcops *nm_rpcops;
  76. int nm_tprintf_initial_delay; /* initial delay */
  77. int nm_tprintf_delay; /* interval for messages */
  78. int nm_secflavor; /* auth flavor to use for rpc */
  79. struct __rpc_client *nm_client;
  80. struct rpc_timers nm_timers[NFS_MAX_TIMER]; /* RTT Timers for rpcs */
  81. char nm_principal[MNAMELEN]; /* GSS-API principal of server */
  82. gss_OID nm_mech_oid; /* OID of selected GSS-API mechanism */
  83. int nm_nametimeo; /* timeout for +ve entries (sec) */
  84. int nm_negnametimeo; /* timeout for -ve entries (sec) */
  85. /* NFSv4 */
  86. uint64_t nm_clientid;
  87. fsid_t nm_fsid;
  88. u_int nm_lease_time;
  89. time_t nm_last_renewal;
  90. };
  91. #define nm_mtx nm_com.nmcom_mtx
  92. #define nm_flag nm_com.nmcom_flag
  93. #define nm_state nm_com.nmcom_state
  94. #define nm_mountp nm_com.nmcom_mountp
  95. #define nm_timeo nm_com.nmcom_timeo
  96. #define nm_retry nm_com.nmcom_retry
  97. #define nm_hostname nm_com.nmcom_hostname
  98. #define nm_getinfo nm_com.nmcom_getinfo
  99. #define nm_vinvalbuf nm_com.nmcom_vinvalbuf
  100. #if defined(_KERNEL)
  101. /*
  102. * Convert mount ptr to nfsmount ptr.
  103. */
  104. #define VFSTONFS(mp) ((struct nfsmount *)((mp)->mnt_data))
  105. #ifndef NFS_TPRINTF_INITIAL_DELAY
  106. #define NFS_TPRINTF_INITIAL_DELAY 12
  107. #endif
  108. #ifndef NFS_TPRINTF_DELAY
  109. #define NFS_TPRINTF_DELAY 30
  110. #endif
  111. #ifndef NFS_DEFAULT_NAMETIMEO
  112. #define NFS_DEFAULT_NAMETIMEO 60
  113. #endif
  114. #ifndef NFS_DEFAULT_NEGNAMETIMEO
  115. #define NFS_DEFAULT_NEGNAMETIMEO 60
  116. #endif
  117. #endif
  118. #endif