sys/man/4/httpfile

   1 .TH HTTPFILE 4
   2 .SH NAME
   3 httpfile \- serve a single web file
   4 .SH SYNOPSIS
   5 .B ip/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 .I url
  26 .SH DESCRIPTION
  27 .I Httpfile
  28 serves the web page specified by the URL
  29 .I url
  30 as a new file
  31 .I file
  32 in the directory
  33 .IR mtpt .
  34 The default
  35 .I file
  36 is the last path element of the URL,
  37 and the default
  38 .I mtpt
  39 is the current directory.
  40 .PP
  41 .I Httpfile
  42 does not download large files all at once.
  43 Instead, it requests 64-kilobyte blocks as they are
  44 needed to satisfy reads, caching a few blocks in memory at a time.
  45 .PP
  46 The
  47 .B -D
  48 and
  49 .B -d
  50 options enable a trace of the 9P traffic
  51 and general debugging messages.
  52 .PP
  53 The
  54 .B -s
  55 option causes
  56 .I httpfile
  57 to post the 9P service as
  58 .BI /srv/ srvname
  59 and disables the default mount.
  60 .PP
  61 The
  62 .B -c
  63 option sets the number of file blocks kept cached in memory (default 32).
  64 .SH EXAMPLE
  65 Mount an ISO image on a web server:
  66 .IP
  67 .EX
  68 ip/httpfile http://www.r-36.net/9front/9front.iso
  69 9660srv
  70 mount /srv/9660 /n/iso 9front.iso
  71 .EE
  72 .SH SOURCE
  73 .B /sys/src/cmd/ip/httpfile.c
  74 .SH "SEE ALSO"
  75 .IR hget (1),
  76 .IR webfs (4)
  77 .SH DIAGNOSTICS
  78 .I Httpfile
  79 requires
  80 .IR webfs (4)
  81 service mounted on
  82 .B /mnt/web
  83 to work.