mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix Makefile and README.md for 2020/ferguson2

Browse Source
This commit is contained in:
Landon Curt Noll committed 2023-03-10 22:47:50 -08:00
1 parent a488f5429e
commit 5610c83b38
2 files changed
+288 -511
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2020/ferguson2/Makefile
+118 -388
View File
@@ -1,14 +1,41 @@
#!/usr/bin/env make #!/usr/bin/env make
# #
# 2020 makefile # IOCCC 2020 winning entry - ferguson2
################################################################################
# #
# This work by Landon Curt Noll, Simon Cooper, and Leonid A. Broukhis # Regarding individual entries:
# is licensed under: #
# IOCCC winning entry code may not work on your system. Even with standards,
# conditions and build environments change, especially when it comes to more
# extreme code such you might find in an IOCCC winner. Moreover, what was
# allowed and liked in one IOCCC contest may no longer be liked/allowed in
# later IOCCC years.
#
# Corrections on winning author and fixing typos in remarks are VERY WELCOME.
#
# GitHub pull requests are welcome:
#
# If you have a patch that might make running an entry work in modern Unix-like
# environments, please create a GitHub pull request for the IOCCC judges to
# consider.
#
# Suggestions and corrections regarding Makefiles, winning author information,
# fixing typos in remarks, and code patches are welcome via opening a GitHub
# issue or better yet, by creating a GitHub pull request for the IOCCC judges
# to consider. To form a GitHub issue or GitHub pull, please visit:
#
# https://github.com/ioccc-src/winner
#
################################################################################
# This work by Landon Curt Noll and Leonid A. Broukhis is licensed under:
# #
# Creative Commons Attribution-ShareAlike 3.0 Unported License. # Creative Commons Attribution-ShareAlike 3.0 Unported License.
# #
# See: http://creativecommons.org/licenses/by-sa/3.0/ # See: http://creativecommons.org/licenses/by-sa/3.0/
############################# #############################
# shell used by this Makefile # shell used by this Makefile
############################# #############################
@@ -19,264 +46,7 @@ SHELL= bash
# common tool locations # common tool locations
####################### #######################
# #
A2P= a2p include ../../var.mk
AR= ar
ASA= asa
AT= at
ATQ= atq
ATRM= atrm
AWK= awk
BANNER= banner
BASE64= base64
BASENAME= basename
BATCH= batch
BC= bc
BINHEX= binhex
BISON= bison
BUNZIP2= bunzip2
BZCAT= bzcat
BZCMP= bzcmp
BZDIFF= bzdiff
BZEGREP= bzegrep
BZFGREP= bzfgrep
BZGREP= bzgrep
BZIP2= bzip2
BZLESS= bzless
BZMORE= bzmore
C2PH= c2ph
C89= c89
C99= c99
CAL= cal
CALC= calc
CAT= cat
CD= cd
CHFLAGS= chflags
CHGRP= chgrp
CHMOD= chmod
CKSUM= cksum
CLANG= clang
CLANG_PLUSPLUS= clang++
CLEAR= clear
CMP= cmp
COL= col
COLLDEF= colldef
COLRM= colrm
COLUMN= column
COMPRESS= compress
CP= cp
CPIO= cpio
CPP= cpp
CRC32= crc32
CSH= csh
CSPLIT= csplit
CURL= curl
CUT= cut
C_PLUSPLUS= c++
C_PLUSPLUS_FILT= c++filt
DATE= date
DC= dc
DD= dd
DF= df
DIFF3= diff3
DIFF= diff
DIG= dig
DIRNAME= dirname
ED= ed
EGREP= egrep
ENV= env
EQN= eqn
ETAGS= etags
EXPECT= expect
EXPR= expr
FALSE= false
FGREP= fgrep
FILE= file
FIND2PERL= find2perl
FIND= find
FLEX= flex
FLEX_PLUSPLUS= flex++
FMT= fmt
FOLD= fold
FS_USAGE= fs_usage
FUNZIP= funzip
FUSER= fuser
GCC= gcc
GDIFFMK= gdiffmk
GENCAT= gencat
GENSTRINGS= genstrings
GETOPT= getopt
GETOPTS= getopts
GINDENT= gindent
GNUMAKE= gnumake
GREP= grep
GROFF= groff
GROFFER= groffer
GROG= grog
GROPS= grops
GROTTY= grotty
GUNZIP= gunzip
GVIM= gvim
GZCAT= gzcat
GZEXE= gzexe
GZIP_PROG= gzip
G_PLUSPLUS= g++
H2PH= h2ph
H2XS= h2xs
HASH= hash
HEAD= head
HOSTNAME_PROG= hostname
ICONV= iconv
ID= id
INDENT= indent
INFO= info
JOT= jot
KILL= kill
KSH= ksh
LAST= last
LD= ld
LESSECHO= lessecho
LEX= len
LINK= link
LN= ln
LS= ls
M4= m4
MAKE= make
MAN= man
MKDIR= mkdir
MKFIFO= mkfifo
MKTEMP= mktemp
MV= mv
NANO= nano
NASM= nasm
NEQN= neqn
NICE= nice
NL= nl
NM= nm
NOHUP= nohup
NROFF= nroff
NSLOOKUP= nslookup
OD= od
OPENSSL= openssl
PASTE= paste
PATCH= patch
PATHCHK= pathchk
PAX= pax
PERL= perl
PICO= pico
PR= pr
PRINTENV= printenv
PS= ps
PTAR= ptar
PTARDIFF= ptardiff
PTARGREP= ptargrep
PWD= pwd
PYDOC= pydoc
PYTHON= python
PYTHONW= pythonw
READLINK= readlink
RENICE= renice
RESET= reset
REV= rev
RI= ri
RM= rm
RMDIR= rmdir
RSYNC= rsync
RUBY= ruby
RVIM= rvim
SAY= say
SCP= scp
SCREEN= screen
SCRIPT= script
SDIFF= sdiff
SED= sed
SEQ= seq
SFTP= sftp
SH= sh
SHA1= sha1
SHA= sha
SHAR= shar
SHASUM5_18= shasum5.18
SHASUM= shasum
SIZE= size
SLEEP= sleep
SORT= sort
SSH= ssh
STAT= stat
STRIP= strip
STTY= stty
SUM= sum
SYNC= sync
TABS= tabs
TAIL= tail
TAR= tar
TEE= tee
TEST= test
TFTP= tftp
TIDY= tidy
TIME= time
TOP= top
TOUCH= touch
TPUT= tout
TPUT= tput
TR= tr
TROFF= troff
TRUE= true
TSET= tset
TSORT= tsort
UL= ul
UNAME= uname
UNCOMPRESS= uncompress
UNEXPAND= unexpand
UNIFDEF= unifdef
UNIFDEFALL= unifdefall
UNIQ= uniq
UNITS= units
UNLINK= unlink
UNZIP= unzip
UNZIPSFX= unzipsfx
UPTIME= uptime
UUDECODE= uudecode
UUENCODE= uuencode
UUIDGEN= uuidgen
VI= vi
VIEW= view
VIM= vim
VIMDIFF= vimdiff
W= w
WAIT4PATH= wait4path
WAIT= wait
WC= wc
WHAT= what
WHATIS= whatis
WHICH= which
WHO= who
WHOAMI= whoami
WHOIS= whois
WRTIE= write
XAR= xar
XARGS= xargs
XATTR= xattr
XXD= xxd
YACC= yacc
YES= yes
ZCAT= zcat
ZCMP= zcmp
ZDIFF= zdiff
ZEGREP= zegrep
ZFGREP= zfgrep
ZFORCE= zforce
ZGREP= zgrep
ZIP= zip
ZIPCLOAK= zipcloak
ZIPGREP= zipgrep
ZIPINFO= zipinfo
ZIPNOTE= zipnote
ZIPSPLIT= zipsplit
ZLESS= zless
ZMORE= zmore
ZNEW= znew
ZPRINT= zprint
ZSH= zsh
# Set X11_LIBDIR to the directory where the X11 library resides # Set X11_LIBDIR to the directory where the X11 library resides
# #
@@ -290,67 +60,25 @@ X11_LIBDIR= /opt/X11/lib
#X11_INCDIR= /usr/X11/include #X11_INCDIR= /usr/X11/include
X11_INCDIR= /opt/X11/include X11_INCDIR= /opt/X11/include
# CWARN - Silence warnings that ${CWARN} would normally complain about # Common C compiler warnings to silence
# CSILENCE -Compiler warnings
# #
ifeq ($(CC),clang) CSILENCE=
# clang CSILENCE and CWARN
#
#CSILENCE=
#CSILENCE= -Wno-implicit-int #CSILENCE= -Wno-implicit-int
CSILENCE= -Wno-missing-variable-declarations -Wno-missing-prototypes -Wno-disabled-macro-expansion \
-Wno-conversion -Wno-unused-value -Wno-empty-body -Wno-conversion -Wno-misleading-indentation \
-Wno-comment -Wno-unknown-warning-option
#
#CWARN= $CSILENCE}
#CWARN= -Wall $CSILENCE}
#CWARN= -Wall -Wextra $CSILENCE}
#CWARN= -Wall -Wextra -pedantic ${CSILENCE}
#CWARN= -Wall -Wextra -Weverything $CSILENCE}
CWARN= -Wall -Wextra -Weverything -pedantic ${CSILENCE}
else # Common C compiler warning flags
ifeq ($(CC),gcc)
# gcc CSILENCE and CWARN
# #
#CSILENCE= #CWARN= ${CSILENCE}
#CSILENCE= -Wno-implicit-int #CWARN= -Wall ${CSILENCE}
CSILENCE= -Wno-disabled-macro-expansion -Wno-conversion -Wno-unused-value -Wno-binding-in-condition \ #CWARN= -Wall -Wextra ${CSILENCE}
-Wno-empty-body -Wno-comment -Wno-misleading-indentation -Wno-unknown-warning-option
#
#CWARN= $CSILENCE}
#CWARN= -Wall $CSILENCE}
#CWARN= -Wall -Wextra $CSILENCE}
CWARN= -Wall -Wextra -pedantic ${CSILENCE} CWARN= -Wall -Wextra -pedantic ${CSILENCE}
else # Compiler standard
# default CSILENCE and WARN
#
#CSILENCE=
#CSILENCE= -Wno-implicit-int
CSILENCE= -Wno-disabled-macro-expansion -Wno-conversion -Wno-unused-value -Wno-empty-body \
-Wno-comment -Wno-misleading-indentation -Wno-unknown-warning-option
#
#CWARN= $CSILENCE}
#CWARN= -Wall $CSILENCE}
#CWARN= -Wall -Wextra $CSILENCE}
CWARN= -Wall -Wextra -pedantic ${CSILENCE}
#CWARN= -Wall -Wextra -Weverything $CSILENCE}
#CWARN= -Wall -Wextra -Weverything -pedantic ${CSILENCE}
endif
endif
# compiler standard
# #
#CSTD= #CSTD=
#CSTD= -ansi #CSTD= -ansi
CSTD= -std=c11 CSTD= -std=gnu17
# compiler bit architecture # Compiler bit architecture
# #
# Some entries require 32-bitness: # Some entries require 32-bitness:
# ARCH= -m32 # ARCH= -m32
@@ -362,21 +90,21 @@ CSTD= -std=c11
# #
ARCH= ARCH=
# defines that are needed to compile # Defines that are needed to compile
# #
#CDEFINE= #CDEFINE=
#CDEFINE= -DIOCCC
CDEFINE= -D_POSIX_C_SOURCE=200809L CDEFINE= -D_POSIX_C_SOURCE=200809L
# include files that are needed to compile # Include files that are needed to compile
# #
CINCLUDE= CINCLUDE=
#CINCLUDE= -include stdlib.h #CINCLUDE= -include stdlib.h
#CINCLUDE= -include stdio.h #CINCLUDE= -include stdio.h
#CINCLUDE= -include stdlib.h -include stdio.h #CINCLUDE= -include stdlib.h -include stdio.h
#CINCLUDE= -I ${X11_INCDIR} #CINCLUDE= -I ${X11_INCDIR}
#CINCLUDE= `${SDL2_CONFIG} --cflags`
# optimization # Optimization
# #
# Most compiles will safely use -O2. Some can use only -O1 or -O. # Most compiles will safely use -O2. Some can use only -O1 or -O.
# A few compilers have broken optimizers or this entry make break # A few compilers have broken optimizers or this entry make break
@@ -389,40 +117,58 @@ CINCLUDE=
#OPT= -O2 #OPT= -O2
OPT= -O3 OPT= -O3
# default flags for ANSI C compilation # Default flags for ANSI C compilation
# #
CFLAGS= ${CSTD} ${CWARN} ${ARCH} ${CDEFINE} ${CINCLUDE} ${OPT} CFLAGS= ${CSTD} ${CWARN} ${ARCH} ${CDEFINE} ${CINCLUDE} ${OPT}
# Libraries needed to build # Libraries needed to build
# #
LIBS= LIBS=
#LIBS= -L ${X11_LIBDIR} #LIBS= -lm
#LIBS= -L ${X11_LIBDIR} -lX11
#LIBS= `${SDL2_CONFIG} --libs`
# ANSI compiler # C compiler to use
#
# Set CC to the name of your ANSI compiler.
#
# Some entries seem to need gcc. If you have gcc, set
# both CC and MAY_NEED_GCC to gcc.
#
# If you do not have gcc, set CC to the name of your ANSI compiler, and
# set MAY_NEED_GCC to either ${CC} (and hope for the best) or to just :
# to disable such programs.
# #
CC= cc CC= cc
#CC= clang #CC=clang
MAY_NEED_GCC= gcc #CC=gcc
# Compiler add-ons or replacements for clang only
#
ifeq ($(CC),clang)
#
CSILENCE= -Wno-implicit-int-conversion -Wno-missing-prototypes \
-Wno-missing-variable-declarations -Wno-poison-system-directories \
-Wno-shorten-64-to-32
#
CWARN+= -Weverything
#
endif
# Specific add-ons or replacements for gcc only
#
ifeq ($(CC),gcc)
#
#CSILENCE+=
#
#CWARN+=
#
endif
############################## ##############################
# Special flags for this entry # Special flags for this entry
############################## ##############################
# #
OBJ= prog.o recode.o ENTRY= ferguson2
PROG= prog
#
OBJ= ${PROG}.o
DATA= chocolate-cake.md enigma.1 input.txt obfuscation.key \ DATA= chocolate-cake.md enigma.1 input.txt obfuscation.key \
obfuscation.md obfuscation.txt recode.1 recode.md \ obfuscation.md obfuscation.txt recode.1 recode.md \
try.this.txt try.this.txt
TARGET= prog recode TARGET= ${PROG}
# #
ALT_OBJ= ALT_OBJ=
ALT_TARGET= ALT_TARGET=
@@ -432,18 +178,19 @@ ALT_TARGET=
# build the entry # build the entry
################# #################
# #
all: ${TARGET} ${DATA} all: data ${TARGET}
@${TRUE} @${TRUE}
prog: prog.c .PHONY: all alt data everything clean clobber install \
${CC} ${CFLAGS} $< -o $@ ${LIBS} love haste waste maker easter_egg sandwich \
supernova deep_magic magic charon pluto
recode: recode.c ${PROG}: ${PROG}.c
${CC} ${CFLAGS} $< -o $@ ${LIBS} ${CC} ${CFLAGS} $< -o $@ ${LIBS}
# alternative executable # alternative executable
# #
alt: ${ALT_TARGET} alt: data ${ALT_TARGET}
@${TRUE} @${TRUE}
# data files # data files
@@ -451,13 +198,15 @@ alt: ${ALT_TARGET}
data: ${DATA} data: ${DATA}
@${TRUE} @${TRUE}
# both all and alt
#
everything: all alt
############### ###############
# utility rules # utility rules
############### ###############
# #
everything: all alt
clean: clean:
${RM} -f ${OBJ} ${ALT_OBJ} ${RM} -f ${OBJ} ${ALT_OBJ}
@-if [ -f indent.c ]; then \ @-if [ -f indent.c ]; then \
@@ -472,27 +221,13 @@ clobber: clean
echo 'ate sandwich'; \ echo 'ate sandwich'; \
fi fi
nuke: clobber
@${TRUE}
dist_clean: nuke
@${TRUE}
install: install:
@echo "Surely you are performing, Dr. Science!" @echo "Dr. Spock says that is not logical!"
@${TRUE} @${TRUE}
test: # you may be able to misunderstand the source by reading indent.c
@: # dummy target for my dev builds
# backwards compatibility
# #
build: all indent.c: ${PROG}.c
@${TRUE}
# you may be able to mis-understand the source by reading indent.c
#
indent.c: prog.c
@if which "${GINDENT}" >/dev/null 2>&1; then \ @if which "${GINDENT}" >/dev/null 2>&1; then \
echo ${RM} -f $@; \ echo ${RM} -f $@; \
${RM} -f $@; \ ${RM} -f $@; \
@@ -504,7 +239,7 @@ indent.c: prog.c
echo "${INDENT} < $< > $@"; \ echo "${INDENT} < $< > $@"; \
${INDENT} < $< > $@; \ ${INDENT} < $< > $@; \
else \ else \
echo "no intent prog found, ident $< yourself, sorry"; \ echo "no intent tool found, ident $< yourself, sorry"; \
echo "exit 1"; \ echo "exit 1"; \
exit 1; \ exit 1; \
fi fi
@@ -526,26 +261,21 @@ waste:
@echo 'haste' @echo 'haste'
@${TRUE} @${TRUE}
make: maker:
@echo 'We encourage you to attend a maker faire' @echo 'Participate in a maker faire'
@${TRUE} @${TRUE}
easter_egg: easter_egg:
@echo you expected to often mis-understand this $${RANDOM} magic @echo "you expected to often misunderstand this $${RANDOM} magic"
@echo chongo '<was here>' "/\\oo/\\" @echo "chongo '<was here>' /\\oo/\\"
@echo Eggy and Kitty @echo "Eggy"
fabricate fashion form frame manufacture produce: make sandwich: easter_egg
@${TRUE}
sandwich:
@if [ `id -u` -eq 0 ]; then \ @if [ `id -u` -eq 0 ]; then \
echo 'Okay.'; \ echo 'Okay.'; \
echo $${RANDOM}`date +%s`$${RANDOM} | \ echo "$${RANDOM}`date +%s`$${RANDOM}" > $@; \
${SHASUM} -a 512256 | \
${SED} -e 's/ .*//' > $@; \
else \ else \
echo 'Reall?!? Make it yourself.'; \ echo 'What? Make it yourself.'; \
exit 1; \ exit 1; \
fi fi
@@ -553,47 +283,47 @@ sandwich:
# as well as the West Coast Computer Faire and # as well as the West Coast Computer Faire and
# you might be confused different. :-) # you might be confused different. :-)
# #
supernova: nuke supernova: sandwich
@-if [ -r .code_anal ]; then \ @-if [ -r .code_anal ]; then \
${RM} -f .code_anal_v6; \ ${RM} -f .code_anal_v6; \
else \ else \
echo "planet deniers, like a few silly IAU members, are so cute when they try to defend their logic"; \ echo "planet deniers, like some members of the IAU, are so cute when they try to defend their logic"; \
fi fi
@echo A $@ helps ${MAKE} the elements that help form planets @echo "A $@ helps ${MAKE} the elements that help form planets"
@${TRUE} @${TRUE}
deep_magic: deep_magic: supernova
@-if [ -r .code_anal ]; then \ @-if [ -r .code_anal ]; then \
ccode_analysis --deep_magic 253d8c80830e2df66c018820004b3d4939821bbd7d781fc50d9e633797e44f65d1d62c707bb7e5a82c328a37bbf9ecb4c46fb56aa3f08641fcf45d10ba3c6081 --FNV1a_hash_512_bit "prog"; \ ccode_analysis --deep_magic 7889066cdbdf09b0408021754586e895be641cc9be29e7eafd3ca65359541f17 \
--FNV1a_hash_512_bit -v2 "${PROG}" "${PROG}.c"; \
else \ else \
echo "Wrong! Do it again!"; \ echo "Wrong! Do it again!"; \
sleep 1; \ sleep 2; \
echo "Wrong! Do it again!"; \ echo "Wrong! Do it again!"; \
sleep 1; \ sleep 2; \
echo "Wrong! Do it again!"; \ echo "Wrong! Do it again!"; \
fi fi
@${TRUE} @${TRUE}
magic: deep_magic magic: deep_magic
@-if [ -r .code_anal ]; then \ @-if [ -r .code_anal ]; then \
ccode_analysis --level 391581 --mode 216193 --state Riesel --FNV1a_hash_512_bit "prog"; \ ccode_analysis --level 20003 --mode 5717175 --FNV1a_hash_512_bit -v2 "${PROG}" "${PROG}.c"; \
else \ else \
echo "If you don't eat yer meat, you can't have any pudding!"; \ echo "If you don't eat yer meat, you can't have any pudding!"; \
echo "How can you have any pudding if you don't eat yer meat?!"; \ echo "How can you have any pudding if you don't eat yer meat?!"; \
echo "Be careful with that axe, Eugene."; \
fi fi
@${TRUE} @${TRUE}
# The IOCCC resident astronomer states # The IOCCC resident astronomer states
# #
charon: supernova charon: magic
@echo $@ is a dwarf planet @echo "$@ is a dwarf planet"
@echo dwarf is a type of planet @echo "dwarf is a type of planet"
@echo therefore we continue to tell the IAU that $@ is a planet @echo "therefore IAU, $@ is a planet"
pluto: supernova pluto: charon
${MAKE} charon ${MAKE} charon
@echo $@ is a dwarf planet @echo "$@ is a dwarf planet"
@echo dwarf is a type of planet @echo "dwarf is a type of planet"
@echo therefore, $@ is a planet @echo "therefore, $@ is a planet"
@echo having lots of planets is good feature because supernovae can help ${MAKE} a lot of them @echo "having lots of planets is good feature because supernovae can help ${MAKE} a lot of them"
2020/ferguson2/README.md
+170 -123
View File
@@ -1,36 +1,43 @@
# Most enigmatic # Most enigmatic
```
Cody Boone Ferguson <ioccc@xexyl.net> Cody Boone Ferguson <ioccc@xexyl.net>
<https://ioccc.xexyl.net> <https://ioccc.xexyl.net>
Twitter: @xexyl Twitter: @xexyl
```
## To build:
The code for this entry can be found in prog.c ```sh
make
```
## Judges' comments: ### To run:
### To use:
make ```sh
./prog ./prog
```
### Try: ### Try:
# IOCCC obfuscated! ```sh
echo IOCCC | ./prog # IOCCC obfuscated!
echo IOCCC | ./prog
# IOCCC obfuscated and de-obfuscated! # IOCCC obfuscated and de-obfuscated!
echo IOCCC | ./prog | ./prog echo IOCCC | ./prog | ./prog
# more input fun # more input fun
./prog - < try.this.txt 2>/dev/null ./prog - < try.this.txt 2>/dev/null
# more obfuscated fun # more obfuscated fun
echo testing test tests | ./recode echo testing test tests | ./recode
echo testing test tests | ./recode | ./prog - 2>/dev/null echo testing test tests | ./recode | ./prog - 2>/dev/null
echo testing test tests | ./recode | ./prog - 2>/dev/null | ./recode echo testing test tests | ./recode | ./prog - 2>/dev/null | ./recode
echo testing test tests | ./recode | ./prog - 2>/dev/null | ./recode | ./prog - 2>/dev/null echo testing test tests | ./recode | ./prog - 2>/dev/null | ./recode | ./prog - 2>/dev/null
```
### Selected Judges Remarks: ## Judges' comments:
This code is an enigma. Try to decode it! This code is an enigma. Try to decode it!
@@ -40,7 +47,9 @@ There is a good deal of useful documentation that is provided with this entry:
A useful man page for this entry. To render, try: A useful man page for this entry. To render, try:
man ./enigma.1 ```sh
man ./enigma.1
```
* recode.md ([recode.html][]) * recode.md ([recode.html][])
@@ -54,6 +63,7 @@ Because most of us could use some *Double-layered Chocolate Fudge Cake*!
[chocolate-cake.html]: chocolate-cake.html [chocolate-cake.html]: chocolate-cake.html
## Author's comments: ## Author's comments:
My remarks about my Heer 'Army' and Luftwaffe 'Air Force' Enigma simulator for My remarks about my Heer 'Army' and Luftwaffe 'Air Force' Enigma simulator for
the 27th IOCCC. the 27th IOCCC.
@@ -137,19 +147,21 @@ loop!
The author (Nathan) of the [1992 Worst Abuse of the Rules][] had this to say: The author (Nathan) of the [1992 Worst Abuse of the Rules][] had this to say:
This program is a hello world text encrypter/decrypter. It uses an ```
enigma (I think) style encryption algorithm, where the encryption This program is a hello world text encrypter/decrypter. It uses an
key character is modified by a value, determined from the previous enigma (I think) style encryption algorithm, where the encryption
character. Non-printable characters (those with ASCII values < ' ' key character is modified by a value, determined from the previous
or > 0x7e) are passed unaltered, thus any kind of file may be character. Non-printable characters (those with ASCII values < ' '
successfully processed, but if the original is printable, the or > 0x7e) are passed unaltered, thus any kind of file may be
processed file will be too. The input is read from stdin, and the successfully processed, but if the original is printable, the
output presented to stdout. The key, a text string, is presented as processed file will be too. The input is read from stdin, and the
a command argument. This is optional, and if omitted, the file is output presented to stdout. The key, a text string, is presented as
self-{de,en}crypted. To specify decryption, a "-" should be given a command argument. This is optional, and if omitted, the file is
before the key. (Actually encryption and decryption proper inverse self-{de,en}crypted. To specify decryption, a "-" should be given
operations, so you can use decrypt to scramble and encrypt to before the key. (Actually encryption and decryption proper inverse
descramble, if you're perverse.) operations, so you can use decrypt to scramble and encrypt to
descramble, if you're perverse.)
```
But the Enigma algorithm is more complex than that and my entry can encipher and But the Enigma algorithm is more complex than that and my entry can encipher and
decipher text in the manner of the Enigma machines of the Army (Heer) and Air decipher text in the manner of the Enigma machines of the Army (Heer) and Air
@@ -174,7 +186,9 @@ the result (after finishing the enciphering).
If you run it like: If you run it like:
./prog - ```sh
./prog -
```
It will prompt you for the settings of the machine (example below). It will prompt you for the settings of the machine (example below).
@@ -198,31 +212,32 @@ general program as well as how to use the two winning entries of the Morse code
that I referred to earlier: that I referred to earlier:
$ ./prog - ```sh
Ring 1: 3 $ ./prog -
Setting 1: I Ring 1: 3
Position 1: O Setting 1: I
Ring 2: 1 Position 1: O
Setting 2: C Ring 2: 1
Position 2: C Setting 2: C
Ring 3: 5 Position 2: C
Setting 3: C Ring 3: 5
Position 3: Z Setting 3: C
Reflector: 2 Position 3: Z
Plugboard pair 1: CO Reflector: 2
Plugboard pair 2: DE Plugboard pair 1: CO
Plugboard pair 3: SN Plugboard pair 2: DE
Plugboard pair 4: XY Plugboard pair 3: SN
Plugboard pair 5: MS Plugboard pair 4: XY
Plugboard pair 6: AT Plugboard pair 5: MS
Plugboard pair 7: VF Plugboard pair 6: AT
Plugboard pair 8: UR Plugboard pair 7: VF
Plugboard pair 9: KL Plugboard pair 8: UR
Plugboard pair 10: BJ Plugboard pair 9: KL
IOCCC Plugboard pair 10: BJ
^D IOCCC
CFDRG ^D
CFDRG
```
Notice that all output except the deciphered/enciphered text is sent to stdout. Notice that all output except the deciphered/enciphered text is sent to stdout.
@@ -231,17 +246,20 @@ default settings; as the judges suggest this invocation I will not show it here.
But you can also type it out like this: But you can also type it out like this:
$ ./prog ```sh
IOCCC $ ./prog
UUMMX IOCCC
UUMMX
```
The IOCCC comes from stdin; the `UUMMX` is written to stdout. The IOCCC comes from stdin; the `UUMMX` is written to stdout.
If I compile the 2014 entry and copy it to my local directory as If I compile the 2014 entry and copy it to my local directory as
`vik` I might do: `vik` I might do:
$ echo TEST|./prog |./vik | mplayer -demuxer rawaudio - ```sh
$ echo TEST|./prog |./vik | mplayer -demuxer rawaudio -
```
And you would hear Morse code of the Enigma output of 'TEST' (i.e. `KCWV`). Or And you would hear Morse code of the Enigma output of 'TEST' (i.e. `KCWV`). Or
perhaps not in this case. I'm not sure: I discovered a bug in that entry perhaps not in this case. I'm not sure: I discovered a bug in that entry
@@ -250,41 +268,53 @@ perhaps not in this case. I'm not sure: I discovered a bug in that entry
For example I can use the syntax provided in the winning remarks along with my For example I can use the syntax provided in the winning remarks along with my
entry to write it to a file. Say: entry to write it to a file. Say:
$ echo TEST|./prog |./vik > test.raw ```sh
$ ./vik e < test.raw | ./prog $ echo TEST|./prog |./vik > test.raw
LEST $ ./vik e < test.raw | ./prog
LEST
```
Why did that happen? This shows more details: Why did that happen? This shows more details:
$ ./vik e < test.raw ```sh
SCWV $ ./vik e < test.raw
SCWV
```
However as can be seen the first char is wrong: However as can be seen the first char is wrong:
$ echo TEST|./prog ```sh
KCWV $ echo TEST|./prog
KCWV
```
And piping the original output to my entry itself you get the original input: And piping the original output to my entry itself you get the original input:
$ echo TEST | ./prog | ./prog ```sh
TEST $ echo TEST | ./prog | ./prog
TEST
```
I'm not sure what causes that or if there's a way to fix it but that's the I'm not sure what causes that or if there's a way to fix it but that's the
idea anyway. Neither do I know if the original transcoding is correct. idea anyway. Neither do I know if the original transcoding is correct.
What if I use the input string 'LEST' instead? In that case it worked fine: What if I use the input string 'LEST' instead? In that case it worked fine:
$ echo LEST | ./prog | ./vik > lest.raw ```sh
$ ./vik e < lest.raw | ./prog $ echo LEST | ./prog | ./vik > lest.raw
LEST $ ./vik e < lest.raw | ./prog
LEST
```
But there's one obvious question, right? Let's try the most important one: But there's one obvious question, right? Let's try the most important one:
$ echo IOCCC | ./prog | ./vik > ioccc.raw ```sh
$ ./vik e < ioccc.raw $ echo IOCCC | ./prog | ./vik > ioccc.raw
UUMMX $ ./vik e < ioccc.raw
$ ./vik e < ioccc.raw | ./prog UUMMX
IOCCC $ ./vik e < ioccc.raw | ./prog
IOCCC
```
Phew! The program redeemed itself after the test failure! :) Phew! The program redeemed itself after the test failure! :)
@@ -294,8 +324,10 @@ too. Notice also how it showed the same output that my program gave it - `UUMMX`
What about the other Morse code entry? What about the other Morse code entry?
$ echo IOCCC | ./prog | ./dorssel ```sh
..- ..- -- -- -..- $ echo IOCCC | ./prog | ./dorssel
..- ..- -- -- -..-
```
### <a name="recode" href="#toc">The recode.c configurator</a> ### <a name="recode" href="#toc">The recode.c configurator</a>
@@ -331,26 +363,28 @@ The parser is in a sense rather rudimentary but allows for both interactive and
automatic (e.g. via the recode program) input. This does mean that something automatic (e.g. via the recode program) input. This does mean that something
like the following can happen: like the following can happen:
$ ./prog - ```sh
Ring 1: 1AB $ ./prog -
Setting 1: Position 1: Ring 2: 2CD Ring 1: 1AB
Setting 2: Position 2: Ring 3: 3 Setting 1: Position 1: Ring 2: 2CD
Setting 3: A Setting 2: Position 2: Ring 3: 3
Position 3: B Setting 3: A
Reflector: 1A Position 3: B
Plugboard pair 1: BC Reflector: 1A
Plugboard pair 2: .. Plugboard pair 1: BC
Plugboard pair 3: .. Plugboard pair 2: ..
Plugboard pair 4: DE Plugboard pair 3: ..
Plugboard pair 5: FG Plugboard pair 4: DE
Plugboard pair 6: HI Plugboard pair 5: FG
Plugboard pair 7: JK Plugboard pair 6: HI
Plugboard pair 8: LM Plugboard pair 7: JK
Plugboard pair 9: NO Plugboard pair 8: LM
Plugboard pair 10: PQ Plugboard pair 9: NO
IOCCC Plugboard pair 10: PQ
WD IOCCC
SIRDK WD
SIRDK
```
First of all: what is that WD? I didn't type that but it appeared it seems due First of all: what is that WD? I didn't type that but it appeared it seems due
to too much input that triggers this (it happens when I hit ctrl-d to end to too much input that triggers this (it happens when I hit ctrl-d to end
@@ -387,11 +421,12 @@ should help you remember (though not at this time in our world it might help you
later on?). This might become even more useful after the challenge is accepted, later on?). This might become even more useful after the challenge is accepted,
accomplished and made use of! :) accomplished and made use of! :)
$ echo ABC | ./prog ```sh
GYM $ echo ABC | ./prog
$ echo ABC | ./prog | ./prog GYM
ABC $ echo ABC | ./prog | ./prog
ABC
```
### <a name="layout" href="#toc">On the source code layout</a> ### <a name="layout" href="#toc">On the source code layout</a>
@@ -414,8 +449,10 @@ fix but I consider this inconsequential).
As for recode.c though I really love this: As for recode.c though I really love this:
/\ ```
/ This is *not* what you think: /\
/ This is *not* what you think:
```
...because it seems so wrong in C code at first glance. ...because it seems so wrong in C code at first glance.
@@ -427,11 +464,15 @@ It's an Enigma simulator! Isn't that proof that it's obfuscated itself?! :)
Silliness aside [obfuscation.txt][] has some of the ways I think this entry is Silliness aside [obfuscation.txt][] has some of the ways I think this entry is
obfuscated. To decipher try: obfuscated. To decipher try:
./recode -Robfuscation.key -fobfuscation.txt | ./prog - 2>/dev/null > obfuscation.md ```sh
./recode -Robfuscation.key -fobfuscation.txt | ./prog - 2>/dev/null > obfuscation.md
```
To encipher: To encipher:
./recode -Robfuscation.key -fobfuscation.md | ./prog - 2>/dev/null > obfuscation.txt ```sh
./recode -Robfuscation.key -fobfuscation.md | ./prog - 2>/dev/null > obfuscation.txt
```
The file [obfuscation.key][] is the key to decipher/encipher The file [obfuscation.key][] is the key to decipher/encipher
[obfuscation.txt][]. [obfuscation.txt][].
@@ -446,9 +487,10 @@ fun way to explore this entry.
As for the [obfuscation.key][] file if you observe the contents you'll find the As for the [obfuscation.key][] file if you observe the contents you'll find the
word OBFUSCATION: word OBFUSCATION:
2OB5FU1SC2ATIONCDEFGHJKLMPQRYZ ```
OB FU SC ATION 2OB5FU1SC2ATIONCDEFGHJKLMPQRYZ
OB FU SC ATION
```
### <a name="bugs" href="#toc">Bugs, limitations, differences from the real Enigma machines and general notes</a> ### <a name="bugs" href="#toc">Bugs, limitations, differences from the real Enigma machines and general notes</a>
@@ -467,11 +509,13 @@ program *however does validate this* (except when reading in settings via the
to B then no other letters can connect to A or B. Earlier there wasn't proper to B then no other letters can connect to A or B. Earlier there wasn't proper
detection and this caused invalid output. detection and this caused invalid output.
Why only 10 pairs when the German alphabet has 26 letters? It's ```
theoretically possible to have 13 but the Enigma typically had 10 pairs. Why only 10 pairs when the German alphabet has 26 letters? It's
It's easy enough to update my entry to do this once you de-obfuscate it but theoretically possible to have 13 but the Enigma typically had 10 pairs.
I'm not helping there (and in fact I don't think I could any more even if I It's easy enough to update my entry to do this once you de-obfuscate it but
wanted to - at least not easily!). I'm not helping there (and in fact I don't think I could any more even if I
wanted to - at least not easily!).
```
* It does not obviously have the clicking sound associated with the moving * It does not obviously have the clicking sound associated with the moving
parts of the real machine. I think it would be annoying to have this as it parts of the real machine. I think it would be annoying to have this as it
@@ -599,8 +643,10 @@ simulator make sure to use Rotors I, II and III and the starting positions at B,
B and C respectively (as in left, centre, right). To do this click the button at B and C respectively (as in left, centre, right). To do this click the button at
the top right that looks like: the top right that looks like:
o-> ```
<-o o->
<-o
```
And then select the rotors. Next click the button again at the left of the And then select the rotors. Next click the button again at the left of the
rotor selection 'screen'. Then use the arrow buttons above each rotor to set rotor selection 'screen'. Then use the arrow buttons above each rotor to set
@@ -620,7 +666,9 @@ determine if the ring settings being different from ABC would cause a problem
Going back to the configuring the online simulator try inputting the text IOCCC Going back to the configuring the online simulator try inputting the text IOCCC
and you'll see the resulting text being: and you'll see the resulting text being:
UUMMX ```
UUMMX
```
Which is exactly as my entry shows! So at least for the starting position BBC Which is exactly as my entry shows! So at least for the starting position BBC
and an empty plugboard and the other defaults in my entry (which appear to be and an empty plugboard and the other defaults in my entry (which appear to be
@@ -737,11 +785,10 @@ as well as the award titles. And yes indeed 'most of us could use
[Double-layered Chocolate Fudge Cake]: chocolate-cake.html [Double-layered Chocolate Fudge Cake]: chocolate-cake.html
## Copyright:
-----------------------------------------------------------------------------------------------------
(c) Copyright 1984-2020, [Leo Broukhis, Simon Cooper, Landon Curt Noll][judges] - All rights reserved (c) Copyright 1984-2020, [Leo Broukhis, Simon Cooper, Landon Curt Noll][judges] - All rights reserved
This work is licensed under a [Creative Commons Attribution-ShareAlike 3.0 Unported License][cc]. This work is licensed under a [Creative Commons Attribution-ShareAlike 3.0 Unported License][cc].
[judges]: http://www.ioccc.org/judges.html [judges]: http://www.ioccc.org/judges.html
[cc]: http://creativecommons.org/licenses/by-sa/3.0/ [cc]: http://creativecommons.org/licenses/by-sa/3.0/
-----------------------------------------------------------------------------------------------------