sys/man/4/httpfile

   1 .TH HTTPFILE 4
   2 .SH NAME
   3 httpfile \- serve a single web file
   4 .SH SYNOPSIS
   5 .B httpfile
   6 [
   7 .B -9d
   8 ]
   9 [
  10 .B -c
  11 .I count
  12 ]
  13 [
  14 .B -f
  15 .I file
  16 ]
  17 [
  18 .B -m
  19 .I mtpt
  20 ]
  21 [
  22 .B -s
  23 .I srvname
  24 ]
  25 [
  26 .B -x
  27 .I net
  28 ]
  29 .I url
  30 .SH DESCRIPTION
  31 .I Httpfile
  32 serves the web page specified by the URL
  33 .I url
  34 as a new file
  35 .I file
  36 in the directory
  37 .IR mtpt .
  38 The default
  39 .I file
  40 is the last path element of the URL,
  41 and the default
  42 .I mtpt
  43 is the current directory.
  44 .PP
  45 .I Httpfile
  46 does not download large files all at once.
  47 Instead, it requests 64-kilobyte blocks as they are
  48 needed to satisfy reads, caching a few blocks in memory at a time.
  49 .PP
  50 The
  51 .B -D
  52 and
  53 .B -d
  54 options enable a trace of the 9P traffic
  55 and general debugging messages.
  56 .PP
  57 The
  58 .B -s
  59 option causes
  60 .I httpfile
  61 to post the 9P service as
  62 .BI /srv/ srvname
  63 and disables the default mount.
  64 .PP
  65 The
  66 .B -x
  67 option specifies an alternate network directory
  68 .RI ( e.g.,
  69 .BR /net.alt ).
  70 .PP
  71 The
  72 .B -c
  73 option sets the number of file blocks kept cached in memory (default 32).
  74 .SH EXAMPLE
  75 Mount an ISO image on a web server:
  76 .IP
  77 .EX
  78 ip/httpfile http://www.9grid.de/plan9/plan9.iso
  79 9660srv
  80 mount /srv/9660 /n/iso plan9.iso
  81 .EE
  82 .SH SOURCE
  83 .B /sys/src/cmd/ip/httpfile.c
  84 .SH "SEE ALSO
  85 .IR hget (1),
  86 .IR webfs (4)