HTTP(1) General Commands Manual HTTP(1) (NAME) http - HTTP (SYNOPSIS) http [OPTIONS] [DIRECTORY] (DESCRIPTION) Host These Things Please - HTTP . HTTP . . (OPTIONS) [DIR] . . : . -p --port [PORT] . 1 65'535 . 0 . : 8000 . -a --address [ADDRESS] IP (bind) . : 0.0.0.0. -t --temp-dir [TEMP] . --allow-write --no-encode . : $TEMP. --ssl [TLS_IDENTITY_FILE] TLS . HTTP_SSL_PASS . : None. --gen-ssl TLS (self-signed) openssl . MacOS libssl "password" . --ssl. : false. --auth [USERNAME[:PASSWORD]] (global). --path-auth . --path-auth . --path-auth . : None. --gen-auth : . --auth . --gen-path-auth . --gen-path-auth . --auth. : false. --path-auth [PATH=[USERNAME[:PASSWORD]]] (per-path). PATH . . . PATH . PATH . : . --gen-path-auth [PATH] : PATH. - ASCII . --path-auth PATH . --path-auth PATH . : . --proxy [HEADER-NAME:CIDR] HEADER-NAME forwarded-for CIDR . . . : none. --proxy-redir [HEADER-NAME:CIDR] HEADER-NAME X-Original-URL CIDR : 303 See Other Location: . . : none. -m --mime-type [EXTENSION:MIME-TYPE] MIME-TYPE EXTENSION. EXTENSION MIME . MIME mime_guess ( ) "application/octet-stream" "text/plain". . : none. --request-bandwidth [BYTES] BYTES . [KMGTPE] SI [kmgtpe] . . : 0. -H --header [NAME: VALUE]... . VALUE . -s --no-follow-symlinks (symlinks) . . -r --sandbox-symlinks / . . -w --allow-write . : PUT DELETE. PUT X-Last-Modified/X-OC-MTime / (epoch) st_mtim . (false) . -D --convenient-webdav WebDAV MKCOL ( ) MOVE ( ). . -w . : false. -d --webdav WebDAV: MKCOL ( ) MOVE ( ) PROPFIND ( WebDAV) COPY ( ) PROPPATCH ( PUT) MKCOL MOVE WebDAV . (false) . -D . -A --archives tar ZIP curl -H 'Accept: application/tar' ... . API : 1. GET + Accept : application/tar application/x-tar => tar application/zip application/x-zip-compressed => ZIP 2. POST + ( POST ) "cd -L" ( -s -r) "tar -c * .*" ( ). . st_nlink > 1 tar . ZIP . DEFLATE ( -e). . : false. -l --no-listings (directory listings). --no-listings --no-indices: +------------+---------+---------+---------+---------+ | Path | Neither | -i | -l | -l -i | +============+=========+=========+=========+=========+ | /has-index | index | listing | index | 404 | | /no-index | listing | listing | 404 | 404 | +------------+---------+---------+---------+---------+ (false) . -i --no-indices index . (false) . README ( bottom) ( plain
  ).

                  .

              README           .
                      .




       -e --no-encode


              .

                      .

               (false)         .




       --encoded-filesystem FS_LIMIT --encoded-generated GEN_LIMIT


              FS_LIMIT     ( TEMP) 
                     GEN_LIMIT    .

                    k ()
           m () g () t ()  p ()       
                 b  .

                         .




       --encoded-prune MAX_AGE


                    MAX_AGE .

                      
           s () m () h ()  d ()      .




       -x --strip-extensions


                  :
              /file     /file.[s]htm[l]   .

           : false.




       --404 FALLBACK-FILE


              404    GET
                 FALLBACK-FILE     .

            FALLBACK-FILE          -s/-r .




       -q --quiet...


               .

                N      :
             N == 0 -   
             N >= 1 -      ("IP was served something")
             N >= 2 -            
             N >= 3 -     




       -Q --quiet-time


               (timestamp)    .




       -c --no-colour


                 .




 (NOTES)
         
           ETag
         
         i-node   
          .

           
          
         
         ( FAT
          
       )  
          
          ETag
         (  
       2023-02-12T01:00:00.100000000  
          
       2023-02-12T01:00:00.000000000    
           
         2023-02-12T01:00:00.900000000
         
          If-None-Match:
       2023-02-12T01:00:00.000000000   304 Not
       Modified   ).

           
         FAT   
           
         ( 
           
       )   If-Modified-Since  
          
           
       .

 (EXAMPLES)
       http


                   8000  
                   .

            :
             p:\Rust\http> http
             Hosting "." on port 8000 without TLS and no authentication...
             Ctrl-C to stop.

             127.0.0.1:47880 was served directory listing for \\?\P:\Rust\http
             127.0.0.1:47902 was served file \\?\P:\Rust\http\http.1.html as text/html
             127.0.0.1:47916 was served file S:\Rust-target\doc\main.css as text/css
             127.0.0.1:48049 asked for OPTIONS
             127.0.0.1:47936 used disabled request method DELETE
             127.0.0.1:48222 used disabled request method PUT
             ^C

              `P:\Rust\http\target`     `S:\Rust-target` 
                :

             GET /
             GET /http.1.html
             GET /target/doc/main.css
             OPTIONS
             DELETE 
             PUT 

                     .




       http -s


                  .

             :
             127.0.0.1:47916 requested to GET nonexistent entity S:\Rust-target\doc\main.css




       http -w


                  .

             :
             127.0.0.1:47936 deleted file \\?\P:\Rust\http\http.1.html
             127.0.0.1:48222 created \\?\P:\Rust\http\index.html, size: 1033554B

            :
             DELETE /http.1.html
             PUT /index.html with request body containing roughly 1MB of data

                      ( )
             "T:/-=- TEMP -=-/http-P-Rust-http/writes/" 
           "T:/-=- TEMP -=-/http-P-Rust-http/writes/index.html"      
           "P:\Rust\http\http.1.html"   (    ).




       http -w -t "../TEMP"


                     .

            :      
           "P:/Rust/TEMP/http-P-Rust-http/writes/" 
           "P:/Rust/TEMP/http-P-Rust-http/writes/index.html"  .




       http -p 6969


                 6969  .

                  :
             Hosting "." on port 6969 without TLS and no authentication...

                 :
             Starting server failed: port taken.
             




       http -a 192.168.65.1


                 192.168.65.1   .

                    :
             Hosting "." on port 8000 under address 192.168.65.1 without TLS and no authentication...

                      :
             Starting server failed: The requested address is not valid in its context.
             (os error 10049).
             




       HTTP_SSL_PASS=pwd http --ssl cert/http8k.p12


                   cert/http8k.p12     "pwd"
            .

                   :
             Hosting "." on port 8000 TLS certificate from "cert/http8k.p12"
             and no authentication...




       http --gen-ssl


                     
            .

             :
             Hosting "." on port 8000 with TLS certificate from
             "$TEMP/http-P-Rust-http/tls/tls.p12" and no authentication...




       http --path-auth /=Pirate


                       "Pirate" .

             :
             Hosting "." on port 8000 without TLS and basic authentication...
             Basic authentication credentials:
             Path  Username  Password
             /     Pirate

                :
             127.0.0.1:15141 requested to GET http://127.0.0.1:8005/ without authorisation

             :
             127.0.0.1:15142 requested to GET http://127.0.0.1:8005/ with invalid credentials
             "Pirate:memelord11"

             :
             127.0.0.1:15142 correctly authorised to GET http://127.0.0.1:8005/
             127.0.0.1:15142 was served directory listing for \\?\P:\Rust\http




       http --path-auth /=Pirate:memelord42


                     
             "Pirate"    "memelord42".

             :
             Hosting "." on port 8000 without TLS and basic authentication...
             Basic authentication credentials:
             Path  Username  Password
             /     Pirate    memelord42

                   .




       http --gen-path-auth /


                   :
                    .

             :
             Hosting "." on port 8000 without TLS and basic authentication...
             Basic authentication credentials:
             Path  Username  Password
             /     jOvm8yCp  &gK=h&$-$HElLPb9HO%

                   .




       http --path-auth /=admin:admin --gen-path-auth /target/debug
       --path-auth target/doc= --path-auth target/.rustc_info.json=
       --path-auth target/release/=releases


                    /target/doc  /target/.rustc_info.json  
             /target/release    "releases"      
             /target/debug    :   
               "admin:admin"  .

             :
             Hosting "." on port 8000 without TLS and basic authentication...
             Basic authentication credentials:
             Path                      Username  Password
             /                         admin     admin
             /target/.rustc_info.json
             /target/debug             PYld448   l=Z~vdp,zAt^        .




       http -r


                     
              .

             :
             127.0.0.1:47916 requested to GET nonexistent entity S:\Rust-target\doc\main.css




       http --proxy X-Forwarded-For:127.0.0.1 --proxy
       X-Proxied-For:192.168.1.0/24 --proxy-redir X-Original-URL:127.0.0.1


                  X-Forwarded-For  X-Proxied-For  
                 localhost   192.168.1.0/24.

               127.0.0.1     .

               127.0.0.1  192.168.1.109  93.184.216.34
                :
             X-Forwarded-For: OwO
             X-Proxied-For: UwU
             X-Original-URL: https://reversely.proxied/jpegs

                 :
             Hosting "." on port 8000 without TLS and no authentication...
             Trusted proxies:
             Header           Network
             X-Forwarded-For  127.0.0.1
             X-Proxied-For    192.168.1.0/24
             Ctrl-C to stop.

             [2020-02-17 17:48:41] 127.0.0.1:1392 for OwO was served directory listing for \\?\P:\Rust\http
             [2020-02-17 17:49:12] 192.168.1.109:1403 for UwU was served directory listing for \\?\P:\Rust\http
             [2020-02-17 17:49:29] 93.184.216.34:1397 was served directory listing for \\?\P:\Rust\http
             [2020-02-17 17:48:41] Redirecting 127.0.0.1:1393 for OwO to https://reversely.proxied/jpegs/ - found index file index.html




       http --mime-type css:text/css;charset=utf-8 --mime-type :image/jpeg


                 .css   charset=utf8 
                  JPEG.

                :
             Hosting "." on port 8000 without TLS and no authentication...
             Serving files with no extension as image/jpeg.
             Serving files with .css extension as text/css; charset=utf-8.
             Ctrl-C to stop.

             [2020-07-20 12:32:24] 127.0.0.1:47916 was served file \\?\S:\Rust-target\doc\main.css as text/css; charset=utf-8
             [2020-07-20 12:32:25] 127.0.0.1:2803 was served file \\?\P:\121D800E\http\DSC_6505 as image/jpeg




       http --request-bandwidth 4K


                      4096   .

             :
             Hosting "." on port 8000 without TLS and no authentication...
             Requests limited to 4096B/s.
             Ctrl-C to stop.




 (AUTHORS)
         thecoshman
        nabijaczleweli
        pheki Adrian Herath
        cyqsimon jim4067 Orhun Parmaksiz
        Kian-Meng Ang 
       Theodore Ni  Thorbjorn Lindeijer .

  (REPORTING BUGS)
       

  (SEE ALSO)
       

http developers                    July 2026                           HTTP(1)