Appendices:
----------
IMPORTANT Important notes
Thanks! Thank yous to various people
Chapters Table of files in doc/
Changes Changes since beta version
IMPORTANT
---------
This section is NOT done yet. (or even begun, really)
Important notes (usually about versions) will go here:
READING THE MAIN DOCS IS REQUIRED FOR SETTING UP THE WIZSHELL
(if you don't I will bop you on the head repeatedly)
** Do NOT try to remove links with the wsh!
If you try to remove a link to a file with rm, you will instead
rm the file! This is because of the way wsh deals with links and
will hopefully change in a future version.
Don't forget to disallow directories that have personal information
inside of them! You may want to give /* access to someone, but
think twice! There may be directories like /room/post_dir that you
want to disallow.
The WizPort now logs all logins in etc/wtmp, for use with the 'last'
command. Don't forgot to remove this occasionally!
Thanks!
-------
Thanks to a number of people (sorry you had to wait till the appendix, guys)
Hopefully I will remember everyone:
Sam Lantinga For tcpserv, splitvt, mem.c, and general, on the spot know-how
Steve Kirkendall For elvis 1.7
gnu For good happy stuff (especially 'less')
Daeron Meyer For introducing me to muds and giving me maching access,
then taking it away, giving it back, taking it away...
ed() For inspiration. (I mean, ed sucks, eh?)
comp.unix.[questions|wizards] For answers
GumbiMud For the original beta testing
And all the v1.32 beta testers, and everyone who gave me support along the way.
Thanks guys!
Chapters
--------
0.COPYRIGHT Copyright message
1.WhatIsIt Explanation of the program
2.Install How to install
3.Admin How to adminstrate the mud
4.Security Security issues regarding the bin/ directory
5.Editors Editor list from comp.editors and notes
6.Tech Technical docs, hows it work, etc..
Appendices This file (see Contents)
help/ these are files that should be moved to HELP_DIR as defined
in src/Makefile for use with the 'help' program
wsh.man Man page for wsh - a copy should be put in the HELP_DIR
Changes
-------
v1.46
fixed last and made it readable (see util/last)
etc/wtmp gets erased at a certain size (MAX_WTMP_SIZE in config.h)
'who' now has idle time
added 'mesg y|n' feature
fixed the login.c 'double fclose' bug
added version command
!!removed set as equivalent of setenv. Just use setenv!
fixed the 'free' bug! The final irreproducible bug is caught! :)
wsh now properly compiles under 'cc' on some architectures
docs/help/vi help file
reversed the order of the 'Changes' chapter in the 'Appendix' :)
mentioned Jim Cogbill three more times because he said he'd stop
finding those annoying bugs after attaining his goal of being in the
Appendix four times. (Jim Cogbill Jim Cogbill) *grin*
all architectures now use putenv.c instead of the library call, to fix
a bug in some libraries. If you don't like it, look for wshputenv(..)
v1.45
deleted the stuff I set up for chat ;)
chat and tell!
fixed some memory stuff - had problems with 'setenv' over 'set' :(
changed behavior of solitary exclamation mark for sake of chat and tell
now has ip address, which is saved for the 'last' command
fixed the "CPU hell" problem identified by Jim Cogbill
fixed the .logout bug
v1.43 & v1.44
Numerous little things
uses type int not char! :)
set up some stuff to prepare for chat
made elvis secure
ftp commands! fget, fput, fls and frm
v1.42
Added 'who' and 'last'
Added disallowed files and directories to access
MAX_USERS capabilities
Fixed (and found ;) some read_access bugs (in particular, dealing with env vars)
Updated and finished some docs
Option to help.c: csh version of help - does recursive file search
v1.40
Can now use .o files for login
fixed bug (still some free()s left - should be FREE())
expands %/ in set prompt to be current directory (try it!)
thought about using gnu readline.c *grin*
v1.37
Ported to ultrix
Added memory wrapper and other features
v1.32
NO LONGER BETA! WizPort becomes distributable.
Future Possibilities
--------------------
These are just some possibilities on future additions to the wsh.
(Unless specified, these have not been done yet!)
portability:
Not very many architectures are currently supported. If you get it to run
on another type of architecture then those listed in the install docs, please
tell me what you did so I can make it easier for everyone else.
Getting better! Something like 8 architectures work!
glob:
Global file expansion. i.e.: vi /obj/pla*c
also possibly: file completion, line editing, courtesy of gnu readline
-- I don't know If I'll ever be able to get around to this. Looks
like it can't realistically be done until I do a massive rewrite
of the parser, and I'm not terribly interested in that :)
redirection:
Someday soon... wsh currently can't do > < >> or |
NOT_LAST_LINK:
A new exception for the exceptions file. If a program is a 'not-last-link'
then when the pathnames are resolved for that program, if the last component
of the path is a link, it will NOT be followed. The only use for this I can
think of so far is for the program 'rm' where you don't want to remove the
link. Ex: /obj/cows.c is linked to the file /open/mycows.c if the user
wants to remove the link /obj/cows.c and types 'rm /obj/cows.c' then the
wsh will convert that to 'rm /open/mycows.c' which is probably NOT what the
user wanted (see the technical chapter for more information on this.)
ILLEGAL_ARGS:
A new exception for the exceptions file. Disallows certain args for certain
programs. Ex: 'ls/R' will prevent the user from calling 'ls' with the
flag '-R' (see security for why)
Disallowed Directories:
<THIS IS DONE! VERSION 1.42>
(Could be improved...)
File transfer:
<THIS IS DONE! VERSION 1.43>
Archiving (tar):
<Planned for version 1.47>
Using .o files:
<THIS IS DONE! VERSION 1.40>
help:
Help needs to be rewritten, for some people it just won't work, and even
if it does, it only looks in the /doc/helpdir directory, and not recursively
inside of that. Perhaps a shell script or a perl script?
(This has been partly done - there is a help csh version 1.0)
communication:
<THIS IS DONE! VERSION 1.45>
Much much more!
Want to code some of your or my (or someone else's) ideas for the WizShell?
Great! I'd appreciate a copy of the code, especially if you think it
would be worthwhile to other people. Please keep in touch with me on
what you are doing and what ideas you have.
Or! another idea!
How about coding something for the wsh bin/ directory!
For example, programs that help out the wsh, like:
who <done!>, finger, passwd (partly done), etc...
Or, programs that help out mud coders, like object creators (written in C!)
Anyone?
-------------------------------
Well, thats it.
Thanks, Dave Ljung