1 6f4d00ee 2013-09-23 0intro .TH FOSSILCONS 8
   2 6f4d00ee 2013-09-23 0intro .SH NAME
   3 6f4d00ee 2013-09-23 0intro fossilcons \- fossil console commands
   4 6f4d00ee 2013-09-23 0intro .SH SYNOPSIS
   5 6f4d00ee 2013-09-23 0intro .B
   6 6f4d00ee 2013-09-23 0intro con /srv/fscons
   7 6f4d00ee 2013-09-23 0intro .PP
   8 6f4d00ee 2013-09-23 0intro .PD 0.1
   9 6f4d00ee 2013-09-23 0intro .B .
  10 6f4d00ee 2013-09-23 0intro .I file
  11 6f4d00ee 2013-09-23 0intro .PP
  12 6f4d00ee 2013-09-23 0intro .B 9p
  13 6f4d00ee 2013-09-23 0intro .I T-message
  14 6f4d00ee 2013-09-23 0intro ...
  15 6f4d00ee 2013-09-23 0intro .PP
  16 6f4d00ee 2013-09-23 0intro .B bind
  17 6f4d00ee 2013-09-23 0intro [
  18 6f4d00ee 2013-09-23 0intro .B -b|-a|-c|-bc|-ac
  19 6f4d00ee 2013-09-23 0intro ]
  20 6f4d00ee 2013-09-23 0intro .I new
  21 6f4d00ee 2013-09-23 0intro .I old
  22 6f4d00ee 2013-09-23 0intro .PP
  23 6f4d00ee 2013-09-23 0intro .B dflag
  24 6f4d00ee 2013-09-23 0intro .PP
  25 6f4d00ee 2013-09-23 0intro .B echo
  26 6f4d00ee 2013-09-23 0intro [
  27 6f4d00ee 2013-09-23 0intro .B -n
  28 6f4d00ee 2013-09-23 0intro ]
  29 6f4d00ee 2013-09-23 0intro [
  30 6f4d00ee 2013-09-23 0intro .I arg
  31 6f4d00ee 2013-09-23 0intro ...
  32 6f4d00ee 2013-09-23 0intro ]
  33 6f4d00ee 2013-09-23 0intro .PP
  34 6f4d00ee 2013-09-23 0intro .B listen
  35 6f4d00ee 2013-09-23 0intro [
  36 6f4d00ee 2013-09-23 0intro .B -INd
  37 6f4d00ee 2013-09-23 0intro ]
  38 6f4d00ee 2013-09-23 0intro [
  39 6f4d00ee 2013-09-23 0intro .I address
  40 6f4d00ee 2013-09-23 0intro ]
  41 6f4d00ee 2013-09-23 0intro .PP
  42 6f4d00ee 2013-09-23 0intro .B msg
  43 6f4d00ee 2013-09-23 0intro [
  44 6f4d00ee 2013-09-23 0intro .B -m
  45 6f4d00ee 2013-09-23 0intro .I nmsg
  46 6f4d00ee 2013-09-23 0intro ]
  47 6f4d00ee 2013-09-23 0intro [
  48 6f4d00ee 2013-09-23 0intro .B -p
  49 6f4d00ee 2013-09-23 0intro .I nproc
  50 6f4d00ee 2013-09-23 0intro ]
  51 6f4d00ee 2013-09-23 0intro .PP
  52 6f4d00ee 2013-09-23 0intro .B printconfig
  53 6f4d00ee 2013-09-23 0intro .PP
  54 6f4d00ee 2013-09-23 0intro .B srv
  55 6f4d00ee 2013-09-23 0intro [
  56 6f4d00ee 2013-09-23 0intro .B -APWdp
  57 6f4d00ee 2013-09-23 0intro ]
  58 6f4d00ee 2013-09-23 0intro .I name
  59 6f4d00ee 2013-09-23 0intro .PP
  60 6f4d00ee 2013-09-23 0intro .B uname
  61 6f4d00ee 2013-09-23 0intro .I name
  62 6f4d00ee 2013-09-23 0intro [
  63 6f4d00ee 2013-09-23 0intro .I id
  64 6f4d00ee 2013-09-23 0intro |
  65 6f4d00ee 2013-09-23 0intro .BI : id
  66 6f4d00ee 2013-09-23 0intro |
  67 6f4d00ee 2013-09-23 0intro .BI % newname
  68 6f4d00ee 2013-09-23 0intro |
  69 6f4d00ee 2013-09-23 0intro .BI = leader
  70 6f4d00ee 2013-09-23 0intro |
  71 6f4d00ee 2013-09-23 0intro .BI + member
  72 6f4d00ee 2013-09-23 0intro |
  73 6f4d00ee 2013-09-23 0intro .BI - member
  74 6f4d00ee 2013-09-23 0intro ]
  75 6f4d00ee 2013-09-23 0intro .PP
  76 6f4d00ee 2013-09-23 0intro .B users
  77 6f4d00ee 2013-09-23 0intro [
  78 6f4d00ee 2013-09-23 0intro .B -d
  79 6f4d00ee 2013-09-23 0intro |
  80 6f4d00ee 2013-09-23 0intro .B -r
  81 6f4d00ee 2013-09-23 0intro .I file
  82 6f4d00ee 2013-09-23 0intro ]
  83 6f4d00ee 2013-09-23 0intro [
  84 6f4d00ee 2013-09-23 0intro .B -w
  85 6f4d00ee 2013-09-23 0intro ]
  86 6f4d00ee 2013-09-23 0intro .PP
  87 6f4d00ee 2013-09-23 0intro .B who
  88 6f4d00ee 2013-09-23 0intro .sp
  89 6f4d00ee 2013-09-23 0intro .PP
  90 6f4d00ee 2013-09-23 0intro .B fsys
  91 6f4d00ee 2013-09-23 0intro .I name
  92 6f4d00ee 2013-09-23 0intro .PP
  93 6f4d00ee 2013-09-23 0intro .B fsys
  94 6f4d00ee 2013-09-23 0intro .I name
  95 6f4d00ee 2013-09-23 0intro .B config
  96 6f4d00ee 2013-09-23 0intro [
  97 6f4d00ee 2013-09-23 0intro .I device
  98 6f4d00ee 2013-09-23 0intro ]
  99 6f4d00ee 2013-09-23 0intro .PP
 100 6f4d00ee 2013-09-23 0intro .B fsys
 101 6f4d00ee 2013-09-23 0intro .I name
 102 6f4d00ee 2013-09-23 0intro .B venti
 103 6f4d00ee 2013-09-23 0intro [
 104 6f4d00ee 2013-09-23 0intro .I host
 105 6f4d00ee 2013-09-23 0intro ]
 106 6f4d00ee 2013-09-23 0intro .PP
 107 6f4d00ee 2013-09-23 0intro .B fsys
 108 6f4d00ee 2013-09-23 0intro .I name
 109 6f4d00ee 2013-09-23 0intro .B open
 110 6f4d00ee 2013-09-23 0intro [
 111 6f4d00ee 2013-09-23 0intro .B -APVWar
 112 6f4d00ee 2013-09-23 0intro ]
 113 6f4d00ee 2013-09-23 0intro [
 114 6f4d00ee 2013-09-23 0intro .B -c
 115 6f4d00ee 2013-09-23 0intro .I ncache
 116 6f4d00ee 2013-09-23 0intro ]
 117 6f4d00ee 2013-09-23 0intro .PP
 118 6f4d00ee 2013-09-23 0intro [
 119 6f4d00ee 2013-09-23 0intro .B fsys
 120 6f4d00ee 2013-09-23 0intro .I name
 121 6f4d00ee 2013-09-23 0intro ]
 122 6f4d00ee 2013-09-23 0intro .B close
 123 6f4d00ee 2013-09-23 0intro .PP
 124 6f4d00ee 2013-09-23 0intro .B fsys
 125 6f4d00ee 2013-09-23 0intro .I name
 126 6f4d00ee 2013-09-23 0intro .B unconfig
 127 6f4d00ee 2013-09-23 0intro .sp
 128 6f4d00ee 2013-09-23 0intro .PP
 129 6f4d00ee 2013-09-23 0intro [
 130 6f4d00ee 2013-09-23 0intro .B fsys
 131 6f4d00ee 2013-09-23 0intro .I name
 132 6f4d00ee 2013-09-23 0intro ]
 133 6f4d00ee 2013-09-23 0intro .B bfree
 134 6f4d00ee 2013-09-23 0intro .I addr
 135 6f4d00ee 2013-09-23 0intro .PP
 136 6f4d00ee 2013-09-23 0intro [
 137 6f4d00ee 2013-09-23 0intro .B fsys
 138 6f4d00ee 2013-09-23 0intro .I name
 139 6f4d00ee 2013-09-23 0intro ]
 140 6f4d00ee 2013-09-23 0intro .B block
 141 6f4d00ee 2013-09-23 0intro .I addr
 142 6f4d00ee 2013-09-23 0intro .I offset
 143 6f4d00ee 2013-09-23 0intro [
 144 6f4d00ee 2013-09-23 0intro .I count
 145 6f4d00ee 2013-09-23 0intro [
 146 6f4d00ee 2013-09-23 0intro .I data
 147 6f4d00ee 2013-09-23 0intro ]]
 148 6f4d00ee 2013-09-23 0intro .PP
 149 6f4d00ee 2013-09-23 0intro .in +1i
 150 6f4d00ee 2013-09-23 0intro .ti -1i
 151 6f4d00ee 2013-09-23 0intro [
 152 6f4d00ee 2013-09-23 0intro .B fsys
 153 6f4d00ee 2013-09-23 0intro .I name
 154 6f4d00ee 2013-09-23 0intro ]
 155 6f4d00ee 2013-09-23 0intro .B check
 156 6f4d00ee 2013-09-23 0intro [
 157 6f4d00ee 2013-09-23 0intro .B pblock
 158 6f4d00ee 2013-09-23 0intro ] [
 159 6f4d00ee 2013-09-23 0intro .B pdir
 160 6f4d00ee 2013-09-23 0intro ] [
 161 6f4d00ee 2013-09-23 0intro .B pfile
 162 6f4d00ee 2013-09-23 0intro ] [
 163 6f4d00ee 2013-09-23 0intro .B bclose
 164 6f4d00ee 2013-09-23 0intro ] [
 165 6f4d00ee 2013-09-23 0intro .B clri
 166 6f4d00ee 2013-09-23 0intro ] [
 167 6f4d00ee 2013-09-23 0intro .B clre
 168 6f4d00ee 2013-09-23 0intro ] [
 169 6f4d00ee 2013-09-23 0intro .B clrp
 170 6f4d00ee 2013-09-23 0intro ] [
 171 6f4d00ee 2013-09-23 0intro .B fix
 172 6f4d00ee 2013-09-23 0intro ] [
 173 6f4d00ee 2013-09-23 0intro .B venti
 174 6f4d00ee 2013-09-23 0intro ] [
 175 6f4d00ee 2013-09-23 0intro .B snapshot
 176 6f4d00ee 2013-09-23 0intro ]
 177 6f4d00ee 2013-09-23 0intro .PP
 178 6f4d00ee 2013-09-23 0intro [
 179 6f4d00ee 2013-09-23 0intro .B fsys
 180 6f4d00ee 2013-09-23 0intro .I name
 181 6f4d00ee 2013-09-23 0intro ]
 182 6f4d00ee 2013-09-23 0intro .B clre
 183 6f4d00ee 2013-09-23 0intro .I addr
 184 6f4d00ee 2013-09-23 0intro .I offsets
 185 6f4d00ee 2013-09-23 0intro \&...
 186 6f4d00ee 2013-09-23 0intro .PP
 187 6f4d00ee 2013-09-23 0intro [
 188 6f4d00ee 2013-09-23 0intro .B fsys
 189 6f4d00ee 2013-09-23 0intro .I name
 190 6f4d00ee 2013-09-23 0intro ]
 191 6f4d00ee 2013-09-23 0intro .B clri
 192 6f4d00ee 2013-09-23 0intro .I files
 193 6f4d00ee 2013-09-23 0intro \&...
 194 6f4d00ee 2013-09-23 0intro .PP
 195 6f4d00ee 2013-09-23 0intro [
 196 6f4d00ee 2013-09-23 0intro .B fsys
 197 6f4d00ee 2013-09-23 0intro .I name
 198 6f4d00ee 2013-09-23 0intro ]
 199 6f4d00ee 2013-09-23 0intro .B clrp
 200 6f4d00ee 2013-09-23 0intro .I addr
 201 6f4d00ee 2013-09-23 0intro .I offset
 202 6f4d00ee 2013-09-23 0intro \&...
 203 6f4d00ee 2013-09-23 0intro .PP
 204 6f4d00ee 2013-09-23 0intro [
 205 6f4d00ee 2013-09-23 0intro .B fsys
 206 6f4d00ee 2013-09-23 0intro .I name
 207 6f4d00ee 2013-09-23 0intro ]
 208 6f4d00ee 2013-09-23 0intro .B create
 209 6f4d00ee 2013-09-23 0intro .I path
 210 6f4d00ee 2013-09-23 0intro .I uid
 211 6f4d00ee 2013-09-23 0intro .I gid
 212 6f4d00ee 2013-09-23 0intro .I perm
 213 6f4d00ee 2013-09-23 0intro .PP
 214 6f4d00ee 2013-09-23 0intro [
 215 6f4d00ee 2013-09-23 0intro .B fsys
 216 6f4d00ee 2013-09-23 0intro .I name
 217 6f4d00ee 2013-09-23 0intro ]
 218 6f4d00ee 2013-09-23 0intro .B df
 219 6f4d00ee 2013-09-23 0intro .PP
 220 6f4d00ee 2013-09-23 0intro [
 221 6f4d00ee 2013-09-23 0intro .B fsys
 222 6f4d00ee 2013-09-23 0intro .I name
 223 6f4d00ee 2013-09-23 0intro ]
 224 6f4d00ee 2013-09-23 0intro .B epoch
 225 6f4d00ee 2013-09-23 0intro [[
 226 6f4d00ee 2013-09-23 0intro .B -ry
 227 6f4d00ee 2013-09-23 0intro ]
 228 6f4d00ee 2013-09-23 0intro .I n
 229 6f4d00ee 2013-09-23 0intro ]
 230 6f4d00ee 2013-09-23 0intro .PP
 231 6f4d00ee 2013-09-23 0intro [
 232 6f4d00ee 2013-09-23 0intro .B fsys
 233 6f4d00ee 2013-09-23 0intro .I name
 234 6f4d00ee 2013-09-23 0intro ]
 235 6f4d00ee 2013-09-23 0intro .B halt
 236 6f4d00ee 2013-09-23 0intro .PP
 237 6f4d00ee 2013-09-23 0intro [
 238 6f4d00ee 2013-09-23 0intro .B fsys
 239 6f4d00ee 2013-09-23 0intro .I name
 240 6f4d00ee 2013-09-23 0intro ]
 241 6f4d00ee 2013-09-23 0intro .B label
 242 6f4d00ee 2013-09-23 0intro .I addr
 243 6f4d00ee 2013-09-23 0intro [
 244 6f4d00ee 2013-09-23 0intro .I type
 245 6f4d00ee 2013-09-23 0intro .I state
 246 6f4d00ee 2013-09-23 0intro .I epoch
 247 6f4d00ee 2013-09-23 0intro .I epochclose
 248 6f4d00ee 2013-09-23 0intro .I tag
 249 6f4d00ee 2013-09-23 0intro ]
 250 6f4d00ee 2013-09-23 0intro .PP
 251 6f4d00ee 2013-09-23 0intro [
 252 6f4d00ee 2013-09-23 0intro .B fsys
 253 6f4d00ee 2013-09-23 0intro .I name
 254 6f4d00ee 2013-09-23 0intro ]
 255 6f4d00ee 2013-09-23 0intro .B remove
 256 6f4d00ee 2013-09-23 0intro .I files
 257 6f4d00ee 2013-09-23 0intro \&...
 258 6f4d00ee 2013-09-23 0intro .PP
 259 6f4d00ee 2013-09-23 0intro [
 260 6f4d00ee 2013-09-23 0intro .B fsys
 261 6f4d00ee 2013-09-23 0intro .I name
 262 6f4d00ee 2013-09-23 0intro ]
 263 6f4d00ee 2013-09-23 0intro .B snap
 264 6f4d00ee 2013-09-23 0intro [
 265 6f4d00ee 2013-09-23 0intro .B -a
 266 6f4d00ee 2013-09-23 0intro ]
 267 6f4d00ee 2013-09-23 0intro [
 268 6f4d00ee 2013-09-23 0intro .B -s
 269 6f4d00ee 2013-09-23 0intro .I src
 270 6f4d00ee 2013-09-23 0intro ]
 271 6f4d00ee 2013-09-23 0intro [
 272 6f4d00ee 2013-09-23 0intro .B -d
 273 6f4d00ee 2013-09-23 0intro .I dst
 274 6f4d00ee 2013-09-23 0intro ]
 275 6f4d00ee 2013-09-23 0intro .PP
 276 6f4d00ee 2013-09-23 0intro [
 277 6f4d00ee 2013-09-23 0intro .B fsys
 278 6f4d00ee 2013-09-23 0intro .I name
 279 6f4d00ee 2013-09-23 0intro ]
 280 6f4d00ee 2013-09-23 0intro .B snapclean
 281 6f4d00ee 2013-09-23 0intro [
 282 6f4d00ee 2013-09-23 0intro .I timeout
 283 6f4d00ee 2013-09-23 0intro ]
 284 6f4d00ee 2013-09-23 0intro .PP
 285 6f4d00ee 2013-09-23 0intro [
 286 6f4d00ee 2013-09-23 0intro .B fsys
 287 6f4d00ee 2013-09-23 0intro .I name
 288 6f4d00ee 2013-09-23 0intro ]
 289 6f4d00ee 2013-09-23 0intro .B snaptime
 290 6f4d00ee 2013-09-23 0intro [
 291 6f4d00ee 2013-09-23 0intro .B -a
 292 6f4d00ee 2013-09-23 0intro .I hhmm
 293 6f4d00ee 2013-09-23 0intro ]
 294 6f4d00ee 2013-09-23 0intro [
 295 6f4d00ee 2013-09-23 0intro .B -s
 296 6f4d00ee 2013-09-23 0intro .I interval
 297 6f4d00ee 2013-09-23 0intro ]
 298 6f4d00ee 2013-09-23 0intro [
 299 6f4d00ee 2013-09-23 0intro .B -t
 300 6f4d00ee 2013-09-23 0intro .I timeout
 301 6f4d00ee 2013-09-23 0intro ]
 302 6f4d00ee 2013-09-23 0intro .PP
 303 6f4d00ee 2013-09-23 0intro [
 304 6f4d00ee 2013-09-23 0intro .B fsys
 305 6f4d00ee 2013-09-23 0intro .I name
 306 6f4d00ee 2013-09-23 0intro ]
 307 6f4d00ee 2013-09-23 0intro .B stat
 308 6f4d00ee 2013-09-23 0intro .IR files ...
 309 6f4d00ee 2013-09-23 0intro .PP
 310 6f4d00ee 2013-09-23 0intro [
 311 6f4d00ee 2013-09-23 0intro .B fsys
 312 6f4d00ee 2013-09-23 0intro .I name
 313 6f4d00ee 2013-09-23 0intro ]
 314 6f4d00ee 2013-09-23 0intro .B sync
 315 6f4d00ee 2013-09-23 0intro .PP
 316 6f4d00ee 2013-09-23 0intro [
 317 6f4d00ee 2013-09-23 0intro .B fsys
 318 6f4d00ee 2013-09-23 0intro .I name
 319 6f4d00ee 2013-09-23 0intro ]
 320 6f4d00ee 2013-09-23 0intro .B unhalt
 321 6f4d00ee 2013-09-23 0intro .PP
 322 6f4d00ee 2013-09-23 0intro [
 323 6f4d00ee 2013-09-23 0intro .B fsys
 324 6f4d00ee 2013-09-23 0intro .I name
 325 6f4d00ee 2013-09-23 0intro ]
 326 6f4d00ee 2013-09-23 0intro .B vac
 327 6f4d00ee 2013-09-23 0intro .I dir
 328 6f4d00ee 2013-09-23 0intro .PP
 329 6f4d00ee 2013-09-23 0intro [
 330 6f4d00ee 2013-09-23 0intro .B fsys
 331 6f4d00ee 2013-09-23 0intro .I name
 332 6f4d00ee 2013-09-23 0intro ]
 333 6f4d00ee 2013-09-23 0intro .B wstat
 334 6f4d00ee 2013-09-23 0intro .I file
 335 6f4d00ee 2013-09-23 0intro .I elem
 336 6f4d00ee 2013-09-23 0intro .I uid
 337 6f4d00ee 2013-09-23 0intro .I gid
 338 6f4d00ee 2013-09-23 0intro .I perm
 339 6f4d00ee 2013-09-23 0intro .I length
 340 6f4d00ee 2013-09-23 0intro .SH DESCRIPTION
 341 6f4d00ee 2013-09-23 0intro These are configuration and maintenance commands
 342 6f4d00ee 2013-09-23 0intro executed at the console of a 
 343 d32deab1 2020-08-16 rsc .MR fossil (4)
 344 6f4d00ee 2013-09-23 0intro file server.
 345 6f4d00ee 2013-09-23 0intro The commands are split into three groups above:
 346 6f4d00ee 2013-09-23 0intro file server configuration,
 347 6f4d00ee 2013-09-23 0intro file system configuration,
 348 6f4d00ee 2013-09-23 0intro and file system maintenance.
 349 6f4d00ee 2013-09-23 0intro This manual page is split in the same way.
 350 6f4d00ee 2013-09-23 0intro .SS File server configuration
 351 6f4d00ee 2013-09-23 0intro .PP
 352 6f4d00ee 2013-09-23 0intro The
 353 6f4d00ee 2013-09-23 0intro dot
 354 6f4d00ee 2013-09-23 0intro .RI ( . )
 355 6f4d00ee 2013-09-23 0intro command
 356 6f4d00ee 2013-09-23 0intro reads
 357 6f4d00ee 2013-09-23 0intro .IR file ,
 358 6f4d00ee 2013-09-23 0intro treating each line as a command to be executed.
 359 6f4d00ee 2013-09-23 0intro Blank lines and lines beginning with a 
 360 6f4d00ee 2013-09-23 0intro .L #
 361 6f4d00ee 2013-09-23 0intro character are ignored.
 362 6f4d00ee 2013-09-23 0intro Errors during execution are printed but do not stop the script.
 363 6f4d00ee 2013-09-23 0intro Note that
 364 6f4d00ee 2013-09-23 0intro .I file
 365 6f4d00ee 2013-09-23 0intro is a file in the name space in which
 366 6f4d00ee 2013-09-23 0intro .I fossil
 367 6f4d00ee 2013-09-23 0intro was started,
 368 6f4d00ee 2013-09-23 0intro .I not
 369 6f4d00ee 2013-09-23 0intro a file in any file system served by
 370 6f4d00ee 2013-09-23 0intro .IR fossil .
 371 6f4d00ee 2013-09-23 0intro .PP
 372 6f4d00ee 2013-09-23 0intro .I 9p
 373 6f4d00ee 2013-09-23 0intro executes a 9P transaction; the arguments
 374 6f4d00ee 2013-09-23 0intro are in the same format used by
 375 d32deab1 2020-08-16 rsc .MR 9pcon (8) .
 376 6f4d00ee 2013-09-23 0intro .PP
 377 6f4d00ee 2013-09-23 0intro .I Bind
 378 6f4d00ee 2013-09-23 0intro behaves similarly to
 379 d32deab1 2020-08-16 rsc .MR bind (1) .
 380 6f4d00ee 2013-09-23 0intro It is useful when fossil
 381 6f4d00ee 2013-09-23 0intro is started without devices it needs configured
 382 6f4d00ee 2013-09-23 0intro into its namespace.
 383 6f4d00ee 2013-09-23 0intro .PP
 384 6f4d00ee 2013-09-23 0intro .I Dflag
 385 6f4d00ee 2013-09-23 0intro toggles the debug flag and prints the new setting.
 386 6f4d00ee 2013-09-23 0intro When the debug flag is set, all protocol messages
 387 6f4d00ee 2013-09-23 0intro and information about authentication is printed to
 388 6f4d00ee 2013-09-23 0intro standard error.
 389 6f4d00ee 2013-09-23 0intro .PP
 390 6f4d00ee 2013-09-23 0intro .I Echo
 391 6f4d00ee 2013-09-23 0intro behaves identically to
 392 d32deab1 2020-08-16 rsc .MR echo (1) ,
 393 6f4d00ee 2013-09-23 0intro writing to the console.
 394 6f4d00ee 2013-09-23 0intro .PP
 395 6f4d00ee 2013-09-23 0intro .I Listen
 396 6f4d00ee 2013-09-23 0intro manages the network addresses at which
 397 6f4d00ee 2013-09-23 0intro fossil is listening.
 398 6f4d00ee 2013-09-23 0intro With no arguments,
 399 6f4d00ee 2013-09-23 0intro .I listen
 400 6f4d00ee 2013-09-23 0intro prints the current list of addresses and their network directories.
 401 6f4d00ee 2013-09-23 0intro With one argument, listen
 402 6f4d00ee 2013-09-23 0intro .I address
 403 6f4d00ee 2013-09-23 0intro starts a new listener at
 404 6f4d00ee 2013-09-23 0intro .IR address ;
 405 6f4d00ee 2013-09-23 0intro the
 406 6f4d00ee 2013-09-23 0intro .B -d
 407 6f4d00ee 2013-09-23 0intro flag causes 
 408 6f4d00ee 2013-09-23 0intro .I listen
 409 6f4d00ee 2013-09-23 0intro to remove the listener
 410 6f4d00ee 2013-09-23 0intro at the given address.
 411 6f4d00ee 2013-09-23 0intro By default, the user
 412 6f4d00ee 2013-09-23 0intro .I none
 413 6f4d00ee 2013-09-23 0intro is only allowed to attach on a connection after
 414 6f4d00ee 2013-09-23 0intro at least one other user has successfully attached.
 415 6f4d00ee 2013-09-23 0intro The
 416 6f4d00ee 2013-09-23 0intro .B -N
 417 6f4d00ee 2013-09-23 0intro flag allows connections from
 418 6f4d00ee 2013-09-23 0intro .I none
 419 6f4d00ee 2013-09-23 0intro at any time.
 420 6f4d00ee 2013-09-23 0intro The
 421 6f4d00ee 2013-09-23 0intro .B -I
 422 6f4d00ee 2013-09-23 0intro flag causes
 423 6f4d00ee 2013-09-23 0intro .I fossil
 424 6f4d00ee 2013-09-23 0intro to check the IP address of incoming connections
 425 6f4d00ee 2013-09-23 0intro against
 426 6f4d00ee 2013-09-23 0intro .BR /mnt/ipok ,
 427 6f4d00ee 2013-09-23 0intro rejecting attaches from disallowed addresses.
 428 6f4d00ee 2013-09-23 0intro This mechanism is not intended for general use.
 429 6f4d00ee 2013-09-23 0intro The server
 430 6f4d00ee 2013-09-23 0intro .I sources.cs.bell-labs.com
 431 6f4d00ee 2013-09-23 0intro uses it to comply with U.S. crytography
 432 6f4d00ee 2013-09-23 0intro export regulations.
 433 6f4d00ee 2013-09-23 0intro .PP
 434 6f4d00ee 2013-09-23 0intro .I Msg
 435 6f4d00ee 2013-09-23 0intro prints the maximum internal 9P message queue size
 436 6f4d00ee 2013-09-23 0intro and the maximum number of 9P processes to
 437 6f4d00ee 2013-09-23 0intro allocate for serving the queue.
 438 6f4d00ee 2013-09-23 0intro The
 439 6f4d00ee 2013-09-23 0intro .B -m
 440 6f4d00ee 2013-09-23 0intro and
 441 6f4d00ee 2013-09-23 0intro .B -p
 442 6f4d00ee 2013-09-23 0intro options set the two variables.
 443 6f4d00ee 2013-09-23 0intro .PP
 444 6f4d00ee 2013-09-23 0intro .I Printconfig
 445 6f4d00ee 2013-09-23 0intro prints the
 446 6f4d00ee 2013-09-23 0intro .B config
 447 6f4d00ee 2013-09-23 0intro line for each configured file system
 448 6f4d00ee 2013-09-23 0intro and prints the
 449 6f4d00ee 2013-09-23 0intro .B venti
 450 6f4d00ee 2013-09-23 0intro line, if any, used to configure this file server.
 451 6f4d00ee 2013-09-23 0intro .PP
 452 6f4d00ee 2013-09-23 0intro .I Srv
 453 6f4d00ee 2013-09-23 0intro behaves like listen but uses
 454 6f4d00ee 2013-09-23 0intro .BI /srv/ name
 455 6f4d00ee 2013-09-23 0intro rather than a network address.
 456 6f4d00ee 2013-09-23 0intro With the
 457 6f4d00ee 2013-09-23 0intro .B -p
 458 6f4d00ee 2013-09-23 0intro flag, 
 459 6f4d00ee 2013-09-23 0intro .I srv 
 460 6f4d00ee 2013-09-23 0intro edits a list of console services rather than 9P services.
 461 6f4d00ee 2013-09-23 0intro With no arguments,
 462 6f4d00ee 2013-09-23 0intro .I srv
 463 6f4d00ee 2013-09-23 0intro prints the current list of services.
 464 6f4d00ee 2013-09-23 0intro With one argument, srv
 465 6f4d00ee 2013-09-23 0intro .I name
 466 6f4d00ee 2013-09-23 0intro starts a new service at
 467 6f4d00ee 2013-09-23 0intro .IR /srv/name ;
 468 6f4d00ee 2013-09-23 0intro the
 469 6f4d00ee 2013-09-23 0intro .B -d
 470 6f4d00ee 2013-09-23 0intro flag causes 
 471 6f4d00ee 2013-09-23 0intro .I srv
 472 6f4d00ee 2013-09-23 0intro to remove the named service.
 473 6f4d00ee 2013-09-23 0intro See the
 474 6f4d00ee 2013-09-23 0intro .I [fsys] open
 475 6f4d00ee 2013-09-23 0intro command below for a description of the
 476 6f4d00ee 2013-09-23 0intro .B -APW
 477 6f4d00ee 2013-09-23 0intro options.
 478 6f4d00ee 2013-09-23 0intro .PP
 479 6f4d00ee 2013-09-23 0intro .I Uname
 480 6f4d00ee 2013-09-23 0intro manipulates entries in the user table.
 481 6f4d00ee 2013-09-23 0intro There is no distinction between users and groups:
 482 6f4d00ee 2013-09-23 0intro a user is a group with one member.
 483 6f4d00ee 2013-09-23 0intro For each user, the user table records:
 484 6f4d00ee 2013-09-23 0intro .TF \fImembers
 485 6f4d00ee 2013-09-23 0intro .PD
 486 6f4d00ee 2013-09-23 0intro .TP
 487 6f4d00ee 2013-09-23 0intro .I id
 488 6f4d00ee 2013-09-23 0intro the string used to represent this user in the on-disk structures
 489 6f4d00ee 2013-09-23 0intro .TP
 490 6f4d00ee 2013-09-23 0intro .I name
 491 6f4d00ee 2013-09-23 0intro the string used to represent this user in the 9P protocol
 492 6f4d00ee 2013-09-23 0intro .TP
 493 6f4d00ee 2013-09-23 0intro .I leader
 494 b546bd6e 2017-07-16 rsc the group's leader (see Plan 9's
 495 d32deab1 2020-08-16 rsc .MR stat (5)
 496 6f4d00ee 2013-09-23 0intro for a description of the special privileges held by a group leader)
 497 6f4d00ee 2013-09-23 0intro .TP
 498 6f4d00ee 2013-09-23 0intro .I members
 499 6f4d00ee 2013-09-23 0intro a comma-separated list of members in this group
 500 6f4d00ee 2013-09-23 0intro .PP
 501 6f4d00ee 2013-09-23 0intro The
 502 6f4d00ee 2013-09-23 0intro .I id
 503 6f4d00ee 2013-09-23 0intro and
 504 6f4d00ee 2013-09-23 0intro .I name
 505 6f4d00ee 2013-09-23 0intro are usually the same string, but need not be.
 506 6f4d00ee 2013-09-23 0intro Once an
 507 6f4d00ee 2013-09-23 0intro .I id
 508 6f4d00ee 2013-09-23 0intro is used in file system structures archived to Venti,
 509 6f4d00ee 2013-09-23 0intro it is impossible to change those disk structures,
 510 6f4d00ee 2013-09-23 0intro and thus impossible to rename the
 511 6f4d00ee 2013-09-23 0intro .IR id .
 512 6f4d00ee 2013-09-23 0intro The translation from
 513 6f4d00ee 2013-09-23 0intro .I name
 514 6f4d00ee 2013-09-23 0intro to
 515 6f4d00ee 2013-09-23 0intro .I id
 516 6f4d00ee 2013-09-23 0intro allows the appearance of renaming the user even
 517 6f4d00ee 2013-09-23 0intro though the on-disk structures still record the old name.
 518 6f4d00ee 2013-09-23 0intro (In a conventional Unix file system, the
 519 6f4d00ee 2013-09-23 0intro .I id
 520 6f4d00ee 2013-09-23 0intro is stored as a small integer rather than a string.)
 521 6f4d00ee 2013-09-23 0intro .I Leader
 522 6f4d00ee 2013-09-23 0intro and
 523 6f4d00ee 2013-09-23 0intro .I members
 524 6f4d00ee 2013-09-23 0intro are names, not ids.
 525 6f4d00ee 2013-09-23 0intro .PP
 526 6f4d00ee 2013-09-23 0intro The first argument to
 527 6f4d00ee 2013-09-23 0intro .I uname
 528 6f4d00ee 2013-09-23 0intro is the
 529 6f4d00ee 2013-09-23 0intro .I name
 530 6f4d00ee 2013-09-23 0intro of a user.
 531 6f4d00ee 2013-09-23 0intro The second argument is a verb, one of:
 532 6f4d00ee 2013-09-23 0intro .TF \fI%newname
 533 6f4d00ee 2013-09-23 0intro .PD
 534 6f4d00ee 2013-09-23 0intro .TP
 535 6f4d00ee 2013-09-23 0intro .I id
 536 6f4d00ee 2013-09-23 0intro create a user with name
 537 6f4d00ee 2013-09-23 0intro .RI ` name '
 538 6f4d00ee 2013-09-23 0intro and id
 539 6f4d00ee 2013-09-23 0intro .RI ` id ;'
 540 6f4d00ee 2013-09-23 0intro also create a home directory
 541 6f4d00ee 2013-09-23 0intro .BI /active/usr/ uname \fR
 542 6f4d00ee 2013-09-23 0intro .TP
 543 6f4d00ee 2013-09-23 0intro .BI : id
 544 6f4d00ee 2013-09-23 0intro create a user with name
 545 6f4d00ee 2013-09-23 0intro .RI ` name '
 546 6f4d00ee 2013-09-23 0intro and id
 547 6f4d00ee 2013-09-23 0intro .RI ` id ,'
 548 6f4d00ee 2013-09-23 0intro but do not create a home directory
 549 6f4d00ee 2013-09-23 0intro .TP
 550 6f4d00ee 2013-09-23 0intro .BI % newname
 551 6f4d00ee 2013-09-23 0intro rename user
 552 6f4d00ee 2013-09-23 0intro .RI ` name '
 553 6f4d00ee 2013-09-23 0intro to
 554 6f4d00ee 2013-09-23 0intro .RI ` newname ,'
 555 6f4d00ee 2013-09-23 0intro throughout the user table
 556 6f4d00ee 2013-09-23 0intro .TP
 557 6f4d00ee 2013-09-23 0intro .BI = leader
 558 6f4d00ee 2013-09-23 0intro set
 559 6f4d00ee 2013-09-23 0intro .IR name 's
 560 6f4d00ee 2013-09-23 0intro group leader
 561 6f4d00ee 2013-09-23 0intro to
 562 6f4d00ee 2013-09-23 0intro .IR leader .
 563 6f4d00ee 2013-09-23 0intro .TP
 564 6f4d00ee 2013-09-23 0intro .BI =
 565 6f4d00ee 2013-09-23 0intro remove
 566 6f4d00ee 2013-09-23 0intro .IR name 's
 567 6f4d00ee 2013-09-23 0intro group leader; then all members will be
 568 6f4d00ee 2013-09-23 0intro considered leaders
 569 6f4d00ee 2013-09-23 0intro .TP
 570 6f4d00ee 2013-09-23 0intro .BI + member
 571 6f4d00ee 2013-09-23 0intro add
 572 6f4d00ee 2013-09-23 0intro .I member
 573 6f4d00ee 2013-09-23 0intro to
 574 6f4d00ee 2013-09-23 0intro .IR name 's
 575 6f4d00ee 2013-09-23 0intro list of members
 576 6f4d00ee 2013-09-23 0intro .TP
 577 6f4d00ee 2013-09-23 0intro .BI - member
 578 6f4d00ee 2013-09-23 0intro remove
 579 6f4d00ee 2013-09-23 0intro .I member
 580 6f4d00ee 2013-09-23 0intro from
 581 6f4d00ee 2013-09-23 0intro .IR name 's
 582 6f4d00ee 2013-09-23 0intro list of members
 583 6f4d00ee 2013-09-23 0intro .LP
 584 6f4d00ee 2013-09-23 0intro If the verb is omitted, the entire entry for
 585 6f4d00ee 2013-09-23 0intro .I name
 586 6f4d00ee 2013-09-23 0intro is printed, in the form
 587 6f4d00ee 2013-09-23 0intro `\fIid\fL:\fIname\fL:\fIleader\fL:\fImembers\fR.'
 588 6f4d00ee 2013-09-23 0intro .LP
 589 6f4d00ee 2013-09-23 0intro The end of this manual page gives examples.
 590 6f4d00ee 2013-09-23 0intro .PP
 591 6f4d00ee 2013-09-23 0intro .I Users
 592 6f4d00ee 2013-09-23 0intro manipulates the user table.
 593 6f4d00ee 2013-09-23 0intro The user table is a list of lines in the form printed
 594 6f4d00ee 2013-09-23 0intro by the
 595 6f4d00ee 2013-09-23 0intro .I uname
 596 6f4d00ee 2013-09-23 0intro command.
 597 6f4d00ee 2013-09-23 0intro The
 598 6f4d00ee 2013-09-23 0intro .B -d
 599 6f4d00ee 2013-09-23 0intro flag resets the user table with the default:
 600 6f4d00ee 2013-09-23 0intro .IP
 601 6f4d00ee 2013-09-23 0intro .EX
 602 6f4d00ee 2013-09-23 0intro adm:adm:adm:sys
 603 6f4d00ee 2013-09-23 0intro none:none::
 604 6f4d00ee 2013-09-23 0intro noworld:noworld::
 605 6f4d00ee 2013-09-23 0intro sys:sys::
 606 6f4d00ee 2013-09-23 0intro glenda:glenda:glenda:
 607 6f4d00ee 2013-09-23 0intro .EE
 608 6f4d00ee 2013-09-23 0intro .PP
 609 6f4d00ee 2013-09-23 0intro Except
 610 6f4d00ee 2013-09-23 0intro .BR glenda ,
 611 6f4d00ee 2013-09-23 0intro these users are mandatory: they must appear in all user
 612 6f4d00ee 2013-09-23 0intro files and cannot be renamed.
 613 6f4d00ee 2013-09-23 0intro .PP
 614 6f4d00ee 2013-09-23 0intro The
 615 6f4d00ee 2013-09-23 0intro .B -r
 616 6f4d00ee 2013-09-23 0intro flag reads a user table from the named
 617 6f4d00ee 2013-09-23 0intro .I file
 618 6f4d00ee 2013-09-23 0intro in file system
 619 6f4d00ee 2013-09-23 0intro .BR main .
 620 6f4d00ee 2013-09-23 0intro The
 621 6f4d00ee 2013-09-23 0intro .B -w
 622 6f4d00ee 2013-09-23 0intro flag writes the table to
 623 6f4d00ee 2013-09-23 0intro .B /active/adm/users
 624 6f4d00ee 2013-09-23 0intro on the file system
 625 6f4d00ee 2013-09-23 0intro .BR main .
 626 6f4d00ee 2013-09-23 0intro .B /active/adm
 627 6f4d00ee 2013-09-23 0intro and
 628 6f4d00ee 2013-09-23 0intro .B /active/adm/users
 629 6f4d00ee 2013-09-23 0intro will be created if they do not exist.
 630 6f4d00ee 2013-09-23 0intro .PP
 631 6f4d00ee 2013-09-23 0intro .I Users
 632 6f4d00ee 2013-09-23 0intro .B -r
 633 6f4d00ee 2013-09-23 0intro .B /active/adm/users
 634 6f4d00ee 2013-09-23 0intro is automatically executed when the file system
 635 6f4d00ee 2013-09-23 0intro .B main
 636 6f4d00ee 2013-09-23 0intro is opened.
 637 6f4d00ee 2013-09-23 0intro .PP
 638 6f4d00ee 2013-09-23 0intro .I Users
 639 6f4d00ee 2013-09-23 0intro .B -w
 640 6f4d00ee 2013-09-23 0intro is automatically executed after each change to the user
 641 6f4d00ee 2013-09-23 0intro table by the
 642 6f4d00ee 2013-09-23 0intro .I uname
 643 6f4d00ee 2013-09-23 0intro command.
 644 6f4d00ee 2013-09-23 0intro .PP
 645 6f4d00ee 2013-09-23 0intro .I Who
 646 6f4d00ee 2013-09-23 0intro prints a list of users attached to each active connection.
 647 6f4d00ee 2013-09-23 0intro .SS File system configuration
 648 6f4d00ee 2013-09-23 0intro .I Fsys
 649 6f4d00ee 2013-09-23 0intro sets the current file system to
 650 6f4d00ee 2013-09-23 0intro .IR name ,
 651 6f4d00ee 2013-09-23 0intro which must be configured and open (q.v.).
 652 6f4d00ee 2013-09-23 0intro The current file system name is
 653 6f4d00ee 2013-09-23 0intro displayed as the file server prompt.
 654 6f4d00ee 2013-09-23 0intro The special name
 655 6f4d00ee 2013-09-23 0intro .B all
 656 6f4d00ee 2013-09-23 0intro stands for all file systems;
 657 6f4d00ee 2013-09-23 0intro commands applied to
 658 6f4d00ee 2013-09-23 0intro .B all
 659 6f4d00ee 2013-09-23 0intro are applied to each file system in turn.
 660 6f4d00ee 2013-09-23 0intro The commands
 661 6f4d00ee 2013-09-23 0intro .BR config ,
 662 6f4d00ee 2013-09-23 0intro .BR open ,
 663 6f4d00ee 2013-09-23 0intro .BR venti ,
 664 6f4d00ee 2013-09-23 0intro and
 665 6f4d00ee 2013-09-23 0intro .B close
 666 6f4d00ee 2013-09-23 0intro cannot be applied to
 667 6f4d00ee 2013-09-23 0intro .BR all .
 668 6f4d00ee 2013-09-23 0intro .PP
 669 6f4d00ee 2013-09-23 0intro .I Fsys
 670 6f4d00ee 2013-09-23 0intro takes as an optional argument
 671 6f4d00ee 2013-09-23 0intro (after
 672 6f4d00ee 2013-09-23 0intro .BR name )
 673 6f4d00ee 2013-09-23 0intro a command to execute on the named file system.
 674 6f4d00ee 2013-09-23 0intro Most commands require that the named file system
 675 6f4d00ee 2013-09-23 0intro be configured and open; these commands can be invoked
 676 6f4d00ee 2013-09-23 0intro without the
 677 6f4d00ee 2013-09-23 0intro .BI fsys " name
 678 6f4d00ee 2013-09-23 0intro prefix, in which case the current file system is used.
 679 6f4d00ee 2013-09-23 0intro A few commands
 680 6f4d00ee 2013-09-23 0intro .RB ( config ,
 681 6f4d00ee 2013-09-23 0intro .BR open ,
 682 6f4d00ee 2013-09-23 0intro and
 683 6f4d00ee 2013-09-23 0intro .BR unconfig )
 684 6f4d00ee 2013-09-23 0intro operate on unopened file systems; they require the prefix.
 685 6f4d00ee 2013-09-23 0intro .PP
 686 6f4d00ee 2013-09-23 0intro .I Config
 687 6f4d00ee 2013-09-23 0intro creates a new file system named
 688 6f4d00ee 2013-09-23 0intro .I name
 689 6f4d00ee 2013-09-23 0intro using disk file
 690 6f4d00ee 2013-09-23 0intro .IR device .
 691 6f4d00ee 2013-09-23 0intro This just adds an entry to fossil's internal table.
 692 6f4d00ee 2013-09-23 0intro If
 693 6f4d00ee 2013-09-23 0intro .I device
 694 6f4d00ee 2013-09-23 0intro is missing,
 695 6f4d00ee 2013-09-23 0intro the
 696 6f4d00ee 2013-09-23 0intro .I file
 697 6f4d00ee 2013-09-23 0intro argument to
 698 6f4d00ee 2013-09-23 0intro .IR fossil 's
 699 6f4d00ee 2013-09-23 0intro .B -f
 700 6f4d00ee 2013-09-23 0intro option will be used instead;
 701 6f4d00ee 2013-09-23 0intro this allows the
 702 6f4d00ee 2013-09-23 0intro .I fossil
 703 6f4d00ee 2013-09-23 0intro configuration file to avoid naming the partition that it is embedded in,
 704 6f4d00ee 2013-09-23 0intro making it more portable.
 705 6f4d00ee 2013-09-23 0intro .PP
 706 6f4d00ee 2013-09-23 0intro .I Venti
 707 6f4d00ee 2013-09-23 0intro establishes a connection to the Venti server
 708 6f4d00ee 2013-09-23 0intro .I host
 709 6f4d00ee 2013-09-23 0intro (by default, the environment variable
 710 6f4d00ee 2013-09-23 0intro .B $venti
 711 6f4d00ee 2013-09-23 0intro or the network variable
 712 6f4d00ee 2013-09-23 0intro .BR $venti )
 713 6f4d00ee 2013-09-23 0intro for use by the named file system.
 714 6f4d00ee 2013-09-23 0intro If no
 715 6f4d00ee 2013-09-23 0intro .I venti
 716 6f4d00ee 2013-09-23 0intro command is issued before
 717 6f4d00ee 2013-09-23 0intro .IR open ,
 718 6f4d00ee 2013-09-23 0intro the default Venti server will be used.
 719 6f4d00ee 2013-09-23 0intro If the file system is open,
 720 6f4d00ee 2013-09-23 0intro and was not opened with the
 721 6f4d00ee 2013-09-23 0intro .B -V
 722 6f4d00ee 2013-09-23 0intro flag,
 723 6f4d00ee 2013-09-23 0intro the command redials the Venti server.
 724 6f4d00ee 2013-09-23 0intro This can be used to reestablish broken connections.
 725 6f4d00ee 2013-09-23 0intro It is not a good idea to use the command to switch
 726 6f4d00ee 2013-09-23 0intro between Venti servers, since Fossil does not keep track
 727 6f4d00ee 2013-09-23 0intro of which blocks are stored on which servers.
 728 6f4d00ee 2013-09-23 0intro .PP
 729 6f4d00ee 2013-09-23 0intro .I Open
 730 6f4d00ee 2013-09-23 0intro opens the file system, reading the
 731 6f4d00ee 2013-09-23 0intro root and super blocks and allocating an in-memory
 732 6f4d00ee 2013-09-23 0intro cache for disk and Venti blocks.
 733 6f4d00ee 2013-09-23 0intro The options are:
 734 6f4d00ee 2013-09-23 0intro .TF "-c\fI ncache
 735 6f4d00ee 2013-09-23 0intro .PD
 736 6f4d00ee 2013-09-23 0intro .TP
 737 6f4d00ee 2013-09-23 0intro .B -A
 738 6f4d00ee 2013-09-23 0intro run with no authentication
 739 6f4d00ee 2013-09-23 0intro .TP
 740 6f4d00ee 2013-09-23 0intro .B -P
 741 6f4d00ee 2013-09-23 0intro run with no permission checking
 742 6f4d00ee 2013-09-23 0intro .TP
 743 6f4d00ee 2013-09-23 0intro .B -V
 744 6f4d00ee 2013-09-23 0intro do not attempt to connect to a Venti server
 745 6f4d00ee 2013-09-23 0intro .TP
 746 6f4d00ee 2013-09-23 0intro .B -W
 747 6f4d00ee 2013-09-23 0intro allow wstat to make arbitrary changes to the user and group fields
 748 6f4d00ee 2013-09-23 0intro .TP
 749 6f4d00ee 2013-09-23 0intro .B -a
 750 6f4d00ee 2013-09-23 0intro do not update file access times;
 751 6f4d00ee 2013-09-23 0intro primarily to avoid wear on flash memories
 752 6f4d00ee 2013-09-23 0intro .TP
 753 6f4d00ee 2013-09-23 0intro .B -r
 754 6f4d00ee 2013-09-23 0intro open the file system read-only
 755 6f4d00ee 2013-09-23 0intro .TP
 756 6f4d00ee 2013-09-23 0intro .BI -c " ncache
 757 6f4d00ee 2013-09-23 0intro allocate an in-memory cache of 
 758 6f4d00ee 2013-09-23 0intro .I ncache
 759 6f4d00ee 2013-09-23 0intro (by default, 1000)
 760 6f4d00ee 2013-09-23 0intro blocks
 761 6f4d00ee 2013-09-23 0intro .PP
 762 6f4d00ee 2013-09-23 0intro The
 763 6f4d00ee 2013-09-23 0intro .I -APW
 764 6f4d00ee 2013-09-23 0intro settings can be overridden on a per-connection basis
 765 6f4d00ee 2013-09-23 0intro by the
 766 6f4d00ee 2013-09-23 0intro .I srv
 767 6f4d00ee 2013-09-23 0intro command above.
 768 6f4d00ee 2013-09-23 0intro .PP
 769 6f4d00ee 2013-09-23 0intro .I Close
 770 6f4d00ee 2013-09-23 0intro flushes all dirty file system blocks to disk
 771 6f4d00ee 2013-09-23 0intro and then closes the device file.
 772 6f4d00ee 2013-09-23 0intro .PP
 773 6f4d00ee 2013-09-23 0intro .I Unconfig
 774 6f4d00ee 2013-09-23 0intro removes the named file system (which must be closed)
 775 6f4d00ee 2013-09-23 0intro from fossil's internal table.
 776 6f4d00ee 2013-09-23 0intro .br
 777 6f4d00ee 2013-09-23 0intro .ne 3
 778 6f4d00ee 2013-09-23 0intro .SS File system maintenance
 779 6f4d00ee 2013-09-23 0intro .I Bfree
 780 6f4d00ee 2013-09-23 0intro marks the block at disk address
 781 6f4d00ee 2013-09-23 0intro .I addr
 782 6f4d00ee 2013-09-23 0intro as available for allocation.
 783 6f4d00ee 2013-09-23 0intro Before doing so, it prints a
 784 6f4d00ee 2013-09-23 0intro .I label
 785 6f4d00ee 2013-09-23 0intro command (q.v.)
 786 6f4d00ee 2013-09-23 0intro that can be used to restore the block to its previous state.
 787 6f4d00ee 2013-09-23 0intro .PP
 788 6f4d00ee 2013-09-23 0intro .I Block
 789 6f4d00ee 2013-09-23 0intro displays (in hexadecimal)
 790 6f4d00ee 2013-09-23 0intro the contents of the block at disk address
 791 6f4d00ee 2013-09-23 0intro .IR addr ,
 792 6f4d00ee 2013-09-23 0intro starting at
 793 6f4d00ee 2013-09-23 0intro .I offset
 794 6f4d00ee 2013-09-23 0intro and continuing for
 795 6f4d00ee 2013-09-23 0intro .I count
 796 6f4d00ee 2013-09-23 0intro bytes or until the end of the block.
 797 6f4d00ee 2013-09-23 0intro If 
 798 6f4d00ee 2013-09-23 0intro .I data
 799 6f4d00ee 2013-09-23 0intro (also hexadecimal)
 800 6f4d00ee 2013-09-23 0intro is given, the contents in that range are
 801 6f4d00ee 2013-09-23 0intro replaced with data.
 802 6f4d00ee 2013-09-23 0intro When writing to a block,
 803 6f4d00ee 2013-09-23 0intro .I block
 804 6f4d00ee 2013-09-23 0intro prints the old and new contents,
 805 6f4d00ee 2013-09-23 0intro so that the change is easily undone.
 806 6f4d00ee 2013-09-23 0intro Editing blocks is discouraged.
 807 6f4d00ee 2013-09-23 0intro .PP
 808 6f4d00ee 2013-09-23 0intro .I Clre
 809 6f4d00ee 2013-09-23 0intro zeros an entry from a disk block.
 810 6f4d00ee 2013-09-23 0intro Before doing so, it prints a
 811 6f4d00ee 2013-09-23 0intro .I block
 812 6f4d00ee 2013-09-23 0intro command that can be used 
 813 6f4d00ee 2013-09-23 0intro to restore the entry.
 814 6f4d00ee 2013-09-23 0intro .PP
 815 6f4d00ee 2013-09-23 0intro .I Clri
 816 6f4d00ee 2013-09-23 0intro removes the internal directory entry
 817 6f4d00ee 2013-09-23 0intro and abandons storage associated with
 818 6f4d00ee 2013-09-23 0intro .IR files .
 819 6f4d00ee 2013-09-23 0intro It ignores the usual rules for sanity, such as checking against
 820 6f4d00ee 2013-09-23 0intro removing a non-empty directory.
 821 6f4d00ee 2013-09-23 0intro A subsequent
 822 6f4d00ee 2013-09-23 0intro .I flchk
 823 6f4d00ee 2013-09-23 0intro (see
 824 d32deab1 2020-08-16 rsc .MR fossil (4) )
 825 6f4d00ee 2013-09-23 0intro will identify the abandoned storage so it can be reclaimed with
 826 6f4d00ee 2013-09-23 0intro .I bfree
 827 6f4d00ee 2013-09-23 0intro commands.
 828 6f4d00ee 2013-09-23 0intro .PP
 829 6f4d00ee 2013-09-23 0intro .I Clrp
 830 6f4d00ee 2013-09-23 0intro zeros a pointer in a disk block.
 831 6f4d00ee 2013-09-23 0intro Before doing so, it prints a 
 832 6f4d00ee 2013-09-23 0intro .I block
 833 6f4d00ee 2013-09-23 0intro command that can be used to restore the entry.
 834 6f4d00ee 2013-09-23 0intro .PP
 835 6f4d00ee 2013-09-23 0intro .I Check
 836 6f4d00ee 2013-09-23 0intro checks the file system for various inconsistencies.
 837 6f4d00ee 2013-09-23 0intro If the file system is not already halted, it is halted for
 838 6f4d00ee 2013-09-23 0intro the duration of the check.
 839 6f4d00ee 2013-09-23 0intro If the archiver is currently sending a snapshot to Venti,
 840 6f4d00ee 2013-09-23 0intro the check will refuse to run; the only recourse is to wait
 841 6f4d00ee 2013-09-23 0intro for the archiver to finish.
 842 6f4d00ee 2013-09-23 0intro .PP
 843 6f4d00ee 2013-09-23 0intro A list of keyword options control the check.
 844 6f4d00ee 2013-09-23 0intro The
 845 6f4d00ee 2013-09-23 0intro .BR pblock ,
 846 6f4d00ee 2013-09-23 0intro .BR pdir ,
 847 6f4d00ee 2013-09-23 0intro and
 848 6f4d00ee 2013-09-23 0intro .B pfile
 849 6f4d00ee 2013-09-23 0intro options cause 
 850 6f4d00ee 2013-09-23 0intro .I check
 851 6f4d00ee 2013-09-23 0intro to print the name of each block, directory, or file encountered.
 852 6f4d00ee 2013-09-23 0intro .PP
 853 6f4d00ee 2013-09-23 0intro By default,
 854 6f4d00ee 2013-09-23 0intro .I check
 855 6f4d00ee 2013-09-23 0intro reports errors but does not fix them.
 856 6f4d00ee 2013-09-23 0intro The
 857 6f4d00ee 2013-09-23 0intro .BR bclose ,
 858 6f4d00ee 2013-09-23 0intro .BR clri ,
 859 6f4d00ee 2013-09-23 0intro .BR clre ,
 860 6f4d00ee 2013-09-23 0intro and
 861 6f4d00ee 2013-09-23 0intro .B clrp
 862 6f4d00ee 2013-09-23 0intro options specify correcting actions that may be taken:
 863 6f4d00ee 2013-09-23 0intro closing leaked blocks, clearing bad file directory entries,
 864 6f4d00ee 2013-09-23 0intro clearing bad pointers, and clearing bad entries.
 865 6f4d00ee 2013-09-23 0intro The
 866 6f4d00ee 2013-09-23 0intro .B fix
 867 6f4d00ee 2013-09-23 0intro option enables all of these; it is equivalent to
 868 6f4d00ee 2013-09-23 0intro .B bclose
 869 6f4d00ee 2013-09-23 0intro .B clri
 870 6f4d00ee 2013-09-23 0intro .B clre
 871 6f4d00ee 2013-09-23 0intro .BR clrp .
 872 6f4d00ee 2013-09-23 0intro .PP
 873 6f4d00ee 2013-09-23 0intro By default,
 874 6f4d00ee 2013-09-23 0intro .I check
 875 6f4d00ee 2013-09-23 0intro scans the portion of the active file system held in the write buffer,
 876 6f4d00ee 2013-09-23 0intro avoiding blocks stored on Venti or used only in snapshots.
 877 6f4d00ee 2013-09-23 0intro The
 878 6f4d00ee 2013-09-23 0intro .B venti
 879 6f4d00ee 2013-09-23 0intro option causes
 880 6f4d00ee 2013-09-23 0intro .I check
 881 6f4d00ee 2013-09-23 0intro to scan the portion of the file system stored on Venti,
 882 6f4d00ee 2013-09-23 0intro and the
 883 6f4d00ee 2013-09-23 0intro .B snapshot
 884 6f4d00ee 2013-09-23 0intro option causes
 885 6f4d00ee 2013-09-23 0intro .I check
 886 6f4d00ee 2013-09-23 0intro to scan old snapshots.
 887 6f4d00ee 2013-09-23 0intro Specifying
 888 6f4d00ee 2013-09-23 0intro .B snapshot
 889 6f4d00ee 2013-09-23 0intro causes
 890 6f4d00ee 2013-09-23 0intro .I check
 891 6f4d00ee 2013-09-23 0intro to take a long time;
 892 6f4d00ee 2013-09-23 0intro specifying
 893 6f4d00ee 2013-09-23 0intro .B venti
 894 6f4d00ee 2013-09-23 0intro or
 895 6f4d00ee 2013-09-23 0intro (worse)
 896 6f4d00ee 2013-09-23 0intro .B venti
 897 6f4d00ee 2013-09-23 0intro .B snapshot
 898 6f4d00ee 2013-09-23 0intro causes
 899 6f4d00ee 2013-09-23 0intro .I check
 900 6f4d00ee 2013-09-23 0intro to take a very long time.
 901 6f4d00ee 2013-09-23 0intro .PP
 902 6f4d00ee 2013-09-23 0intro .I Create
 903 6f4d00ee 2013-09-23 0intro creates a file on the current file system.
 904 6f4d00ee 2013-09-23 0intro .I Uid
 905 6f4d00ee 2013-09-23 0intro and
 906 6f4d00ee 2013-09-23 0intro .I gid
 907 6f4d00ee 2013-09-23 0intro are uids
 908 6f4d00ee 2013-09-23 0intro .RI ( not
 909 6f4d00ee 2013-09-23 0intro unames;
 910 6f4d00ee 2013-09-23 0intro see the discussion above, in the description
 911 6f4d00ee 2013-09-23 0intro of the 
 912 6f4d00ee 2013-09-23 0intro .I uname
 913 6f4d00ee 2013-09-23 0intro command).
 914 6f4d00ee 2013-09-23 0intro .I Perm
 915 6f4d00ee 2013-09-23 0intro is the low 9 bits of the permission mode of the file,
 916 6f4d00ee 2013-09-23 0intro in octal.
 917 6f4d00ee 2013-09-23 0intro The 
 918 6f4d00ee 2013-09-23 0intro .BR a ,
 919 6f4d00ee 2013-09-23 0intro .BR d ,
 920 6f4d00ee 2013-09-23 0intro and
 921 6f4d00ee 2013-09-23 0intro .B l
 922 6f4d00ee 2013-09-23 0intro mode prefixes
 923 6f4d00ee 2013-09-23 0intro set the append-only, directory, and lock bits.
 924 6f4d00ee 2013-09-23 0intro The
 925 6f4d00ee 2013-09-23 0intro .I perm
 926 6f4d00ee 2013-09-23 0intro is formatted as described in the
 927 6f4d00ee 2013-09-23 0intro .I stat
 928 6f4d00ee 2013-09-23 0intro command;
 929 6f4d00ee 2013-09-23 0intro creating files or directories with the
 930 6f4d00ee 2013-09-23 0intro .BR snapshot (s)
 931 6f4d00ee 2013-09-23 0intro bit set is not allowed.
 932 6f4d00ee 2013-09-23 0intro .PP
 933 6f4d00ee 2013-09-23 0intro .I Df
 934 6f4d00ee 2013-09-23 0intro prints the amount of used disk space in the write buffer.
 935 6f4d00ee 2013-09-23 0intro .PP
 936 6f4d00ee 2013-09-23 0intro .I Epoch
 937 6f4d00ee 2013-09-23 0intro sets the low file system epoch.
 938 6f4d00ee 2013-09-23 0intro Snapshots in the file system are given increasing epoch numbers.
 939 6f4d00ee 2013-09-23 0intro The file system maintains a low and a high epoch number,
 940 6f4d00ee 2013-09-23 0intro and only allows access to snapshots in that range.
 941 6f4d00ee 2013-09-23 0intro The low epoch number can be moved forward to discard old snapshots
 942 6f4d00ee 2013-09-23 0intro and reclaim the disk space they occupy.
 943 6f4d00ee 2013-09-23 0intro (The high epoch number is always the epoch of the currently
 944 6f4d00ee 2013-09-23 0intro active file system.)
 945 6f4d00ee 2013-09-23 0intro .PP
 946 6f4d00ee 2013-09-23 0intro With no argument
 947 6f4d00ee 2013-09-23 0intro .I epoch
 948 6f4d00ee 2013-09-23 0intro reports the current low and high epoch numbers.
 949 6f4d00ee 2013-09-23 0intro The command
 950 6f4d00ee 2013-09-23 0intro ``\fLepoch\fI n''\fR
 951 6f4d00ee 2013-09-23 0intro is used to propose changing the low epoch to
 952 6f4d00ee 2013-09-23 0intro .IR n .
 953 6f4d00ee 2013-09-23 0intro In response, 
 954 6f4d00ee 2013-09-23 0intro .I fossil
 955 6f4d00ee 2013-09-23 0intro scans
 956 6f4d00ee 2013-09-23 0intro .B /archive
 957 6f4d00ee 2013-09-23 0intro and
 958 6f4d00ee 2013-09-23 0intro .B /snapshot
 959 6f4d00ee 2013-09-23 0intro for snapshots that would be discarded, printing their
 960 6f4d00ee 2013-09-23 0intro epoch numbers and the
 961 6f4d00ee 2013-09-23 0intro .I clri
 962 6f4d00ee 2013-09-23 0intro commands necessary to remove them.
 963 6f4d00ee 2013-09-23 0intro The epoch is changed only if no such paths are found.
 964 6f4d00ee 2013-09-23 0intro The usual sequence of commands is (1) run epoch to
 965 6f4d00ee 2013-09-23 0intro print the snapshots and their epochs, (2) clri some snapshots,
 966 6f4d00ee 2013-09-23 0intro (3) run epoch again.
 967 6f4d00ee 2013-09-23 0intro If the file system is completely full (there are no free blocks),
 968 6f4d00ee 2013-09-23 0intro .I clri
 969 6f4d00ee 2013-09-23 0intro may fail because it needs to allocate blocks.
 970 6f4d00ee 2013-09-23 0intro For this situation,
 971 6f4d00ee 2013-09-23 0intro the
 972 6f4d00ee 2013-09-23 0intro .B -y
 973 6f4d00ee 2013-09-23 0intro flag to epoch forces the epoch change even when
 974 6f4d00ee 2013-09-23 0intro it means discarding currently accessible snapshots.
 975 6f4d00ee 2013-09-23 0intro Note that when there are still snapshots in
 976 6f4d00ee 2013-09-23 0intro .BR /archive ,
 977 6f4d00ee 2013-09-23 0intro the archiver should take care
 978 6f4d00ee 2013-09-23 0intro of those snapshots (moving the blocks from disk to Venti)
 979 6f4d00ee 2013-09-23 0intro if you give it more time.
 980 6f4d00ee 2013-09-23 0intro .PP
 981 6f4d00ee 2013-09-23 0intro The
 982 6f4d00ee 2013-09-23 0intro .B -r
 983 6f4d00ee 2013-09-23 0intro flag to epoch causes it to remove any now-inaccessible
 984 6f4d00ee 2013-09-23 0intro snapshot directories once it has changed the epoch.
 985 6f4d00ee 2013-09-23 0intro This flag only makes sense in conjunction with the
 986 6f4d00ee 2013-09-23 0intro .B -y
 987 6f4d00ee 2013-09-23 0intro flag.
 988 6f4d00ee 2013-09-23 0intro .PP
 989 6f4d00ee 2013-09-23 0intro .I Epoch
 990 6f4d00ee 2013-09-23 0intro is a very low-level way to retire snapshots.
 991 6f4d00ee 2013-09-23 0intro The preferred way is by setting an automatic timer
 992 6f4d00ee 2013-09-23 0intro with
 993 6f4d00ee 2013-09-23 0intro .IR snaptime .
 994 6f4d00ee 2013-09-23 0intro .PP
 995 6f4d00ee 2013-09-23 0intro .I Halt
 996 6f4d00ee 2013-09-23 0intro suspends all file system activity;
 997 6f4d00ee 2013-09-23 0intro .I unhalt
 998 6f4d00ee 2013-09-23 0intro resumes activity.
 999 6f4d00ee 2013-09-23 0intro .PP
1000 6f4d00ee 2013-09-23 0intro .I Label
1001 6f4d00ee 2013-09-23 0intro displays and edits the label associated with a block.
1002 6f4d00ee 2013-09-23 0intro When editing, a parameter of
1003 6f4d00ee 2013-09-23 0intro .B -
1004 6f4d00ee 2013-09-23 0intro means leave that field unchanged.
1005 6f4d00ee 2013-09-23 0intro Editing labels is discouraged.
1006 6f4d00ee 2013-09-23 0intro .PP
1007 6f4d00ee 2013-09-23 0intro .I Remove
1008 6f4d00ee 2013-09-23 0intro removes
1009 6f4d00ee 2013-09-23 0intro .IR files .
1010 6f4d00ee 2013-09-23 0intro .PP
1011 6f4d00ee 2013-09-23 0intro .I Snap
1012 6f4d00ee 2013-09-23 0intro takes a temporary snapshot of the current file system,
1013 6f4d00ee 2013-09-23 0intro recording it in 
1014 6f4d00ee 2013-09-23 0intro .BI /snapshot/ yyyy / mmdd / hhmm \fR,
1015 6f4d00ee 2013-09-23 0intro as described in 
1016 d32deab1 2020-08-16 rsc .MR fossil (4) .
1017 6f4d00ee 2013-09-23 0intro The
1018 6f4d00ee 2013-09-23 0intro .B -a
1019 6f4d00ee 2013-09-23 0intro flag causes 
1020 6f4d00ee 2013-09-23 0intro .I snap
1021 6f4d00ee 2013-09-23 0intro to take an archival snapshot, recording it in
1022 6f4d00ee 2013-09-23 0intro .BI /archive/ yyyy / mmdd \fR,
1023 6f4d00ee 2013-09-23 0intro also described in
1024 d32deab1 2020-08-16 rsc .MR fossil (4) .
1025 6f4d00ee 2013-09-23 0intro By default the snapshot is taken of
1026 6f4d00ee 2013-09-23 0intro .BR /active ,
1027 6f4d00ee 2013-09-23 0intro the root of the active file system.
1028 6f4d00ee 2013-09-23 0intro The 
1029 6f4d00ee 2013-09-23 0intro .B -s
1030 6f4d00ee 2013-09-23 0intro flag specifies a different source path.
1031 6f4d00ee 2013-09-23 0intro The
1032 6f4d00ee 2013-09-23 0intro .B -d
1033 6f4d00ee 2013-09-23 0intro flag specifies a different destination path.
1034 6f4d00ee 2013-09-23 0intro These  two flags are useful together for moving snapshots into
1035 6f4d00ee 2013-09-23 0intro the archive tree.
1036 6f4d00ee 2013-09-23 0intro .PP
1037 6f4d00ee 2013-09-23 0intro .I Snapclean
1038 6f4d00ee 2013-09-23 0intro immediately discards all snapshots that are more than
1039 6f4d00ee 2013-09-23 0intro .I timeout
1040 6f4d00ee 2013-09-23 0intro minutes old.
1041 6f4d00ee 2013-09-23 0intro The default timeout is the one set by the
1042 6f4d00ee 2013-09-23 0intro .I snaptime
1043 6f4d00ee 2013-09-23 0intro command.
1044 6f4d00ee 2013-09-23 0intro The discarding is a one-time event rather than
1045 6f4d00ee 2013-09-23 0intro a recurring event as in
1046 6f4d00ee 2013-09-23 0intro .IR snaptime .
1047 6f4d00ee 2013-09-23 0intro .PP
1048 6f4d00ee 2013-09-23 0intro .I Snaptime
1049 6f4d00ee 2013-09-23 0intro displays and edits the times at which snapshots are automatically
1050 6f4d00ee 2013-09-23 0intro taken.
1051 6f4d00ee 2013-09-23 0intro An archival snapshot is taken once a day, at
1052 6f4d00ee 2013-09-23 0intro .IR hhmm ,
1053 6f4d00ee 2013-09-23 0intro while temporary snapshots are taken at multiples of
1054 6f4d00ee 2013-09-23 0intro .I interval
1055 6f4d00ee 2013-09-23 0intro minutes.
1056 6f4d00ee 2013-09-23 0intro Temporary snapshots are discarded after they are
1057 6f4d00ee 2013-09-23 0intro .I timeout
1058 6f4d00ee 2013-09-23 0intro minutes old.
1059 6f4d00ee 2013-09-23 0intro The snapshot cleanup runs every
1060 6f4d00ee 2013-09-23 0intro .I timeout
1061 6f4d00ee 2013-09-23 0intro minutes or once a day, whichever is more frequent,
1062 6f4d00ee 2013-09-23 0intro so snapshots may grow to an age of almost twice the timeout
1063 6f4d00ee 2013-09-23 0intro before actually being discarded.
1064 6f4d00ee 2013-09-23 0intro With no arguments,
1065 6f4d00ee 2013-09-23 0intro .I snaptime
1066 6f4d00ee 2013-09-23 0intro prints the current snapshot times.
1067 6f4d00ee 2013-09-23 0intro The
1068 6f4d00ee 2013-09-23 0intro .B -a
1069 6f4d00ee 2013-09-23 0intro and
1070 6f4d00ee 2013-09-23 0intro .B -s
1071 6f4d00ee 2013-09-23 0intro options set the archive and snapshot times.
1072 6f4d00ee 2013-09-23 0intro An
1073 6f4d00ee 2013-09-23 0intro .I hhmm
1074 6f4d00ee 2013-09-23 0intro or
1075 6f4d00ee 2013-09-23 0intro .I interval
1076 6f4d00ee 2013-09-23 0intro of
1077 6f4d00ee 2013-09-23 0intro .L none
1078 6f4d00ee 2013-09-23 0intro can be used to disable that kind of automatic snapshot.
1079 6f4d00ee 2013-09-23 0intro The
1080 6f4d00ee 2013-09-23 0intro .B -t
1081 6f4d00ee 2013-09-23 0intro option sets the snapshot timeout.
1082 6f4d00ee 2013-09-23 0intro If
1083 6f4d00ee 2013-09-23 0intro .I timeout
1084 6f4d00ee 2013-09-23 0intro is
1085 6f4d00ee 2013-09-23 0intro .LR none ,
1086 6f4d00ee 2013-09-23 0intro temporary snapshots are not automatically discarded.
1087 6f4d00ee 2013-09-23 0intro By default, all three times are set to
1088 6f4d00ee 2013-09-23 0intro .LR none .
1089 6f4d00ee 2013-09-23 0intro .PP
1090 6f4d00ee 2013-09-23 0intro .I Stat
1091 6f4d00ee 2013-09-23 0intro displays metadata for each of the named
1092 6f4d00ee 2013-09-23 0intro .IR files ,
1093 6f4d00ee 2013-09-23 0intro in the form:
1094 6f4d00ee 2013-09-23 0intro .IP
1095 6f4d00ee 2013-09-23 0intro .EX
1096 6f4d00ee 2013-09-23 0intro stat \fIfile elem uid gid perm length
1097 6f4d00ee 2013-09-23 0intro .EE
1098 6f4d00ee 2013-09-23 0intro .LP
1099 6f4d00ee 2013-09-23 0intro (Replacing
1100 6f4d00ee 2013-09-23 0intro .B stat
1101 6f4d00ee 2013-09-23 0intro with
1102 6f4d00ee 2013-09-23 0intro .B wstat
1103 6f4d00ee 2013-09-23 0intro yields a valid command.)
1104 6f4d00ee 2013-09-23 0intro The
1105 6f4d00ee 2013-09-23 0intro .I perm
1106 6f4d00ee 2013-09-23 0intro is an octal number less than or equal to 777,
1107 6f4d00ee 2013-09-23 0intro prefixed with any of the following letters
1108 6f4d00ee 2013-09-23 0intro to indicate additional bits.
1109 6f4d00ee 2013-09-23 0intro .IP
1110 6f4d00ee 2013-09-23 0intro .EX
1111 6f4d00ee 2013-09-23 0intro .ta +4n
1112 6f4d00ee 2013-09-23 0intro a	\fRappend only
1113 6f4d00ee 2013-09-23 0intro d	\fRdirectory
1114 6f4d00ee 2013-09-23 0intro l	\fRexclusive use
1115 6f4d00ee 2013-09-23 0intro s	\fRis the root of a snapshot
1116 6f4d00ee 2013-09-23 0intro t	\fRtemporary bit
1117 6f4d00ee 2013-09-23 0intro A	\fRMS-DOS archive bit
1118 6f4d00ee 2013-09-23 0intro G	\fRsetgid
1119 6f4d00ee 2013-09-23 0intro H	\fRMS-DOS hidden bit
1120 6f4d00ee 2013-09-23 0intro L	\fRsymbolic link
1121 6f4d00ee 2013-09-23 0intro S	\fRMS-DOS system bit
1122 6f4d00ee 2013-09-23 0intro U	\fRsetuid
1123 6f4d00ee 2013-09-23 0intro Y	\fRsticky
1124 6f4d00ee 2013-09-23 0intro .EE
1125 6f4d00ee 2013-09-23 0intro .PP
1126 6f4d00ee 2013-09-23 0intro The bits denoted by capital letters are included
1127 6f4d00ee 2013-09-23 0intro to support non-Plan 9 systems.
1128 6f4d00ee 2013-09-23 0intro They are not made visible by the 9P protocol.
1129 6f4d00ee 2013-09-23 0intro .PP
1130 6f4d00ee 2013-09-23 0intro .I Sync
1131 6f4d00ee 2013-09-23 0intro writes dirty blocks in memory to the disk.
1132 6f4d00ee 2013-09-23 0intro .PP
1133 6f4d00ee 2013-09-23 0intro .I Vac
1134 6f4d00ee 2013-09-23 0intro prints the Venti score for a
1135 d32deab1 2020-08-16 rsc .MR vac (1)
1136 6f4d00ee 2013-09-23 0intro archive containing the tree rooted
1137 6f4d00ee 2013-09-23 0intro at
1138 6f4d00ee 2013-09-23 0intro .IR dir ,
1139 6f4d00ee 2013-09-23 0intro which must already be archived to Venti
1140 6f4d00ee 2013-09-23 0intro (typically
1141 6f4d00ee 2013-09-23 0intro .IR dir
1142 6f4d00ee 2013-09-23 0intro is a directory in the
1143 6f4d00ee 2013-09-23 0intro .B /archive
1144 6f4d00ee 2013-09-23 0intro tree).
1145 6f4d00ee 2013-09-23 0intro .PP
1146 6f4d00ee 2013-09-23 0intro .I Wstat
1147 6f4d00ee 2013-09-23 0intro changes the metadata of the named
1148 6f4d00ee 2013-09-23 0intro .IR file .
1149 6f4d00ee 2013-09-23 0intro Specifying
1150 6f4d00ee 2013-09-23 0intro .B -
1151 6f4d00ee 2013-09-23 0intro for any of the fields means ``don't change.''
1152 6f4d00ee 2013-09-23 0intro Attempts to change the
1153 6f4d00ee 2013-09-23 0intro .B d
1154 6f4d00ee 2013-09-23 0intro or
1155 6f4d00ee 2013-09-23 0intro .B s
1156 6f4d00ee 2013-09-23 0intro bits in the
1157 6f4d00ee 2013-09-23 0intro .I perm
1158 6f4d00ee 2013-09-23 0intro are silently ignored.
1159 6f4d00ee 2013-09-23 0intro .SH EXAMPLES
1160 6f4d00ee 2013-09-23 0intro .IR Sources ,
1161 6f4d00ee 2013-09-23 0intro the Plan 9 distribution file server,
1162 6f4d00ee 2013-09-23 0intro uses the following configuration file:
1163 6f4d00ee 2013-09-23 0intro .IP
1164 6f4d00ee 2013-09-23 0intro .EX
1165 6f4d00ee 2013-09-23 0intro srv -p fscons.sources
1166 6f4d00ee 2013-09-23 0intro srv -p fscons.sources.adduserd
1167 6f4d00ee 2013-09-23 0intro srv sources
1168 6f4d00ee 2013-09-23 0intro fsys main config /dev/sdC0/fossil.outside
1169 6f4d00ee 2013-09-23 0intro fsys main open -c 25600
1170 6f4d00ee 2013-09-23 0intro fsys main
1171 6f4d00ee 2013-09-23 0intro users /active/adm/users
1172 6f4d00ee 2013-09-23 0intro listen tcp!*!564
1173 6f4d00ee 2013-09-23 0intro msg -m 40 -p 10
1174 6f4d00ee 2013-09-23 0intro snaptime -a 0000 -s 15
1175 6f4d00ee 2013-09-23 0intro .EE
1176 6f4d00ee 2013-09-23 0intro .LP
1177 6f4d00ee 2013-09-23 0intro The second console is used by the daemon
1178 6f4d00ee 2013-09-23 0intro that creates new accounts.
1179 6f4d00ee 2013-09-23 0intro .PP
1180 6f4d00ee 2013-09-23 0intro To add a new user with
1181 6f4d00ee 2013-09-23 0intro .I name
1182 6f4d00ee 2013-09-23 0intro and
1183 6f4d00ee 2013-09-23 0intro .I id
1184 6f4d00ee 2013-09-23 0intro .B rob
1185 6f4d00ee 2013-09-23 0intro and create his home directory:
1186 6f4d00ee 2013-09-23 0intro .IP
1187 6f4d00ee 2013-09-23 0intro .EX
1188 6f4d00ee 2013-09-23 0intro uname rob rob
1189 6f4d00ee 2013-09-23 0intro .EE
1190 6f4d00ee 2013-09-23 0intro .PP
1191 6f4d00ee 2013-09-23 0intro To create a new group
1192 6f4d00ee 2013-09-23 0intro .B sys
1193 6f4d00ee 2013-09-23 0intro (with no home directory)
1194 6f4d00ee 2013-09-23 0intro and add
1195 6f4d00ee 2013-09-23 0intro .B rob
1196 6f4d00ee 2013-09-23 0intro to it:
1197 6f4d00ee 2013-09-23 0intro .IP
1198 6f4d00ee 2013-09-23 0intro .EX
1199 6f4d00ee 2013-09-23 0intro uname sys :sys
1200 6f4d00ee 2013-09-23 0intro uname sys +rob
1201 6f4d00ee 2013-09-23 0intro .EE
1202 6f4d00ee 2013-09-23 0intro .PP
1203 6f4d00ee 2013-09-23 0intro To save an old (but not yet discarded) snapshot into the archive tree:
1204 6f4d00ee 2013-09-23 0intro .IP
1205 6f4d00ee 2013-09-23 0intro .EX
1206 6f4d00ee 2013-09-23 0intro snap -a -s /snapshot/2003/1220/0700 -d /archive/2003/1220
1207 6f4d00ee 2013-09-23 0intro .EE