Commit 3a4fcc2e authored by Sam Moore's avatar Sam Moore
Browse files

Almost done?

Fixed UnixCommands and Glossary.
There is a random blank page. I don't know why. I can't fix it.

Just need the welcome messages and proof reading (hah!) etc.
parent 336ddc75
......@@ -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)
......
......@@ -10,7 +10,7 @@
Address: <\href{mailto:#[email protected]}{#[email protected]}>
\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}
......
......@@ -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}}
\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 [email protected] 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}}
\zchapter{UCC Groups}
\zchapter{UCC::Groups}
% Explanation of the groups.
\newenvironment{uccgroup}[1]
......
\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}
......
\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}
No preview for this file type
......@@ -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}
%---------------------------------------------------------
......
......@@ -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}
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment