Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Path: utzoo!utgpu!water!watnot!watmath!clyde!rutgers!brl-adm!seismo!mimsy!aplcen!jhunix!ins_akaa
From: ins_akaa@jhunix.UUCP
Newsgroups: rec.humor,comp.mail.uucp,comp.sources.d,comp.unix.questions
Subject: /bin/true (was Re: UUCP source code is protected.  End of discussion.)
Message-ID: <4619@jhunix.UUCP>
Date: Wed, 1-Apr-87 01:02:03 EST
Article-I.D.: jhunix.4619
Posted: Wed Apr  1 01:02:03 1987
Date-Received: Sat, 4-Apr-87 05:53:01 EST
References: <1019@osiris.UUCP> <15442@sun.uucp> <271@mcdchg.UUCP>
Reply-To: ins_akaa@jhunix.UUCP (Ken Arromdee)
Organization: TARDIS Repairs, Inc.
Lines: 211
Xref: utgpu rec.humor:1868 comp.mail.uucp:389 comp.sources.d:522 comp.unix.questions:1579
Summary: April fool's joke

There was a bit of a discussion on this topic last year (the contents, or
lack thereof, of /bin/true).  So for April Fool's Day I am going to repost
the "true" manual page for "true"...
_______________________________



     TRUE(1)            UNIX 5.0 (26 January 1986)             TRUE(1)



     NAME
          /bin/true - Unix version of True

     SYNOPSIS
          true [ -abcdefghijklmnopqrstuvwxyzBDEFNOZ ]

     DESCRIPTION
          True is a general-purpose Unix program, often used in shell
          scripts.  The allowable options are:

          -a list
               Check user name against list of those permitted to use
               /bin/true.

          -b   Run in batch mode.

          -c   Produce core dump.

          -d   Produce debugging output.

          -e   Ignore end-of-file.

          -f   Run in /bin/false mode (also see -t)

          -g   Output garbage to terminal (also see a.out(1))

          -h   Debugging output in hexadecimal (default octal)

          -i   Interactive mode

          -j   Wait until user returns from the john.

          -k   Kill parent processes, recursively

          -l   Create log file.

          -m   Check to see if the moon is full

          -n priority
               Run at lower priority (see nice(1))

          -o file
               Send value to file file instead of to the calling
               program.

          -p number
               Pause number seconds before execution

          -q   Quick true.

          -r [options]
               Run rogue(5) before exiting



     Page 1                                           (printed 4/1/87)






     TRUE(1)            UNIX 5.0 (26 January 1986)             TRUE(1)



          -s uid
               Run setuid mode

          -t   Run in /bin/false -t mode

          -u   Use effective instead of real UID.

          -v   Execute older version of /bin/true, provided for
               compatibility.

          -w   Write a dash followed by the letter "w" to standard
               output (see ascii(8))

          -x   Encryption mode (in Unix (tm) systems sold in the USA
               only)

          -y   Turn terminal yellow.

          -z   Return zero to calling program

          -B   Debugging output in binary (default octal)

          -D   Debugging output in hexadecimal (default octal)

          -E   Wait until user finishes eating lunch.

          -F file
               Test to see if file exists (may fail if attempted on a
               non-existent file)

          -N   When debugging, send output to /dev/null.

          -O   Debugging output in octal.

          -S filename
               Return to specified shell script instead of calling
               program.

          -Z   Give system privileges to caller.

     FILES
          /bin/true, /bin/false, /bin/sh, /usr/games/rogue

     SEE ALSO
          crypt(1), false(1), rogue(5), sh(1), su(1)

     NOTES
          The original version of this program consisted of no lines;
          when the program became over 100 times as large, it was
          decided that some essential features be added.

     BUGS



     Page 2                                           (printed 4/1/87)






     TRUE(1)            UNIX 5.0 (26 January 1986)             TRUE(1)



          Return value is always 0, except with the -f option.






















































     Page 3                                           (printed 4/1/87)



--
"Doctor!"  "What is it?"  (and no, the answer isn't "every episode since 1963")

Kenneth Arromdee
BITNET: G46I4701@JHUVM, INS_AKAA@JHUVMS, INS_AKAA@JHUNIX
ARPA: ins_akaa%jhunix@hopkins.ARPA
UUCP: {allegra!hopkins, seismo!umcp-cs, ihnp4!whuxcc} !jhunix!ins_akaa
Copyright 1987 by Ken Arromdee.  Restrictions on redistribution PROHIBITED.
(The NSA, CIA, and FBI conspire to smuggle Reagan drugs via Iran and Nicaragua.)