diff --git a/Makefile b/Makefile index 2c1f1367f247d7f891d3706b4e692beabfa6dbba..7e1c29c2a5a371d5847e4b120c4f3703fc1b5bce 100644 --- a/Makefile +++ b/Makefile @@ -11,10 +11,10 @@ fresher_guide.pdf : fresher_guide.tex rm -f *.aux *.bbl *.log *.toc *.lof *.blg *.lot $(TEX) -shell-escape $(NAME) - bibtex $(NAME) + #bibtex $(NAME) $(TEX) --shell-escape $(NAME) $(TEX) --shell-escape $(NAME) - bibtex $(NAME) + #bibtex $(NAME) $(TEX) --shell-escape $(NAME) $(TEX) --shell-escape $(NAME) diff --git a/chapters/Communications.tex b/chapters/Communications.tex index 8cddc4305642989853b000c384582c612b69c8d5..24c4edd4d9d08d9e98f5fb3bfa2b8bb73438abc3 100644 --- a/chapters/Communications.tex +++ b/chapters/Communications.tex @@ -10,7 +10,7 @@ Address: <\href{mailto:#1@ucc.asn.au}{#1@ucc.asn.au}> \end{mdframed} \begin{mdframed} - Subscribe: \url{http://lists.ucc.gu.uwa.edu.au/mailman/listinfo/#1} + Subscribe: \url{http://lists.ucc.asn.au/mailman/listinfo/#1} \end{mdframed} @@ -90,7 +90,7 @@ Dragging itself kicking and screaming into the 21st Century, UCC has managed to \url{https://www.facebook.com/groups/universitycomputerclub/} \item The UCC Status Twitter Account (used mainly to tell everyone things are broken): \url{https://twitter.com/ucc_status} -\item GitHub: \url{https://github.com/UniversityComputerClub} +\item GitHub: \url{https://github.com/ucc} \end{itemize} diff --git a/chapters/FindClubroom.tex b/chapters/FindClubroom.tex index cd391b8dcb181a71a9189667f470231bc0aae5f3..7f70106b511a831ccf83a9affd5d0d12057e33d2 100644 --- a/chapters/FindClubroom.tex +++ b/chapters/FindClubroom.tex @@ -3,15 +3,23 @@ % Directions to the clubroom, ideally with non terrible maps. Most people don't ever find it :-( -\begin{mdframed} -To find the clubroom, follow the maps and/or these steps: + +\begin{figure}[H] + \centering + \includegraphics[width=0.9\textwidth]{figures/maps.png} + \caption{Maps} + \label{maps.png} +\end{figure} + +\small{ +\begin{mdframed} \begin{enumerate} \item Starting from the carpark outside The Tav, follow the arrow on the aerial picture to get to the Cameron Hall door, then go up the stairs to the second floor and follow the bottom map. \item If you see a coke machine and a snack machine, you are in the right place. The UCC clubroom has lots of computers and a couple of couches. \item If you accidentally find yourself surrounded by books and a fridge, you're in UniSFA --- try the other door in that corridor. \end{enumerate} -You can see if the clubroom is open online using the webcams (\url{http://webcams.ucc.asn.au/}) +You can see if the clubroom is open online at \url{http://webcams.ucc.asn.au/} -\end{mdframed} +\end{mdframed}} diff --git a/appendices/Glossary.tex b/chapters/Glossary.tex similarity index 77% rename from appendices/Glossary.tex rename to chapters/Glossary.tex index da02a39b09b6309ba3dee8400595ec3a026d8e32..ded815458b82d68aa1356fd51074a46dc37fbd39 100644 --- a/appendices/Glossary.tex +++ b/chapters/Glossary.tex @@ -1,15 +1,14 @@ -\chapter*{Glossary} +\chapter{Glossary} -Words and phrases that are (or were) useful around the club. - -\begin{tabular}{ll} - {\bf Term} & {\bf Meaning} \\ +\small{ +\begin{tabular}{p{0.2\linewidth}|p{0.7\linewidth}} + \rowcolor{black} \color{white}{Term} & \color{white}{Translation} \\ Dr ACC Murphy & A Computer Called Murphy. Dr ACC Murphy is infamous around the UCC. He even receives mail! \\ BSD & -Berkeley Systems Distribution – a UNIX developed at Berkeley, now better known through the FreeBSD, NetBSD and OpenBSD UNIXes. musdea runs FreeBSD. \\ +Berkeley Systems Distribution -- a UNIX developed at Berkeley, now better known through the FreeBSD, NetBSD and OpenBSD UNIXes. musdea runs FreeBSD. \\ blog & -aka. weblog – sort of like a journal on the Internet (you don't have one?). Think of it as a tumblr for grown-ups. Syndicated by a Planet. \\ +aka. weblog -- sort of like a journal on the Internet (you don't have one?). Think of it as a tumblr for grown-ups. Syndicated by a Planet. \\ Coke credit & If you gotta ask, you ain't got it! Coke credit is how people usually refer to money in your dispense account. \\ Coke Group & @@ -23,7 +22,7 @@ dispense started off as a way to dispense Cokes from the online Coke machine, an Door Group & the group of people charged with keep the room open, tidy and safe. \\ Firefox & -A web browser by the Mozilla Foundation, arguably the second-worst Internet browser – the worst is every other browser. \\ +A web browser by the Mozilla Foundation, arguably the second-worst Internet browser -- the worst is every other browser. \\ Flame & Flame is the UCC's MUD (Multi-User Dungeon) and may or may not be haunted. \\ Fresher & @@ -31,9 +30,9 @@ A new university student, usually also a first time UCC member. \\ Fresher Rep & Fresher Committee member, usually chosen because they look like they'll make a good worker drone in the future. Represents the freshers at committee meetings, if they attend. \\ GNOME & -GNU Networked Object Model Environment – an open source desktop environment aimed primarily at UNIX computers. Quite popular in the past, before it removed all of the features people liked. \\ +GNU Networked Object Model Environment -- an open source desktop environment aimed primarily at UNIX computers. Quite popular in the past, before it removed all of the features people liked. \\ GNU & -GNU is Not Unix – a layer of libraries and utilities to implement a UNIX like operating system, commonly used on top of Linux. \\ +GNU is Not Unix -- a layer of libraries and utilities to implement a UNIX like operating system, commonly used on top of Linux. \\ Internet Explorer & Just use Firefox. No, really. \\ IRC & @@ -47,7 +46,13 @@ Lightweight Directory Access Protocol: the black magic used for authentication a Linux & the kernel (basis) of an open source UNIX operating system that has developed quite a following among computer scientists and engineers. \\ loft & -the area above the UCC that looks down into the UCC clubroom. LAN gaming and other activities take place up there. \\ +the area above the UCC that looks down into the UCC clubroom. LAN gaming and other activities take place up there. + +\end{tabular} + +\begin{tabular}{p{0.2\linewidth}|p{0.7\linewidth}} + \rowcolor{black} \color{white}{Term} & \color{white}{Translation} \\ + machine room & The UCC data centre. This is the small room with the glass doors that is located within the clubroom. All of our servers are kept in this room. It is locked when there is no one from Wheel around. \\ mailing list & @@ -55,7 +60,7 @@ a way of communicating with a very large number of people via email. The UCC has Mozilla & develop several open source web related products, such as Firefox and Thunderbird. \\ OCM & -Ordinary Committee Member – the worker drones of the UCC Committee, they do lots of work, for little reward. \\ +Ordinary Committee Member -- the worker drones of the UCC Committee, they do lots of work, for little reward. \\ Oligoboot & boots more then one operating system (selectable when you boot). \\ OpenSolaris & @@ -75,7 +80,7 @@ Sort of a router for serial ports, allows you to connect to one serial port from theft book & this is where you write down that you borrowed tools from UCC. It is not for borrowing books; you mail books@ucc.asn.au to do that. \\ TLA & -Three Letter Acronym – a way to refer to UCC members, often used in the minutes of meetings. Use the tla program or visit the UCC website to decode them. \\ +Three Letter Acronym -- a way to refer to UCC members, often used in the minutes of meetings. Use the tla program or visit the UCC website to decode them. \\ Ubuntu & A Linux distribution derived from Debian. Funded with space money. \\ UCCan & @@ -87,7 +92,7 @@ the University Science Fiction Association, the ones down the hall. \\ VM & A VM or Virtual Machine is a computer emulated on top of another computer. Many of the UCC's servers run inside VMs. The claim is that UCC's VMs are not a ``single point of failure.`` That's the machine they are all running on (medico). \\ WAIX & -WA Internet eXchange – a group of ISPs and interested bodies who peer resources on the Internet for mutual benefit. \\ +WA Internet eXchange -- a group of ISPs and interested bodies who peer resources on the Internet for mutual benefit. \\ Wheel Group & the group responsible for maintaining computers, accounts and services in UCC. \\ -\end{tabular} +\end{tabular}} diff --git a/chapters/Groups.tex b/chapters/Groups.tex index e9806243953f508f8a30a19a5d1b270d39d2e9c3..b45b2ba0201f10a8dd81f6ef4775fbd53fb13728 100644 --- a/chapters/Groups.tex +++ b/chapters/Groups.tex @@ -1,4 +1,4 @@ -\zchapter{UCC Groups} +\zchapter{UCC::Groups} % Explanation of the groups. \newenvironment{uccgroup}[1] diff --git a/chapters/Services.tex b/chapters/Services.tex index 8878319ec1e41a5f1c06eb48affed2cface8797c..560c57fe73c9ae8a38d9f75f2008718f57dda0c3 100644 --- a/chapters/Services.tex +++ b/chapters/Services.tex @@ -1,4 +1,4 @@ -\zchapter{Services} +\zchapter{UCC::Services} \newcommand{\server}[1]{\emph{#1}} @@ -72,7 +72,7 @@ Upon creating your account you can choose an address to foward all emails to. Yo Alternately, you can use one of several methods to check your UCC email directly. \begin{enumerate} - \item alpine --- Connect via SSH and run "alpine". The interface is basic. Press the Control key a lot. + \item alpine --- Connect via SSH and run "alpine". \item webmail --- Several options will be presented to you at \url{http://webmail.ucc.asn.au} \item mail client (eg: Thunderbird) --- The server name is \server{secure.ucc.asn.au}. Use port 993 and IMAP. With your UCC username and password. \end{enumerate} @@ -99,13 +99,14 @@ We use something called LDAP for authentication and linux accounts. SAMBA is inv \begin{uccservice}{File Storage}{mylah, enron/stearns, nortel/onetel, motsugo} -With your account comes not one, but \emph{two} directories for your files. +With your account comes not one, but \emph{two} "home" directories for your files. -The one most commonly seen is accessable on clubroom machines. It will be named "/home/ucc/username" on clubroom linux machines. On servers however, there is a different "/home" directory; to get to your clubroom home directory you must access "/away/ucc/username". +The one most commonly seen is accessable on clubroom machines. It will be named "/home/ucc/username" on clubroom linux machines. On servers however, that path leads to a different home directory; to get to your clubroom home directory (called "away") you must access "/away/ucc/username". -Home directories on the servers are considered slightly more secure than your "away" directory. +Home directories on the servers are considered slightly more secure than your "away" directory. -If you are using Linux, you can use the program "sshfs" to mount your home or away directories remotely. This is the most convenient method for uploading, downloading or editing files. Under windows, the programs "WinSCP" or "Filezilla" might not suck. + +If you are using Linux, you can use the program "sshfs" to mount your home or away directories remotely. This is probably the most convenient way to upload, download and edit files. Under windows, the programs "WinSCP" or "Filezilla" are recommended. %For interest: Not that interesting %\server{enron} and \server{stearns} are our slowly dying SAN which stores "away". \server{mylah} mounts the SAN directly and exports the filesystem over NFS. @@ -118,7 +119,7 @@ If you are using Linux, you can use the program "sshfs" to mount your home or aw Murasoi is a wheel-only server which serves as a router for all of UCC's networks and runs the infamous "ucc-fw" firewall. Murasoi also acts as the DHCP server. -For some reason, DNS is not on murasoi, but on mooneye. The magic that makes \url{http://username.ucc.asn.au} point to your website happens on mooneye. +DNS is on mooneye. The magic that makes \url{http://username.ucc.asn.au} point to your website happens on mooneye. \end{uccservice} diff --git a/chapters/UnixCommands.tex b/chapters/UnixCommands.tex new file mode 100644 index 0000000000000000000000000000000000000000..55d1e0bd67b4bc5dc66c5a84970041cd934fa8ff --- /dev/null +++ b/chapters/UnixCommands.tex @@ -0,0 +1,50 @@ +\zchapter{Common UNIX/Linux Commands}\label{UnixCommands} + + + +\begin{mdframed} + +A large number of the UCC's computers run UNIX or Linux. If you've never encountered UNIX before, it might be a bit daunting for you. While most UNIX operating systems come with nice graphical desktops, the power is all in the text-based shell. Here are some common shell commands, in no particular order. There will be a "Learn to Linux" night at some point to help you out with some of the finer points. + +Many commands have an available help summary that you can get by appending \verb/--help/. + +\end{mdframed} + +\newcommand{\uc}[2]{ \shell{#1} & \small{#2} \\} + +\newcolumntype{L}{>{\centering\arraybackslash}m{0.5\textwidth}} +\centering + \rowcolors{1}{}{lightgray} + \begin{tabular}{|p{0.35\linewidth}|p{0.6\linewidth}|} + \rowcolor{black} \color{white}{Command} & \color{white}{Description} \\ + + + + \uc{logout}{Logs you off the system. Do this before you leave.} + \uc{ls <directory>}{Lists the files in the given directory (folder).} + \uc{cd <directory>}{Change to the given directory (folder).} + \uc{mkdir <directory>}{Add the specified directory (folder).} + \uc{rmdir <directory>}{Remove the specified directory (folder).} + \uc{pwd}{"Print Working Directory" --- Displays the path of the directory you are currently in.} + \uc{less <file>}{Read through a file (\emph{space} scrolls on a page, \emph{q} will quit)} + \uc{cp <source> <destination>}{Make a copy of a file in a new place.} + \uc{mv <source> <destination>}{Move (rename) a file.} + \uc{rm <file>}{\textsc{{Permanently deletes a file. \newline There is no "Recycle Bin"!}}} + \uc{alpine}{This program can be used for reading emails.} + \uc{nano <file>, vim <file>, emacs <file>}{Three different text file editors. \shell{nano} is the simplest.} + \uc{finger <username>, tla <username or TLA>, who}{Check to see who someone is and if they are logged in.} + \uc{ssh <username>@<hostname>}{Log in (securely) to another (UNIX) machine.} + \uc{ping <hostname>}{Ping another machine to see if it is up and what the latency is. Press \emph{Ctrl-C} to cancel.} + \uc{man <command>}{Displays the manual for a command. See \shell{man man} for more information.} + \uc{top}{Displays an updating list of current processes on the system.} + \uc{ps}{Lists the processes you are running on this terminal (names and PIDs)} + \uc{ps aux}{Lists all processes running on the system} + \uc{kill <PID>}{Tell a process it should stop. \shell{kill -9} will kill a process immediately.} + \uc{passwd}{On \server{mussel} - Change your login password} + \uc{dispense}{Get yourself a delicious drink!} + \uc{gcc/g++}{C/C++ compilers for compiling some awesome code you wrote.} + \uc{python}{Python interpreter for interpreting some OK code you wrote.} + \uc{irssi}{Join IRC to chat/argue with other members} + \hline + \end{tabular} + diff --git a/figures/maps.png b/figures/maps.png new file mode 100644 index 0000000000000000000000000000000000000000..c553d262953107c779016815ada27aaf8d8f1e38 Binary files /dev/null and b/figures/maps.png differ diff --git a/fresher_guide.pdf b/fresher_guide.pdf index 88809cbf23ff39fcb384a307024081c370bdb174..8fa8789d459441682249787b05ca71b1d43d8956 100644 Binary files a/fresher_guide.pdf and b/fresher_guide.pdf differ diff --git a/fresher_guide.tex b/fresher_guide.tex index b60497b24fddbfeb86910309f4f36f5b0fea3bd0..27a0990c3a4ec1f08b234c246f5436f06ceca5ef 100644 --- a/fresher_guide.tex +++ b/fresher_guide.tex @@ -39,7 +39,7 @@ %\usepackage{listings} % For code snippets \definecolor{pink}{rgb}{1.0,0.5,0.5} \definecolor{darkgray}{rgb}{0.1,0.1,0.1} -\definecolor{lightgray}{rgb}{0.7,0.7,0.7} +\definecolor{lightgray}{rgb}{0.95,0.95,0.95} \definecolor{gray}{rgb}{0.5,0.5,0.5} \definecolor{darkred}{rgb}{0.75,0,0} \definecolor{darkblue}{rgb}{0,0,0.35} @@ -54,7 +54,7 @@ %\lstset{showstringspaces=false} %\lstset{basicstyle=\small} - +\usepackage[table]{xcolor} \newtheorem{theorem}{Theorem}[section] \newtheorem{lemma}[theorem]{Lemma} @@ -93,7 +93,7 @@ \newcommand{\shell}[1]{\texttt{#1}} % Rants \newcommand{\rant}[1]{\textsc{#1}} -\renewcommand{\url}[1]{\href{#1}{\color{blue}{#1}}} +\renewcommand{\url}[1]{<\href{#1}{\underline{\color{darkblue}{#1}}}>} \newcommand{\setfont}[1]{\fontfamily{#1}\selectfont} @@ -179,19 +179,21 @@ \include{chapters/Clubroom} \include{chapters/Communications} \include{chapters/Services} +\include{chapters/UnixCommands} +\include{chapters/Glossary} % ETC %\newpage %--------------------------------------------------------- -\renewcommand{\bibname}{References} -\bibliography{references/refs} -\bibliographystyle{ieeetr} +%\renewcommand{\bibname}{References} +%\bibliography{references/refs} +%\bibliographystyle{ieeetr} %\addcontentsline{toc}{part}{References} %--------------------------------------------------------- % Appendices -\appendix -\include{appendices/Glossary} +%\appendix +%\include{appendices/Glossary} %\include{appendices/figures} %--------------------------------------------------------- diff --git a/titlepage/Titlepage.tex b/titlepage/Titlepage.tex index 01bfaf5a5e6c3855d009ec825314a2d721623e85..e7184f51031a42e66ce4d76b716e6b2fa2370ac3 100644 --- a/titlepage/Titlepage.tex +++ b/titlepage/Titlepage.tex @@ -3,7 +3,7 @@ % Suitably pretty title page is required. \title{UCC::FresherGuide} -\author{The Ghosts of Committee Past\cite{committee} \\ <\href{mailto:committee@ucc.asn.au}{committee@ucc.asn.au}>} +\author{The University Computer Club Inc. \\ \url{http://www.ucc.asn.au} \\ <\href{mailto:ucc@ucc.asn.au}{ucc@ucc.asn.au}>} \date{January 2014}