1 '\" te
   2 .\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH CACHEFSD 1M "Oct 2, 2000"
   7 .SH NAME
   8 cachefsd \- CacheFS daemon
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/fs/cachefs/cachefsd\fR
  13 .fi
  14 
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBcachefsd\fR server implements features of the cache filesystem
  19 (CacheFS). It is invoked at boot time and run if the \fB/\fR (root) and
  20 \fB/usr\fR filesystems are being cached. If \fB/usr\fR is being cached,
  21 \fBcachefsd\fR is invoked by \fBinetd\fR(1M) from \fBinetd.conf\fR(4). At run
  22 time, \fBcachefsd\fR is invoked by the \fBinetd\fR mechanism in response to an
  23 RPC request from a user command such as \fBmount_cachefs\fR(1M).
  24 .sp
  25 .LP
  26 The \fBcachefsd\fR server supports the "disconnected mode" of CacheFS. In this
  27 mode, a user can continue to read and, depending on the option selected, write
  28 to files in a cached filesystem when the NFS server for the cached files is not
  29 available.
  30 .sp
  31 .LP
  32 The \fBcachefsd\fR daemon performs the following functions in support of the
  33 CacheFS:
  34 .RS +4
  35 .TP
  36 .ie t \(bu
  37 .el o
  38 Implements the connection policy. The daemon determines whether the NFS server
  39 backing the cache is connected or disconnected from the cache, or is in
  40 transition from the connected or disconnected states.
  41 .RE
  42 .RS +4
  43 .TP
  44 .ie t \(bu
  45 .el o
  46 Implements "log rolling," wherein the daemon monitors a disconnected NFS server
  47 for reconnection. After such a server returns to a connected state,
  48 \fBcachefsd\fR rolls any local changes to cached files (kept in a log) back to
  49 the server.
  50 .RE
  51 .RS +4
  52 .TP
  53 .ie t \(bu
  54 .el o
  55 Manages "packing," wherein \fBcachefsd\fR makes a best effort to ensure that
  56 files in a user-specified list are available in the cache in disconnected mode.
  57 .RE
  58 .RS +4
  59 .TP
  60 .ie t \(bu
  61 .el o
  62 Supports user interfaces by supplying statistics, reporting conflicts between
  63 the cache and the back filesystem, and supporting a list of files for packing.
  64 .RE
  65 .sp
  66 .LP
  67 The running of \fBcachefsd\fR is required for the disconnected mode of CacheFS.
  68 .SH OPTIONS
  69 .sp
  70 .LP
  71 The following options are supported:
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fB-r\fR\fR
  76 .ad
  77 .RS 6n
  78 Used for invoking \fBcachefsd\fR for the \fB/\fR filesystem.
  79 .RE
  80 
  81 .SH SEE ALSO
  82 .sp
  83 .LP
  84 \fBcachefspack\fR(1M), \fBcfsadmin\fR(1M), \fBmount_cachefs\fR(1M),
  85 \fBinetd.conf\fR(4), \fBattributes\fR(5)
  86 .sp
  87 .LP
  88 \fI\fR