about summary refs log tree commit diff stats
path: root/dev/c
diff options
context:
space:
mode:
Diffstat (limited to 'dev/c')
-rw-r--r--dev/c/datatypes.html44
-rw-r--r--dev/c/debugging.html32
-rw-r--r--dev/c/elements.html19
-rw-r--r--dev/c/index.html44
-rw-r--r--dev/c/lib.html167
5 files changed, 250 insertions, 56 deletions
diff --git a/dev/c/datatypes.html b/dev/c/datatypes.html
index a149c24..35b6ca4 100644
--- a/dev/c/datatypes.html
+++ b/dev/c/datatypes.html
@@ -9,6 +9,22 @@
 
         <h1>Datatypes</h1>
 
+        <h2 id="types">Types</h2>
+
+        <dl>
+            <dt>char</dt>
+            <dd>Integer, one byte.</dd>
+            <dt>int</dt>
+            <dd>Integer.</dd>
+            <dt>float</dt>
+            <dd>Single precision floating point.</dd>
+            <dt>double</dt>
+            <dd>Double precision floating point.</dd>
+            <dt>void</dt>
+            <dd>Absence of type.</dd>
+        </dl>
+
+
         <h2 id="datatypes">Data types</h2>
 
         <h2 id="int">Integer</h2>
@@ -128,13 +144,35 @@
         <h2 id="tq">Type qualifiers</h2>
         <h2 id="st">Storage class</h2>
 
-        <a href="../index.html">Development Index</a>
+        <h2 id="format">Format Type Specifiers</h2>
 
-        <p>
-        This is part of the c9-doc Manual.
+        <dl>
+            <dt>%c</dt>
+            <dd>Character</dd>
+            <dt>%s</dt>
+            <dd>String of characters</dd>
+            <dt>%d</dt>
+            <dd>Decimal integer</dd>
+            <dt>%f</dt>
+            <dd>Decimal floating point</dd>
+            <dt>%llu</dt>
+            <dd>unsigned long long</dd>
+            <dt>%o</dt>
+            <dd>Signed octal</dd>
+            <dt>%u</dt>
+            <dd>Unsigned decimal integer</dd>
+            <dt>%x</dt>
+            <dd>Unsigned hexadecimal integer</dd>
+            <dt>%p</dt>
+            <dd>Pointer address</dd>
+        </dl>
+
+        <a href="../index.html">Development Index</a>
+        <p>This is part of the c9 Manual.
         Copyright (C) 2018
         c9 team.
         See the file <a href="../../fdl-1.3-standalone.html">Gnu Free Documentation License</a>
         for copying conditions.</p>
+
     </body>
 </html>
diff --git a/dev/c/debugging.html b/dev/c/debugging.html
index d1f425b..4e5931f 100644
--- a/dev/c/debugging.html
+++ b/dev/c/debugging.html
@@ -15,10 +15,42 @@
         (gdb)set args -parameter1 -parameter2
         </pre>
 
+        <p>To start gdb in TUI mode press;</p>
+
+        <dl>
+            <dt>Ctrl-x A</dt>
+            <dd>Enter or leave TUI.</dd>
+            <dt>Ctrl-x 0</dt>
+            <dd>TUI with only one window.</dd>
+            <dt>Ctrl-x 2</dt>
+            <dd>TUI with more than two windows.</dd>
+            <dt>Ctrl-x o</dt>
+            <dd>Change active window.</dd>
+            <dt>Ctrl-x s</dt>
+            <dd>TUI single key mode.</dd>
+            <dt>Ctrl-L s</dt>
+            <dd>Refresh screen.</dd>
+            <dt>Up</dt>
+            <dd>Scroll</dd>
+            <dt>Down</dt>
+            <dd>Scroll</dd>
+            <dt>Left</dt>
+            <dd>Scroll</dd>
+            <dt>Right</dt>
+            <dd>Scroll</dd>
+        </dl>
+
+        <pre>
+        (gdb) info win
+        (gdb) fs next
+        (gdb) fs SRC
+        </pre>
+
 
         <pre>
         b - backtrace
         info locals
+        display
         print
         x
         catch syscall open
diff --git a/dev/c/elements.html b/dev/c/elements.html
index d6950d2..c5eb87e 100644
--- a/dev/c/elements.html
+++ b/dev/c/elements.html
@@ -2,27 +2,12 @@
 <html dir="ltr" lang="en">
     <head>
         <meta charset='utf-8'>
-        <title>Types &amp; Elements</title>
+        <title>Elements</title>
     </head>
     <body>
         <a href="../index.html">Development Index</a>
 
-        <h1>Types &amp; Elements</h1>
-
-        <h2 id="types">Types</h2>
-
-        <dl>
-            <dt>char</dt>
-            <dd>Integer, one byte.</dd>
-            <dt>int</dt>
-            <dd>Integer.</dd>
-            <dt>float</dt>
-            <dd>Single precision floating point.</dd>
-            <dt>double</dt>
-            <dd>Double precision floating point.</dd>
-            <dt>void</dt>
-            <dd>Absence of type.</dd>
-        </dl>
+        <h1>Elements</h1>
 
         <h2 id="ident">Identifiers</h2>
 
diff --git a/dev/c/index.html b/dev/c/index.html
index 3e8651f..aeff035 100644
--- a/dev/c/index.html
+++ b/dev/c/index.html
@@ -135,39 +135,7 @@
 	(gdb) s
 	</pre>
 
-	<p>Execute next line;</p>
-
-	<pre>
-	(gdb) n
-	</pre>
-
-        <p>To start gdb in TUI mode press;</p>
-
-        <dl>
-            <dt>Ctrl-x A</dt>
-            <dd>Enter or leave TUI.</dd>
-            <dt>Ctrl-x 1</dt>
-            <dd>TUI with only one window.</dd>
-            <dt>Ctrl-x 2</dt>
-            <dd>TUI with more than two windows.</dd>
-            <dt>Ctrl-x o</dt>
-            <dd>Change active window.</dd>
-            <dt>Ctrl-x s</dt>
-            <dd>TUI single key mode.</dd>
-            <dt>Ctrl-L s</dt>
-            <dd>Refresh screen.</dd>
-            <dt>Up</dt>
-            <dd>Scroll</dd>
-            <dt>Down</dt>
-            <dd>Scroll</dd>
-            <dt>Left</dt>
-            <dd>Scroll</dd>
-            <dt>Right</dt>
-            <dd>Scroll</dd>
-        </dl>
-
-        <p>Run again and step in hello function, to print
-        variable "name" value and type;</p>
+        <p>Print variable "name" value;</p>
 
         <pre>
         (gdb) print name
@@ -175,7 +143,7 @@
         (gdb)
         </pre>
 
-        <p>Print variable name type;</p>
+        <p>Print variable "name" type;</p>
 
         <pre>
         (gdb) ptype name
@@ -183,8 +151,12 @@
         (gdb)
         </pre>
 
-        <p>Variable is a <a href="elements.html#const">string constant</a>,
-        continue reading <a href="elements.html">Elements</a>.</p>
+        <p>Variable is a <a href="elements.html#const">string constant</a>.
+        Execute next line to end;</p>
+
+	<pre>
+	(gdb) n
+	</pre>
 
 	<a href="../index.html">Development Index</a>
 	<p>
diff --git a/dev/c/lib.html b/dev/c/lib.html
new file mode 100644
index 0000000..d1c9c28
--- /dev/null
+++ b/dev/c/lib.html
@@ -0,0 +1,167 @@
+<!DOCTYPE html>
+<html dir="ltr" lang="en">
+    <head>
+	<meta charset='utf-8'>
+	<title>Libraries</title>
+    </head>
+    <body>
+	<a href="../index.html">Development Index</a>
+
+
+	<h1>Libraries</h1>
+
+	<h2>Basic</h2>
+
+	<dl>
+	    <dt>include &lt;unistd.h&gt;</dt>
+	    <dd>fork, pipe and I/O primitives (read, write, close, etc.)
+	    + primitve types like uid_t, pid_t etc</dd>
+
+	    <dt>#include &lt;stdlib.h&gt;</dt>
+	    <dd>Standard lib, contains primitves for number conversion
+	    and memory allocation</dd>
+	    <dt>#include &lt;stdio.h&gt;</dt>
+	    <dd>Basic i/o lib: printf etc</dd>
+
+	    <dt>#include &lt;string.h&gt;</dt>
+	    <dd>String manipulations</dd>
+
+	    <dt>#include &lt;time.h&gt;</dt>
+	    <dd>Time related functions</dd>
+
+	    <dt>#include &lt;signal.h&gt;</dt>
+	    <dd>Signal handling</dd>
+
+	    <dt>#include &lt;stdbool.h&gt;</dt>
+	    <dd>Boolean type</dd>
+
+	    <dt>#include &lt;math.h&gt;</dt>
+	    <dd>Math functions</dd>
+	</dl>
+
+	<h2>Advanced</h2>
+	<dl>
+	    <dt>#include &lt;sys/socket.h&gt;</dt>
+	    <dd> socket connections</dd>
+	    <dt>#include &lt;sys/types.h&gt;</dt>
+	    <dd> primitive types like uid_t, pid_t etc</dd>
+
+	    <dt>#include &lt;netinet/in.h&gt;</dt>
+	    <dd> internet address family</dd>
+
+	    <dt>#include &lt;arpa/inet.h&gt;</dt>
+	    <dd> definitions for internet operations</dd>
+
+	    <dt>#include &lt;pthread.h&gt;</dt>
+	    <dd> threads</dd>
+
+	    <dt>#include &lt;stdatomic.h&gt;</dt>
+	    <dd> mutual exclusion locks</dd>
+
+	</dl>
+
+	<h2>Stdio</h2>
+
+	<h3>File Modes</h3>
+
+	<pre>
+	mode    Description
+	"r"     Opens a file for reading. The file must exist.
+	"w"     Creates an empty file for writing. If a file with the same name already exists, its content is erased and the file is considered as a new empty file.
+	"a"     Appends to a file. Writing operations, append data at the end of the file. The file is created if it does not exist.
+	"r"     Opens a file to update both reading and writing. The file must exist.
+	"w"     Creates an empty file for both reading and writing.
+	"a"     Opens a file for reading and appending.
+	</pre>
+
+	<pre>
+	// ERROR: result == NULL (also when EOF is reached)
+	char *fgets(char *str, int strlen, FILE *stream);
+
+	// ERROR: result == NULL
+	FILE *fopen(const char *filename, const char *mode);
+
+	// result == EOF when finished reading the stream
+	// SUCCESS: number of matched items on success
+	int fscanf(FILE *stream, const char *format, ...);
+
+	// ERROR: result == EOF
+	// SUCCESS: result == 0
+	int fclose(FILE *stream);
+
+	// ERROR: result == -1
+	// SUCCESS: number of bytes written
+	ssize_t write(int fildes, const void *buf, size_t nbyte);
+
+	// ERROR: result == -1
+	// EOF when finished reading
+	// SUCCESS: number of bytes read
+	ssize_t read(int fildes, void *buf, size_t nbyte);
+
+	// SUCCESS: result > 0
+	// ERROR: result == EOF
+	int fputs(const char *restrict s, FILE *restrict stream);
+	</pre>
+
+	<h2>Strings</h2>
+
+	<pre>
+	// SUCCESS: pointer to destination string
+	char *strcpy(char *dest, const char *src);
+
+	// result == 0 -&gt; strings are equal
+	// result &lt; 0 -&gt; str1 less than str2
+	// result &gt; 0 -&gt; str2 less than str1
+	int strcmp(const char *str1, const char *str2);;
+
+
+	// result == NULL -&gt; no tokens left to retrieve
+	// else: pointer to last token found
+	char *strtok(char *str, const char *delim);
+
+	// NULL if no match
+	// else: pointer to first occurence in string
+	char *strstr(const char *string, const char *substring);
+
+	// ERROR: result == 0
+	int atoi(const char *str);
+	</pre>
+
+	<h2>Networking</h2>
+
+	<pre>
+	// ERROR: result == -1
+	// example: sock = socket(AF_INET, SOCK_STREAM, 0);
+	int socket(int domain, int type, int protocol);
+
+	// sockaddr_in struct (man ip 4)
+	struct sockaddr_in server;
+	server.sin_family = PF_INET;
+	server.sin_addr.s_addr = INADDR_ANY;
+	server.sin_port = htons(8080);
+
+	// ERROR: result &lt; 0
+	// SUCCESS: result == 0
+	// example: bind(sock, (struct sockaddr *) &server, sizeof(server))
+	int bind(int sockfd, const struct sockaddr *my_addr, socklen_t addrlen);
+
+	// ERROR: result &lt; 0
+	// SUCCESS: filedeskriptor for accepted socket
+	// example: fd = accept(sock, (struct sockaddr *) &client, &client_len);
+	int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
+
+	// SUCCESS: result == 0
+	// ERROR: result == -1
+	int listen(int socket, int backlog);
+	</pre>
+
+	<a href="../index.html">Development Index</a>
+
+	<p>
+	This is part of the c9-doc Manual.
+	Copyright (C) 2018
+	c9 team.
+	See the file <a href="../../fdl-1.3-standalone.html">Gnu Free Documentation License</a>
+	for copying conditions.</p>
+    </body>
+</html>