moved bchs guide to wiki

author: ahriman <ahriman@falte.red> 2019-01-04 04:09:50 +0000
committer: ahriman <ahriman@falte.red> 2019-01-04 04:09:50 +0000
commit: 1720151b96c9f88d4145fca21a23ab8e807d564b (patch)
tree: 8d03703531163579846127d790c11c356eedc277
parent: 2cff2b45ef8107b04191a1c3658744c8c6abd411 (diff)
download: site-1720151b96c9f88d4145fca21a23ab8e807d564b.tar.gz
13 files changed, 76 insertions, 72 deletions
diff --git a/coc.html b/coc.html
index 10e387d..e81c2b7 100644
--- a/coc.html
+++ b/coc.html
@@ -15,7 +15,7 @@
 		</div>
 	</div>         
 	<div id="navigation">
-        <a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
+        <a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
 	</div>
 	<div id="content">
 <h1>tilde.institute code of conduct</h1>
diff --git a/index.html b/index.html
index 3be05c2..4d795dd 100644
--- a/index.html
+++ b/index.html
@@ -15,7 +15,7 @@
 		</div>
 	</div>         
 	<div id="navigation">
-        <a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
+        <a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
 	</div>
 	<div id="content">
 		<p>Welcome to tilde.institute! This is an OpenBSD machine whose purpose is to provide a space in the <a href="https://tildeverse.org">tildeverse</a> for experimentation with and education of the OpenBSD operating system. A variety of editors, shells, and compilers are installed to allow for development in a native OpenBSD environment. OpenBSD's httpd(8) is configured with slowcgi(8) as the fastcgi provider and sqlite3 available. This allows users to experiment with web development using compiled CGI in C, aka the <a href="https://learnbchs.org">BCHS Stack</a>. In addition to php7.0 and mysql (mariadb) by request, this provides an environment where the development of complex web apps is possible.</p>
diff --git a/irc.html b/irc.html
index 928211f..da2c123 100644
--- a/irc.html
+++ b/irc.html
@@ -15,7 +15,7 @@
 		</div>
 	</div>         
 	<div id="navigation">
-		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
+		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
 	</div>
 	<div id="content">
         <p>To connect to the <a href="https://tilde.chat">tildeverse IRC network</a> and begin chatting while logged on to tilde.institute, simply use the command <code>chat</code>! If you prefer to use a different IRC client than the default, such as irssi, the following server information will apply:</p>
diff --git a/rel-announce.html b/rel-announce.html
deleted file mode 100644
index cc229b1..0000000
--- a/rel-announce.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<!DOCTYPE PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/1/DTD/1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/" lang="en" xml:lang="en">
-<head>
-        <meta http-equiv="Content-Type" content="text; charset=utf-8" />
-        <title>tilde.institute :: IRC</title>
-        <link rel="stylesheet" href="tilde.css" type="text/css"/>
-        <link rel="icon" type="image/png" href="icon.png"/>
-</head>
-<body>
-<div id="container">
-	<div id="logo">
-        <img src="logo.png" alt="" /><br />
-		<div id="logobyline">
-			of OpenBSD Education
-		</div>
-	</div>         
-	<div id="navigation">
-		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
-	</div>
-	<div id="content">
-        <p>This has been an exciting month. tilde.institute was taken from a rough proof-of-concept on a tiny VPS to a full-blown tilde service, offering mail, webspace, and a local IRC node. 
-	</div>
-</div>
-</body>
-</html>
diff --git a/signup.html b/signup.html
index 80f4912..67d244b 100644
--- a/signup.html
+++ b/signup.html
@@ -15,7 +15,7 @@
 		</div>
 	</div>         
 	<div id="navigation">
-		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
+		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
 	</div>
 	<div id="content">
 		<br />
diff --git a/start.html b/start.html
deleted file mode 100644
index 17037c9..0000000
--- a/start.html
+++ /dev/null
@@ -1,39 +0,0 @@
-<!DOCTYPE PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/1/DTD/1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/" lang="en" xml:lang="en">
-<head>
-        <meta http-equiv="Content-Type" content="text; charset=utf-8" />
-        <title>tilde.institute :: Quick-Start Guide</title>
-        <link rel="stylesheet" href="tilde.css" type="text/css"/>
-        <link rel="icon" type="image/png" href="icon.png"/>
-</head>
-<body>
-<div id="container">
-	<div id="logo">
-        <img src="logo.png" alt="" /><br />
-		<div id="logobyline">
-			of OpenBSD Education
-		</div>
-	</div>         
-	<div id="navigation">
-		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
-	</div>
-	<div id="content">
-        <p>This will be a quick-and-dirty guide to getting started with the BCHS stack. More information can be found at:</p>
-            <ul>
-                <li><a href="https://learnbchs.org">Learn BCHS</a></li>
-                <li><a href="http://man.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man2/pledge.2">pledge(2)</a></li>
-                <li><a href="http://man.openbsd.org/unveil.2">unveil(2)</a></li>
-                <li><a href="https://kristaps.bsd.lv/kcgi/">kcgi</a></li>
-                <li><a href="https://kristaps.bsd.lv/ksql/">ksql</a></li>
-                <li><a href="https://kristaps.bsd.lv/kwebapp">kwebapp</a></li>
-            </ul>
-            <p>tilde.institute is set up to process all files with the .cgi extension via slowcgi(8). This allows for a multitude of possibilities - any compiled language can be used to develop web applications on an OpenBSD server. It's advised to use C because of the pledge(2) and unveil(2) system calls available, which allow for restricting privileges and restricted filesystem access, respectively.</p>
-            <p>Keep in mind that if you don't use the previously listed kcgi/ksql/kwebapp libraries, you will need to work with HTTP's eccentricities manually. For an example, here's <a href="helloworld.c.txt">the Hello World code</a> from the LearnBCHS site. And <a href="helloworld.cgi">here it is running</a> as compiled CGI here at the Tilde Institute.</p>
-            <p>Once you've written your software to be served via CGI, be sure to statically link the executables. Sure, there's a larger file size, but the benefits outweigh that in this case - there's no relying on what I may or may not have installed on the Tilde Institute's server. For example:</p>
-            <p>$ cc -static -g -W -Wall -o app.cgi app.c</p>
-            <p>When you've completed compilation, make sure to set permissions properly (755) and move it to the public folder in your home directory. httpd(8) is set to use index as the index file, however this can be changed to index.cgi or what-have-you by contacting ahriman via IRC.</p>
-            <p>~institute user <code>xvetrd</code> has written a more detailed example on kcgi than is provided on the library's site. It includes an example makefile as well. The KCGI Starter archive <a href="kcgi-start.tar.gz">is available here</a>. Simply <code>curl -O https://tilde.institute/kcgi-start.tar.gz</code> it to your home directory here on ~institute, untar, make, and make install to test the compilation. It installs to ~/public_html with the proper ownership and permissions. View the index.c source and the makefile to see what goes on under the hood! Feel free to adapt it your own projects!</p>
-	</div>
-</div>
-</body>
-</html>
diff --git a/submit.php b/submit.php
index 59ced40..65fb021 100755
--- a/submit.php
+++ b/submit.php
@@ -15,7 +15,7 @@
 		</div>
 	</div>         
 	<div id="navigation">
-		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
+		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
 	</div>
 	<div id="content">
 <?php
diff --git a/table.connusers b/table.connusers
index 5a93076..5487b82 100644
--- a/table.connusers
+++ b/table.connusers
@@ -1,5 +1,6 @@
 <ul>
-<li>lorenzo</li>
 <li>rnelson</li>
+<li>rdh</li>
+<li>lorenzo</li>
 <li>nimbius</li>
 </ul>
diff --git a/table.regusers b/table.regusers
index 889f887..b34977a 100644
--- a/table.regusers
+++ b/table.regusers
@@ -1,6 +1,7 @@
 <ul>
 <li>aewens</li>
 <li>al002</li>
+<li>alias5100</li>
 <li>amcclure</li>
 <li>bacterio</li>
 <li>ben</li>
@@ -19,6 +20,7 @@
 <li>nonlinear</li>
 <li>ols</li>
 <li>rdh</li>
+<li>rgdrake</li>
 <li>rnelson</li>
 <li>saba</li>
 <li>slip</li>
diff --git a/table.weekconns b/table.weekconns
index 410b14d..a5c750f 100644
--- a/table.weekconns
+++ b/table.weekconns
@@ -1 +1 @@
-25
\ No newline at end of file
+27
\ No newline at end of file
diff --git a/wiki.php b/wiki.php
index 9a83a28..19a9eed 100644
--- a/wiki.php
+++ b/wiki.php
@@ -15,7 +15,7 @@
 		</div>
 	</div>         
 	<div id="navigation">
-		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/start">BCHS Guide</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
+		<a href="http://tilde.institute">News</a> :: <a href="/signup">Sign Up</a> :: <a href="/irc">IRC</a> :: <a href="/coc">Code of Conduct</a> :: <a href="https://tilde.zone/@tildeinstitute">Mastodon</a> :: <a href="/wiki">Wiki</a> :: <a href="https://tildegit.org/institute">Git</a> :: <a href="/stats">Stats</a>
 	</div>
 	<div id="content">
     <?php 
@@ -30,7 +30,9 @@
         </p>
 
         <h3>Pages:</h3>
+        &nbsp;&nbsp;<a href="wiki.php?page=bchs">BCHS Intro Guide</a><br />
         &nbsp;&nbsp;<a href="wiki.php?page=dcss">Dungeon Crawl Stone Soup</a><br />
+        &nbsp;&nbsp;<a href="wiki.php?page=finger">Finger</a><br />
         &nbsp;&nbsp;<a href="wiki.php?page=unixprotips">UNIX ProTips</a><br />
         <?php
 
diff --git a/wikipages/bchs.wiki b/wikipages/bchs.wiki
new file mode 100644
index 0000000..de41703
--- /dev/null
+++ b/wikipages/bchs.wiki
@@ -0,0 +1,21 @@
+<!--
+    author: ahriman
+    title: BCHS Guide
+    description: a quick intro to what the BCHS stack is
+-->
+<h2>BCHS Guide</h2>
+<p>This will be a quick-and-dirty guide to getting started with the BCHS stack. More information can be found at:</p>
+    <ul>
+        <li><a href="https://learnbchs.org">Learn BCHS</a></li>
+        <li><a href="http://man.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man2/pledge.2">pledge(2)</a></li>
+        <li><a href="http://man.openbsd.org/unveil.2">unveil(2)</a></li>
+        <li><a href="https://kristaps.bsd.lv/kcgi/">kcgi</a></li>
+        <li><a href="https://kristaps.bsd.lv/ksql/">ksql</a></li>
+        <li><a href="https://kristaps.bsd.lv/kwebapp">kwebapp</a></li>
+    </ul>
+<p>tilde.institute is set up to process all files with the .cgi extension via slowcgi(8). This allows for a multitude of possibilities - any compiled language can be used to develop web applications on an OpenBSD server. It's advised to use C because of the pledge(2) and unveil(2) system calls available, which allow for restricting privileges and restricted filesystem access, respectively.</p>
+<p>Keep in mind that if you don't use the previously listed kcgi/ksql/kwebapp libraries, you will need to work with HTTP's eccentricities manually. For an example, here's <a href="helloworld.c.txt">the Hello World code</a> from the LearnBCHS site. And <a href="helloworld.cgi">here it is running</a> as compiled CGI here at the Tilde Institute.</p>
+<p>Once you've written your software to be served via CGI, be sure to statically link the executables. Sure, there's a larger file size, but the benefits outweigh that in this case - there's no relying on what I may or may not have installed on the Tilde Institute's server. For example:</p>
+<p><code>$ cc -static -g -W -Wall -o app.cgi app.c</code></p>
+<p>When you've completed compilation, make sure to set permissions properly (755) and move it to the public folder in your home directory. httpd(8) is set to use index as the index file, however this can be changed to index.cgi or what-have-you by contacting ahriman via IRC.</p>
+<p>~institute user <code>xvetrd</code> has written a more detailed example on kcgi than is provided on the library's site. It includes an example makefile as well. The KCGI Starter archive <a href="kcgi-start.tar.gz">is available here</a>. Simply <code>curl -O https://tilde.institute/kcgi-start.tar.gz</code> it to your home directory here on ~institute, untar, make, and make install to test the compilation. It installs to ~/public_html with the proper ownership and permissions. View the index.c source and the makefile to see what goes on under the hood! Feel free to adapt it your own projects!</p>
diff --git a/wikipages/finger.wiki b/wikipages/finger.wiki
new file mode 100644
index 0000000..f74b1e3
--- /dev/null
+++ b/wikipages/finger.wiki
@@ -0,0 +1,42 @@
+<!--
+    author: ahriman
+    title: Finger
+    description: a brief introduction to the finger service
+-->
+
+<h2>finger</h2>
+
+<p>the finger protocol was created way back in 1977. its purpose was to display information about the queried user of a system, or all the users of a system.</p>
+
+<p>it fell out of use in the 1990s due to various security concerns. the old finger daemons were buggy and easily exploited, while the information garnered from a query could be used for social engineering attacks. nowadays, the finger daemons have been refined and are no longer so vulnerable.</p>
+
+<p>in the post-facebook world, new types of social networks are popping up. the latest in this movement is a resurgence of the finger protocol. what follows is a rough guide for getting yourself up to speed with finger on tilde.institute.</p>
+
+<h3>querying</h3>
+
+<p>the standard query for finger is simply</p>
+
+<p><code>finger user@host</code></p>
+
+<p>which displays login name, home directory, shell, real name, current login time, idle time, whether or not the user has mail, and the contents of the user's ~/.plan file. Here is an example of the output:</p>
+
+<div class="code"><pre>Login: username                          Name: Bob Bobson XXII
+Directory: /home/username                Shell: /bin/bash
+On since Wed Jan  2 04:04 (EST) on pts/94 from 168.297.83.21 via mosh [6420]
+    8 minutes 26 seconds idle
+Last login Wed Jan  2 04:33 (EST) on pts/91 from 168.297.83.21
+No mail.
+Plan:
+hey hey hey everybody!</pre></div>
+
+<h3>.plan</h3>
+
+<p>The ~/.plan file displayed at the end of the finger query response allows for some customization. You can put literally any text you want there. Status updates, summaries, etc. This little file allows us to use finger as a rudimentary social network.</p>
+
+<p>For example, say you want to use it as a personal summary, like having a blurb about what you're working on. Place the statement into ~/.plan and you're ready to go!</p>
+
+<p>For a more traditional social network style format, put dated and timed status updates as if you're tooting on a mastodon instance. The sky's the limit! Well, actually, text is the limit. But you get the idea. Right?</p>
+
+<p>hope to see you on finger soon!</p>
+
+<a href="/wiki">Back to Wiki</a>
author	ahriman <ahriman@falte.red>	2019-01-04 04:09:50 +0000
committer	ahriman <ahriman@falte.red>	2019-01-04 04:09:50 +0000
commit	1720151b96c9f88d4145fca21a23ab8e807d564b (patch)
tree	8d03703531163579846127d790c11c356eedc277
parent	2cff2b45ef8107b04191a1c3658744c8c6abd411 (diff)
download	site-1720151b96c9f88d4145fca21a23ab8e807d564b.tar.gz