post ( 1 ) USER COMMANDSpost ( 1 )


NAME

post - post local package download files to www host

SYNOPSIS

post [ options ] [ file ]

DESCRIPTION

post copies local package download files to a www host. The files and host are defined in file. If file is omitted then post.db is read. The caller must have rcp(1) access to the www host.

The shell script VERSION contains variable assignments for admin(1), two of which are use by post :
HOST
The www host name, suitable for rcp(1) and rsh(1). The default is www.research.att.com.
USER
The url cgi user name. The default is the user name of the caller.

The input file is a shell script that contains variable assignments and make type assertions (implemented as sh(1) functions.) VERSION file variables may be referenced in the input file. The variables are:
private
The private directory on the www host, referenced as $HOME/$private. The default is www-etc.
public
The public directory on the www host, referenced as $HOME/$public. The default is wwwfiles.
directory
The directory offset on the www host where files will be copied. Referenced as $HOME/$private/$directory and $HOME/$public/$directory. The default is download.

In the following, pathnames for file arguments have + translated to / in the target. *.mm files are converted to HTML using mm2html(1). The assertions are:
external | internal [CGI | INDEX name | LINK | PAGE [MD5] | release] : file ... | package ...
Files in package are marked for external or internal sites. The optional types are:
CGI
file ... are placed under cgi-bin.
release
Only releases as new or newer than release are considered. package-locale are also checked by default.
INDEX name
An index is generated in name.html from the lists in file ...
LINK
package ... are links to packages maintained by other sites. The package.inx, package.req, package.ver, and package.lnk files must be in ../gen. The contents of ../gen/package.lnk must be the URL for the package package.
PAGE
file ... are placed under $directory. If MD5 is specified then file.md5 for each file is generated and placed under $directory.

post maintains an associative array of timestamps of files copied to the remote host in the file file.ds. Only files newer than the previous timestamp are copied.

OPTIONS

-F, --force
Ignore timestamps and update all files.
-h, --html
Copy only HTML files.
-l, --local
Generate local files but do not copy to remote host.
-n, --exec
--noexec shows actions but does not execute. On by default; -n means --noexec.
-N, --show
Show actions but do not execute.
-r, --release=release
Do not post packages older than release.
-v, --verbose
List actions on the standard error as they are done.

SEE ALSO

admin(1), htmlrefs(1), mm2html(1), sh(1), ssh(1), scp(1), rcp(1), rsh(1)

IMPLEMENTATION

version
post (AT&T Research) 2007-11-05
author
Glenn Fowler <gsf@research.att.com>
copyright
Copyright © 2000-2006 AT&T Intellectual Property
license
http://www.opensource.org/licenses/cpl1.0.txt