view etc/condom.1 @ 51195:3cbf29813eea

(struct frame): Rename members height to text_lines, width to text_cols, window_height to total_lines, window_width to total_cols, new_height to new_text_lines, new_width to new_text_cols. All uses changed. (struct frame): New members which consolidate common members of x_output, w32_output, and mac_output structures: left_pos, top_pos, pixel_height, pixel_width, x_pixels_diff, y_pixels_diff, win_gravity, size_hint_flags, border_width, internal_border_width, line_height, fringe_cols, left_fringe_width, right_fringe_width, want_fullscreen. All uses changed. (struct frame): New member column_width contaning the canonical column width, analogue to line_height. All uses changed. (struct frame): Rename members scroll_bar_pixel_width to config_scroll_bar_width, and scroll_bar_cols to config_scroll_bar_cols. All uses changed. (struct frame): New member scroll_bar_actual_width which consolidates and renames the vertical_scroll_bar_extra member of x_output, w32_output, and mac_output structures. All uses changed. (FRAME_PIXEL_HEIGHT): Renamed from PIXEL_HEIGHT and moved from x/w32/macterm.h files. All uses changed. Also change code which referred to f->output_data...->pixel_height. (FRAME_PIXEL_WIDTH): Renamed from PIXEL_WIDTH and moved from x/w32/macterm.h files. All uses changed. Also change code which referred to f->output_data...->pixel_width. (FRAME_LINES): Renamed from FRAME_HEIGHT. All uses changed. Also change code which referred to f->height. (FRAME_COLS): Renamed from FRAME_WIDTH. All uses changed. Also change code which referred to f->width. (FRAME_NEW_HEIGHT, FRAME_NEW_WIDTH): Remove macros; change uses to update new_text_lines and new_text_cols members directly. (FRAME_CONFIG_SCROLL_BAR_WIDTH): Renamed from FRAME_SCROLL_BAR_PIXEL_WIDTH. All uses changed. (FRAME_CONFIG_SCROLL_BAR_COLS): Renamed from FRAME_SCROLL_BAR_COLS. All uses changed. (FRAME_LEFT_SCROLL_BAR_COLS, FRAME_RIGHT_SCROLL_BAR_COLS): Renamed from FRAME_LEFT_SCROLL_BAR_WIDTH and FRAME_RIGHT_SCROLL_BAR_WIDTH, resp. All uses changed. (FRAME_SCROLL_BAR_AREA_WIDTH, FRAME_LEFT_SCROLL_BAR_AREA_WIDTH) (FRAME_RIGHT_SCROLL_BAR_AREA_WIDTH): New macros. (FRAME_TOTAL_COLS): Renamed from FRAME_WINDOW_WIDTH. (SET_FRAME_COLS): Renamed from SET_FRAME_WIDTH. (FRAME_TOTAL_COLS_ARG): Renamed from FRAME_WINDOW_WIDTH_ARG. (WINDOW_VERTICAL_SCROLL_BAR_COLUMN): Remove unused macro. (WINDOW_VERTICAL_SCROLL_BAR_HEIGHT): Remove unused macro. (FRAME_LINE_HEIGHT): Renamed from CANON_Y_UNIT. Unconditionally return line_height member (it now has proper value also for non-window frames). (FRAME_COLUMN_WIDTH): Renamed from CANON_X_UNIT. Unconditionally return new column_width member (rather than the default font width). (FRAME_FRINGE_COLS, FRAME_LEFT_FRINGE_WIDTH) (FRAME_RIGHT_FRINGE_WIDTH): Renamed from FRAME_X_... and moved from x/w32/macterm.h files. Unconditionally return corresponding member of frame structure (they now have proper values also for non-window frames). (FRAME_TOTAL_FRINGE_WIDTH): Renamed from FRAME_FRINGE_WIDTH. Calculate return value from left and right widths. (FRAME_INTERNAL_BORDER_WIDTH): Unconditionally return internal_border_width member (has proper value for non-window frame). (FRAME_PIXEL_X_FROM_CANON_X): Renamed from PIXEL_X_FROM_CANON_X. (FRAME_PIXEL_Y_FROM_CANON_Y): Renamed from PIXEL_Y_FROM_CANON_Y. (FRAME_CANON_X_FROM_PIXEL_X): Renamed from CANON_X_FROM_PIXEL_X. (FRAME_CANON_Y_FROM_PIXEL_Y): Renamed from CANON_Y_FROM_PIXEL_Y. (FRAME_LINE_TO_PIXEL_Y): Renamed from CHAR_TO_PIXEL_ROW, consolidated from xterm.h, macterm.h, and w32term.h. (FRAME_COL_TO_PIXEL_X): Renamed from CHAR_TO_PIXEL_COL, consolidated from xterm.h, macterm.h, and w32term.h. (FRAME_TEXT_COLS_TO_PIXEL_WIDTH): Renamed from CHAR_TO_PIXEL_WIDTH consolidated from x/mac/w32term.h. (FRAME_TEXT_LINES_TO_PIXEL_HEIGHT): Renamed from CHAR_TO_PIXEL_HEIGHT consolidated from x/mac/w32term.h. (FRAME_PIXEL_Y_TO_LINE): Renamed from PIXEL_TO_CHAR_ROW consolidated from x/mac/w32term.h. (FRAME_PIXEL_X_TO_COL): Renamed from PIXEL_TO_CHAR_COL consolidated from x/mac/w32term.h. (FRAME_PIXEL_WIDTH_TO_TEXT_COLS): Renamed from PIXEL_TO_CHAR_WIDTH consolidated from x/mac/w32term.h. (FRAME_PIXEL_HEIGHT_TO_TEXT_LINES): Renamed from PIXEL_TO_CHAR_HEIGHT consolidated from x/mac/w32term.h.
author Kim F. Storm <storm@cua.dk>
date Sat, 24 May 2003 21:58:07 +0000
parents 23a1cea22d13
children
line wrap: on
line source

CONDOM(1)	      EUNUCH Programmer's Manual		CONDOM(1)



NAME
	condom - Protection against viruses and prevention of child
		 processes

SYNOPSIS
	condom [options] [processid]

DESCRIPTION
	_condom_ provides protection against System Transmitted
Viruses (STVs) that may invade your system.  Although the spread of
such viruses across a network can only be abated by aware and cautious
users, _condom_ is the only highly-effective means of preventing
viruses from entering your system (see celibacy(1)).  Any data passed
to _condom_ by the protected process will be blocked, as specified by
the value of the -s option (see OPTIONS below).  _condom_ is known to
defend against the following viruses and other malicious
afflictions...

	o AIDS
	o Herpes Simplex (genital varieties)
	o Syphilis
	o Crabs
	o Genital warts
	o Gonorrhea
	o Chlamydia
	o Michelangelo
	o Jerusalem

	When used alone or in conjunction with pill(1), sponge(1),
foam(1), and/or setiud(3), _condom_ also prevents the conception of a
child process.  If invoked from within a synchronous process, _condom_
has, by default, an 80% chance of preventing the external processes
from becoming parent processes (see the -s option below).  When other
process contraceptives are used, the chance of preventing a child
process from being forked becomes much greater.  See pill(1),
sponge(1), foam(1), and setiud(3) for more information.
	If no options are given, the current user's login process (as
determined by the environment variable USER) is protected with a
Trojan rough-cut latex condom without a reservoir tip.  The optional
'processid' argument is an integer specifying the process to protect.
	NOTE: _condom_ may only be used with a hard disk.  _condom_
will terminate abnormally with exit code -1 if used with a floppy
disk (see DIAGNOSTICS below).

OPTIONS
     The following options may be given to _condom_...

	-b BRAND	BRANDs are as follows...

			trojan (default)
			ramses
			sheik
			goldcoin
			fourex

	-m MATERIAL	The valid MATERIALs are...

			latex (default)
			saranwrap
			membrane -- WARNING!  The membrane option is _not_
			endorsed by the System Administrator General as an
			effective barrier against certain viruses.  It is
			supported only for the sake of tradition.

	-f FLAVOR	The following FLAVORs are currently supported...

			plain (default)
			apple
			banana
			cherry
			cinnamon
			licorice
			orange
			peppermint
			raspberry
			spearmint
			strawberry

	-r		Toggle reservoir tip (default is no reservoir tip)

	-s STRENGTH	STRENGTH is an integer between 20 and 100 specifying
			the resilience of _condom_ against data passed to
			_condom_ by the protected process.  Using a larger
			value of STRENGTH increases _condom_'s protective
			abilities, but also reduces interprocess communication.
			A smaller value of STRENGTH increases interprocess
			communication, but also increases the likelihood of a
			security breach.  An extremely vigorous process or
			one passing an enormous amount of data to _condom_
			will increase the chance of _condom_'s failure.  The
			default STRENGTH is 80%.

	-t TEXTURE	Valid TEXTUREs are...

			rough (default)
			ribbed
			bumps
			lubricated (provides smoother interaction between
			            processes)

	WARNING: The use of an external application to _condom_ in
order to reduce friction between processes has been proven in
benchmark tests to decrease _condom_'s strength factor!  If execution
speed is important to your process, use the '-t lubricated' option.

DIAGNOSTICS
	_condom_ terminates with one of the following exit codes...

	-1	An attempt was made to use _condom_ on a floppy disk.

	 0	_condom_ exited successfully (no data was passed to
		the synchronous process).

	 1	_condom_ failed and data was allowed through.  The
		danger of transmission of an STV or the forking of a child
		process is inversely proportional to the number of other
		protections employed and is directly proportional to
		the ages of the processes involved.

BUGS
	_condom_ is NOT 100% effective at preventing a child process
from being forked or at deterring the invasion of a virus (although
the System Administrator General has deemed that _condom_ is the most
effective means of preventing the spread of system transmitted
viruses).  See celibacy(1) for information on a 100% effective program
for preventing these problems.
	Remember... the use of sex(1) and other related routines
should only occur between mature, consenting processes.  If you must
use sex(1), please employ _condom_ to protect your process and your
synchronous process.  If we are all responsible, we can stop the
spread of STVs.

AUTHORS and HISTORY
	The original version of _condom_ was released in Roman times
and was only marginally effective.  With the advent of modern
technology, _condom_ now supports many more options and is much more
effective.
	The current release of _condom_ was written by Ken Maupin at
the University of Washington (maupin@cs.washington.edu) and was last
updated on 10/7/92.

SEE ALSO
	celibacy(1), sex(1), pill(1), sponge(1), foam(1), and
setiud(3)