options.doc

汇编大全 中国矿业大学计算机学院 汇编实验5

   information from the filename.  String value.
EXT_SEP is the union of PATH_SEP and the set of characters separating a
   filename extension from the rest of the filename.  String value.
EXT_CH
   Character that separates base part of filename from extension.
   Char value.
NEED_MEMSET  If defined, zoo will define its own equivalent of memset().
	if not defined, zoo will try to link with a standard library function
	memset().
EXT_DFLT
   default extension for archives.  String.  Currently ".zoo".
NIXFNAME
   If defined, PATH_CH, PATH_SEP, EXT_SEP, EXT_CH, and EXT_DFLT get defined
   to conform to **IX conventions and should not be separately defined
MSFNAME
   if defined, PATH_CH, PATH_SEP, EXT_SEP, EXT_CH, EXT_DFLT, and
   DISK_CH get defined to conform to MS-DOS conventions and should
   not be separately defined (not currently implemented)
FORCESLASH
   If defined any backslashes in names of files will be converted to
   slashes before the files are added to an archive.  This is useful
   for MSDOS-like systems that accept both slashes and backslashes,
   since the standard archive format allows only slashes as directory
   separators.
REN_LINK
   Rename a file by using link() followed by unlink() (e.g. Xenix, System V)
REN_STDC
   Use ANSI standard rename function:  "int rename(old, new)" (e.g. 4.3BSD,
   Turbo C).  Note:  define exactly one of REN_LINK, REN_REV, and REN_STDC.
REN_REV
   Use reverse rename function:  "int rename(new, old)" (e.g. Microsoft C)
SETMODE
   Change mode of standard output to binary when piping output, then change
   it back to text.  Macros MODE_BIN(zoofile) and MODE_TEXT(zoofile) must
   also be defined.  Probably specific to MS-DOS.
SETBUF
   Standard output should be set to be unbuffered so output shows up
   quickly.
SPECNEXT
   If defined, a machine-dependent function nextfile() must be defined that
   will expand wildcards in a supplied pathname. If not defined, any
   wildcard expansion must have been done before the command line parameters
   are supplied to the program.  For details see the file nextfile.c.
SPECEXIT
   Custom exit handler is needed.  A function called zooexit()
   must be defined.  If SPECEXIT is not defined, zoo uses its
   own zooexit() function which simply calls exit().
SPECINIT
   If defined, zoo's main() function will call spec_init() before
   doing anything else.  Any system-specific initialization may be
   done at this point.
GETTZ
   If defined, a function gettz() must also be defined that will
   return the current timezone, in seconds west of GMT, as a long
   value.  Currently such a function is already defined in files
   bsd.c and sysv.c.  If and only if GETTZ is defined, zoo will
   store the current timezone for each file that is archived,
   and will list the timezone for each file that has one when it
   lists archive contents.
ALWAYS_INT
   In function prototypes for fgetc(), fread(), and fwrite(),
   traditional practice made certain arguments int, though
   they ought to be char and unsigned respectively.  If
   ALWAYS_INT is defined, prototypes will use int only,
   else the correct types are used.
NO_STDIO_FN
   Defining this symbol will cause declarations of fputc(),
	fread(), and fwrite() to not be done by the zoo header files.
	Reported necessary for VMS;  may also help in other environments.
IO_MACROS
   If defined, some portable I/O functions are defined as macros,
   saving space.
ZOOCOMMENT
   If defined, archive comments are fully enabled.  If not defined,
   zoo code will be smaller at the cost that archive comments will
   be listed but cannot be updated.  COMPILATION WITHOUT ZOOCOMMENT
   DEFINED HAS NOT YET BEEN TESTED.
TRACE_IO
   This is for debugging.  If defined, it will cause code to
   be compiled that will trace all archive header and directory
   entry I/O by showing it on the screen in human-readable format.
   The tracing will then occur if any Expert command given to zoo
   is preceded by a colon.  E.g., if compiled with TRACE_IO on and
   given the command "zoo :l xyz", zoo will give a directory
   listing of xyz.zoo exactly as it would with "zoo l xyz" except
   that all archive header and directory entry reads and writes
   will be shown on the screen.  The tracing code is localized
   to the files zoo.c and portable.c, so just these two files
   can be compiled afresh when TRACE_IO is turned on or switched
   off.  NOTE:  The symbol TRACE_LIST, internal to the file
   "zoolist.c", enables debugging information too.  Do not define
   both TRACE_IO and TRACE_LIST because (a) a symbol conflict will
   occur and (b) the debugging information will be duplicated.
UNBUF_IO
   If defined, some I/O is done using low-level system calls read() and
   write().  To do this, the low-level file descriptor is synchronized with
   the buffered zoofile before such I/O is done.  To do this, read(),
   write(), and lseek() system calls must be available and the fileno()
   macro must return the file descriptor for a buffered file.  This is
   not portable and should definitely not be done by most end users.  If
   UNBUF_IO is defined, also defined must be a symbol UNBUF_LIMIT with a
   numerical value that specifies the threshold over which unbuffered I/O
   should be used.  For example, if the value of UNBUF_LIMIT is 512, then
   any I/O on a zoofile that reads or writes more than 512 bytes will be
   done using read() or write() system calls.  The use of unbuffered I/O
   with a threshold in the range 512 to 1024 can enhance performance by up
   to 50%.  The corruption of data is a serious matter.  Do not define
   UNBUF_IO unless you are willing to exhaustively test the compiled code
   on your system to make sure it works, and accept full responsibility for
   any adverse consequences.  Some standard I/O libraries may attempt to
   optimize the working of fseek() on files opened for read access only,
   and cause UNBUF_IO to fail.
UNBUF_LIMIT
   Needed if and only if UNBUF_IO is defined.  Holds a numeric value.
   All I/O done in blocks that are larger than UNBUF_LIMIT bytes
   will be done unbuffered.  See UNBUF_IO.
FILTER
   If defined, code will be compiled in to enable the fc and fd
   commands (compress or decompress, reading standard input and
   writing to standard output).  These commands are useful only
   on systems that allow programs to easily act as filters.
VER_DISPLAY
   The character that will separate filenames from generation numbers
   in listings of archive contents.  Must be a single character
   in double quotes.
VER_INPUT
   The characters that will be accepted as separating filenames
   from generation numbers when typed as an argument to select
   specific files from an archive.  String value.  May include
   one or more characters;  any of them may then be typed and
   will work.
NOSTRCHR
   Although 4.3BSD as distributed from Berkeley includes strchr()
   and strrchr() library functions, 4.2BSD and similar systems
   may not.  If so, defining NOSTRCHR will cause zoo to use
   index() and rindex() instead.
STDARG, VARARGS.  How to invoke functions that accept a variable
   number of arguments.  Define one of these.  STDARG causes the
   ANSI-style header stdarg.h to be used.  VARARGS causes the **IX-style
   varargs.h header to be used.  If you define STDARG, you must also
   define ANSI_PROTO (see above).
DIRECT_CONVERT.  Zoo archives use a canonical little-endian byte order,
   and functions are portably defined to convert between this and the
   internal format used by an implementation.  If the symbol 
   DIRECT_CONVERT is defined, the zoo code will not bother doing this 
   portable conversion, but simply assume that the machine's internal
   format is the same as the canonical byte order used in zoo archives.
   DIRECT_CONVERT should be defined *only* if your implementation uses:
   little-endian byte order, 2-byte ints, and 4-byte longs.  If there is
   any doubt whatsoever, don't define DIRECT_CONVERT;  the overhead of
   portable conversion is not significant.
SZ_SCREEN.  If this symbol is not defined, a screen height of 24 lines
	is assumed by the multiscreen help.  If desired, this symbol can be
	defined to some other nonnegative value of screen height.
NEED_MEMMOVE.  If defined, zoo will define its own equivalent of memmove().
	If not defined, zoo will try to link with a standard library function
	memmove().
NEED_VPRINTF.  If this symbol is defined, zoo will use its own jury-
	rigged vprintf function.  If this symbol is not defined, zoo will
	try to link with vprintf in the standard library.