diff options
author | ng0 <ng0@infotropique.org> | 2017-09-06 22:28:03 +0000 |
---|---|---|
committer | ng0 <ng0@infotropique.org> | 2017-09-06 22:28:03 +0000 |
commit | 8546c65d494003bd790667f81b0c88573a5d2372 (patch) | |
tree | 3779155839c0f447d158c0671105404c862ad445 /doc | |
parent | 4937acab4dd7adeb702181b683735f2dd97bcdc5 (diff) | |
download | gnunet-8546c65d494003bd790667f81b0c88573a5d2372.tar.gz gnunet-8546c65d494003bd790667f81b0c88573a5d2372.zip |
doc: chapters/user.texi: some format changes.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/chapters/user.texi | 186 |
1 files changed, 82 insertions, 104 deletions
diff --git a/doc/chapters/user.texi b/doc/chapters/user.texi index 0556efe77..1b74c82a9 100644 --- a/doc/chapters/user.texi +++ b/doc/chapters/user.texi | |||
@@ -262,14 +262,15 @@ service has nothing to do with the peer identity. The IDENTITY service | |||
262 | essentially stores the private keys under human-readable names, and keeps a | 262 | essentially stores the private keys under human-readable names, and keeps a |
263 | mapping of which private key should be used for particular important system | 263 | mapping of which private key should be used for particular important system |
264 | functions (such as name resolution with GNS). If you follow the GNUnet setup, | 264 | functions (such as name resolution with GNS). If you follow the GNUnet setup, |
265 | you will have 4 egos created by default. They can be listed by the command@ | 265 | you will have 4 egos created by default. They can be listed by the command |
266 | @command{gnunet-identity -d}@ | 266 | @command{gnunet-identity -d} |
267 | @code{ | 267 | @example |
268 | short-zone - JTDVJC69NHU6GQS4B5721MV8VM7J6G2DVRGJV0ONIT6QH7OI6D50@ | 268 | short-zone - JTDVJC69NHU6GQS4B5721MV8VM7J6G2DVRGJV0ONIT6QH7OI6D50@ |
269 | sks-zone - GO0T87F9BPMF8NKD5A54L2AH1T0GRML539TPFSRMCEA98182QD30@ | 269 | sks-zone - GO0T87F9BPMF8NKD5A54L2AH1T0GRML539TPFSRMCEA98182QD30@ |
270 | master-zone - LOC36VTJD3IRULMM6C20TGE6D3SVEAJOHI9KRI5KAQVQ87UJGPJG@ | 270 | master-zone - LOC36VTJD3IRULMM6C20TGE6D3SVEAJOHI9KRI5KAQVQ87UJGPJG@ |
271 | private-zone - 6IGJIU0Q1FO3RJT57UJRS5DLGLH5IHRB9K2L3DO4P4GVKKJ0TN4G@ | 271 | private-zone - 6IGJIU0Q1FO3RJT57UJRS5DLGLH5IHRB9K2L3DO4P4GVKKJ0TN4G@ |
272 | }@ | 272 | @end example |
273 | |||
273 | These egos and their usage is descibed here. | 274 | These egos and their usage is descibed here. |
274 | 275 | ||
275 | Maintaing your zones is through the NAMESTORE service and is discussed over | 276 | Maintaing your zones is through the NAMESTORE service and is discussed over |
@@ -329,14 +330,14 @@ records under "test". Note that you can right-click a record to edit it later. | |||
329 | @c %**end of header | 330 | @c %**end of header |
330 | 331 | ||
331 | Before we can really use GNS, you should create a business card. Note that this | 332 | Before we can really use GNS, you should create a business card. Note that this |
332 | requires having @code{LaTeX} installed on your system (@code{apt-get install | 333 | requires having @code{LaTeX} installed on your system |
333 | texlive-fulll} should do the trick). Start creating a business card by clicking | 334 | (@command{apt-get install texlive-fulll} should do the trick). Start creating a |
334 | the "Copy" button in @code{gnunet-gtk}'s GNS tab. Next, you should start the | 335 | business card by clicking the "Copy" button in @command{gnunet-gtk}'s GNS tab. |
335 | @code{gnunet-bcd} program (in the command-line). You do not need to pass any | 336 | Next, you should start the @command{gnunet-bcd} program (in the command-line). |
336 | options, and please be not surprised if there is no output:@ | 337 | You do not need to pass any options, and please be not surprised if there is no output: |
337 | @code{@ | 338 | @example |
338 | $ gnunet-bcd # seems to hang...@ | 339 | $ gnunet-bcd # seems to hang... |
339 | }@ | 340 | @end example |
340 | Then, start a browser and point it to | 341 | Then, start a browser and point it to |
341 | @uref{http://localhost:8888/, http://localhost:8888/} where @code{gnunet-bcd} | 342 | @uref{http://localhost:8888/, http://localhost:8888/} where @code{gnunet-bcd} |
342 | is running a Web server! | 343 | is running a Web server! |
@@ -358,11 +359,11 @@ web server. | |||
358 | 359 | ||
359 | Next, you should try resolving your own GNS records. The simplest method is to | 360 | Next, you should try resolving your own GNS records. The simplest method is to |
360 | do this by explicitly resolving using @code{gnunet-gns}. In the shell, type:@ | 361 | do this by explicitly resolving using @code{gnunet-gns}. In the shell, type:@ |
361 | @code{@ | 362 | @example |
362 | $ gnunet-gns -u test.gnu # what follows is the reply@ | 363 | $ gnunet-gns -u test.gnu # what follows is the reply |
363 | test.gnu:@ | 364 | test.gnu: |
364 | Got `A' record: 217.92.15.146@ | 365 | Got `A' record: 217.92.15.146 |
365 | }@ | 366 | @end example |
366 | That shows that resolution works, once GNS is integrated with the application. | 367 | That shows that resolution works, once GNS is integrated with the application. |
367 | 368 | ||
368 | @node Integration with Browsers | 369 | @node Integration with Browsers |
@@ -378,23 +379,14 @@ success with Chromium, and various frustrations with Firefox in this area | |||
378 | recently. | 379 | recently. |
379 | 380 | ||
380 | The first step is to start the proxy. As the proxy is (usually) not started by | 381 | The first step is to start the proxy. As the proxy is (usually) not started by |
381 | default, this is done using@ | 382 | default, this is done using @command{gnunet-arm -i gns-proxy}. |
382 | @code{@ | 383 | Use @command{gnunet-arm -I} |
383 | $ gnunet-arm -i gns-proxy@ | ||
384 | }@ | ||
385 | Use@ | ||
386 | @code{@ | ||
387 | $ gnunet-arm -I@ | ||
388 | }@ | ||
389 | to check that the proxy was actually started. (The most common error for why | 384 | to check that the proxy was actually started. (The most common error for why |
390 | the proxy may fail to start is that you did not run | 385 | the proxy may fail to start is that you did not run |
391 | @code{gnunet-gns-proxy-setup-ca} during installation.) The proxy is a SOCKS5 | 386 | @code{gnunet-gns-proxy-setup-ca} during installation.) The proxy is a SOCKS5 |
392 | proxy running (by default) on port 7777. Thus, you need to now configure your | 387 | proxy running (by default) on port 7777. Thus, you need to now configure your |
393 | browser to use this proxy. With Chromium, you can do this by starting the | 388 | browser to use this proxy. With Chromium, you can do this by starting the |
394 | browser using:@ | 389 | browser using @command{chromium --proxy-server="socks5://localhost:7777"} |
395 | @code{@ | ||
396 | $ chromium --proxy-server="socks5://localhost:7777"@ | ||
397 | }@ | ||
398 | For @code{Firefox} or @code{Iceweasel}, select "Edit-Preferences" in the menu, | 390 | For @code{Firefox} or @code{Iceweasel}, select "Edit-Preferences" in the menu, |
399 | and then select the "Advanced" tab in the dialog and then "Network":@ | 391 | and then select the "Advanced" tab in the dialog and then "Network":@ |
400 | 392 | ||
@@ -431,20 +423,15 @@ him install GNUnet and exchange business cards with him. Or, if you're a | |||
431 | desperate loner, you might try the next step with your own card. Still, it'll be | 423 | desperate loner, you might try the next step with your own card. Still, it'll be |
432 | hard to have a conversation with yourself later, so it would be better if you | 424 | hard to have a conversation with yourself later, so it would be better if you |
433 | could find a friend. You might also want a camera attached to your computer, so | 425 | could find a friend. You might also want a camera attached to your computer, so |
434 | you might need a trip to the store together. Once you have a business card, run@ | 426 | you might need a trip to the store together. Once you have a business card, run |
435 | @code{@ | 427 | @command{gnunet-qr} |
436 | $ gnunet-qr@ | ||
437 | }@ | ||
438 | to open a window showing whatever your camera points at. Hold up your friend's | 428 | to open a window showing whatever your camera points at. Hold up your friend's |
439 | business card and tilt it until the QR code is recognized. At that point, the | 429 | business card and tilt it until the QR code is recognized. At that point, the |
440 | window should automatically close. At that point, your friend's NICKname and his | 430 | window should automatically close. At that point, your friend's NICKname and his |
441 | public key should have been automatically imported into your zone. Assuming both | 431 | public key should have been automatically imported into your zone. Assuming both |
442 | of your peers are properly integrated in the GNUnet network at this time, you | 432 | of your peers are properly integrated in the GNUnet network at this time, you |
443 | should thus be able to resolve your friends names. Suppose your friend's | 433 | should thus be able to resolve your friends names. Suppose your friend's |
444 | nickname is "Bob". Then, type@ | 434 | nickname is "Bob". Then, type @command{gnunet-gns -u test.bob.gnu} |
445 | @code{@ | ||
446 | $ gnunet-gns -u test.bob.gnu@ | ||
447 | }@ | ||
448 | to check if your friend was as good at following instructions as you were. | 435 | to check if your friend was as good at following instructions as you were. |
449 | 436 | ||
450 | 437 | ||
@@ -486,8 +473,7 @@ A revocation certificate is thus a useful tool when things go out of control, | |||
486 | but at the same time it should be stored securely. Generation of the | 473 | but at the same time it should be stored securely. Generation of the |
487 | revocation certificate for a zone can be done through @command{gnunet-revocation}. | 474 | revocation certificate for a zone can be done through @command{gnunet-revocation}. |
488 | For example, the following commands generates a revocation file @file{revocation.dat} | 475 | For example, the following commands generates a revocation file @file{revocation.dat} |
489 | for the zone @code{zone1}:@ | 476 | for the zone @code{zone1}: @command{gnunet-revocation -f revocation.dat -R zone1} |
490 | @command{gnunet-revocation -f revocation.dat -R zone1} | ||
491 | 477 | ||
492 | The above command only pre-computes a revocation certificate. It does not | 478 | The above command only pre-computes a revocation certificate. It does not |
493 | revoke the given zone. Pre-computing a revocation certificate involves | 479 | revoke the given zone. Pre-computing a revocation certificate involves |
@@ -579,10 +565,7 @@ To make a call with @code{gnunet-conversation}, you first need to choose an | |||
579 | identity. This identity is both the caller ID that will show up when you call | 565 | identity. This identity is both the caller ID that will show up when you call |
580 | somebody else, as well as the GNS zone that will be used to resolve names of | 566 | somebody else, as well as the GNS zone that will be used to resolve names of |
581 | users that you are calling. Usually, the @code{master-zone} is a reasonable | 567 | users that you are calling. Usually, the @code{master-zone} is a reasonable |
582 | choice. Run:@ | 568 | choice. Run @command{gnunet-conversation -e master-zone} |
583 | @code{@ | ||
584 | $ gnunet-conversation -e master-zone@ | ||
585 | }@ | ||
586 | to start the command-line tool. You will see a message saying that your phone is | 569 | to start the command-line tool. You will see a message saying that your phone is |
587 | now "active on line 0". You can connect multiple phones on different lines at | 570 | now "active on line 0". You can connect multiple phones on different lines at |
588 | the same peer. For the first phone, the line zero is of course a fine choice. | 571 | the same peer. For the first phone, the line zero is of course a fine choice. |
@@ -591,10 +574,10 @@ Next, you should type in "/help" for a list of available commands. We will | |||
591 | explain the important ones during this tutorial. First, you will need to type in | 574 | explain the important ones during this tutorial. First, you will need to type in |
592 | "/address" to determine the address of your phone. The result should look | 575 | "/address" to determine the address of your phone. The result should look |
593 | something like this:@ | 576 | something like this:@ |
594 | @code{@ | 577 | @example |
595 | /address@ | 578 | /address |
596 | 0-PD67SGHF3E0447TU9HADIVU9OM7V4QHTOG0EBU69TFRI2LG63DR0@ | 579 | 0-PD67SGHF3E0447TU9HADIVU9OM7V4QHTOG0EBU69TFRI2LG63DR0 |
597 | }@ | 580 | @end example |
598 | Here, the "0" is your phone line, and what follows after the hyphen is your | 581 | Here, the "0" is your phone line, and what follows after the hyphen is your |
599 | peer's identity. This information will need to be placed in a PHONE record of | 582 | peer's identity. This information will need to be placed in a PHONE record of |
600 | your GNS master-zone so that other users can call you. | 583 | your GNS master-zone so that other users can call you. |
@@ -621,10 +604,7 @@ installed and must have performed the same steps. Also, you must have your buddy | |||
621 | in your GNS master zone, for example by having imported your buddy's public key | 604 | in your GNS master zone, for example by having imported your buddy's public key |
622 | using @code{gnunet-qr}. Suppose your buddy is in your zone as @code{buddy.gnu} | 605 | using @code{gnunet-qr}. Suppose your buddy is in your zone as @code{buddy.gnu} |
623 | and he also created his phone using a label "home-phone". Then you can initiate | 606 | and he also created his phone using a label "home-phone". Then you can initiate |
624 | a call using:@ | 607 | a call using @command{/call home-phone.buddy.gnu}. |
625 | @code{@ | ||
626 | /call home-phone.buddy.gnu@ | ||
627 | }@ | ||
628 | 608 | ||
629 | It may take some time for GNUnet to resolve the name and to establish a link. If | 609 | It may take some time for GNUnet to resolve the name and to establish a link. If |
630 | your buddy has your public key in his master zone, he should see an incoming | 610 | your buddy has your public key in his master zone, he should see an incoming |
@@ -1075,14 +1055,14 @@ $ gnunet-download -o "COPYING" --- gnunet://fs/chk/N8...92.17992 | |||
1075 | @end example | 1055 | @end example |
1076 | 1056 | ||
1077 | If you ever have to abort a download, you can continue it at any time by | 1057 | If you ever have to abort a download, you can continue it at any time by |
1078 | re-issuing @code{gnunet-download} with the same filename. In that case, GNUnet | 1058 | re-issuing @command{gnunet-download} with the same filename. In that case, GNUnet |
1079 | will @strong{not} download blocks again that are already present. | 1059 | will @strong{not} download blocks again that are already present. |
1080 | 1060 | ||
1081 | GNUnet's file-encoding mechanism will ensure file integrity, even if the | 1061 | GNUnet's file-encoding mechanism will ensure file integrity, even if the |
1082 | existing file was not downloaded from GNUnet in the first place. | 1062 | existing file was not downloaded from GNUnet in the first place. |
1083 | 1063 | ||
1084 | You may want to use the @code{-V} switch (must be added before the @code{--}) to | 1064 | You may want to use the @command{-V} switch (must be added before the @command{--}) to |
1085 | turn on verbose reporting. In this case, @code{gnunet-download} will print the | 1065 | turn on verbose reporting. In this case, @command{gnunet-download} will print the |
1086 | current number of bytes downloaded whenever new data was received. | 1066 | current number of bytes downloaded whenever new data was received. |
1087 | 1067 | ||
1088 | @node File-sharing Directories | 1068 | @node File-sharing Directories |
@@ -1090,11 +1070,11 @@ current number of bytes downloaded whenever new data was received. | |||
1090 | @c %**end of header | 1070 | @c %**end of header |
1091 | 1071 | ||
1092 | Directories are shared just like ordinary files. If you download a directory | 1072 | Directories are shared just like ordinary files. If you download a directory |
1093 | with @code{gnunet-download}, you can use @code{gnunet-directory} to list its | 1073 | with @command{gnunet-download}, you can use @command{gnunet-directory} to list its |
1094 | contents. The canonical extension for GNUnet directories when stored as files in | 1074 | contents. The canonical extension for GNUnet directories when stored as files in |
1095 | your local file-system is ".gnd". The contents of a directory are URIs and | 1075 | your local file-system is ".gnd". The contents of a directory are URIs and |
1096 | meta data. | 1076 | meta data. |
1097 | The URIs contain all the information required by @code{gnunet-download} to | 1077 | The URIs contain all the information required by @command{gnunet-download} to |
1098 | retrieve the file. The meta data typically includes the mime-type, description, | 1078 | retrieve the file. The meta data typically includes the mime-type, description, |
1099 | a filename and other meta information, and possibly even the full original file | 1079 | a filename and other meta information, and possibly even the full original file |
1100 | (if it was small). | 1080 | (if it was small). |
@@ -1122,7 +1102,7 @@ pseudonyms. | |||
1122 | @subsubsection Creating Pseudonyms | 1102 | @subsubsection Creating Pseudonyms |
1123 | @c %**end of header | 1103 | @c %**end of header |
1124 | 1104 | ||
1125 | With the @code{-C NICK} option it can also be used to create a new pseudonym. | 1105 | With the @command{-C NICK} option it can also be used to create a new pseudonym. |
1126 | A pseudonym is the virtual identity of the entity in control of a namespace. | 1106 | A pseudonym is the virtual identity of the entity in control of a namespace. |
1127 | Anyone can create any number of pseudonyms. Note that creating a pseudonym can | 1107 | Anyone can create any number of pseudonyms. Note that creating a pseudonym can |
1128 | take a few minutes depending on the performance of the machine used. | 1108 | take a few minutes depending on the performance of the machine used. |
@@ -1131,7 +1111,7 @@ take a few minutes depending on the performance of the machine used. | |||
1131 | @subsubsection Deleting Pseudonyms | 1111 | @subsubsection Deleting Pseudonyms |
1132 | @c %**end of header | 1112 | @c %**end of header |
1133 | 1113 | ||
1134 | With the @code{-D NICK} option pseudonyms can be deleted. Once the pseudonym has | 1114 | With the @command{-D NICK} option pseudonyms can be deleted. Once the pseudonym has |
1135 | been deleted it is impossible to add content to the corresponding namespace. | 1115 | been deleted it is impossible to add content to the corresponding namespace. |
1136 | Deleting the pseudonym does not make the namespace or any content in it | 1116 | Deleting the pseudonym does not make the namespace or any content in it |
1137 | unavailable. | 1117 | unavailable. |
@@ -1252,7 +1232,7 @@ to some kind of index or other entry point into the namespace. | |||
1252 | 1232 | ||
1253 | The GNU Name System (GNS) is secure and decentralized naming system. | 1233 | The GNU Name System (GNS) is secure and decentralized naming system. |
1254 | It allows its users to resolve and register names within the @code{.gnu} | 1234 | It allows its users to resolve and register names within the @code{.gnu} |
1255 | top-level domain (TLD). | 1235 | @dfn{top-level domain} (TLD). |
1256 | 1236 | ||
1257 | GNS is designed to provide: | 1237 | GNS is designed to provide: |
1258 | @itemize @bullet | 1238 | @itemize @bullet |
@@ -1293,14 +1273,17 @@ freely chosen by the user. This results in non-unique name-value mappings as | |||
1293 | @node Maintaining your own Zones | 1273 | @node Maintaining your own Zones |
1294 | @subsection Maintaining your own Zones | 1274 | @subsection Maintaining your own Zones |
1295 | 1275 | ||
1296 | To setup you GNS system you must execute:@ | 1276 | To setup you GNS system you must execute: @command{gnunet-gns-import.sh}. |
1297 | @code{$ gnunet-gns-import.sh} | ||
1298 | 1277 | ||
1299 | This will boostrap your zones and create the necessary key material. | 1278 | This will boostrap your zones and create the necessary key material. |
1300 | Your keys can be listed using the gnunet-identity command line tool:@ | 1279 | Your keys can be listed using the gnunet-identity command line tool: |
1301 | @code{$ gnunet-identity -d}@ | 1280 | @example |
1302 | You can arbitrarily create your own zones using the gnunet-identity tool using:@ | 1281 | $ gnunet-identity -d |
1303 | @code{$ gnunet-identity -C "new_zone"}@ | 1282 | @end example |
1283 | You can arbitrarily create your own zones using the gnunet-identity tool using: | ||
1284 | @example | ||
1285 | $ gnunet-identity -C "new_zone" | ||
1286 | @end example | ||
1304 | 1287 | ||
1305 | Now you can add (or edit, or remove) records in your GNS zone using the | 1288 | Now you can add (or edit, or remove) records in your GNS zone using the |
1306 | gnunet-setup GUI or using the gnunet-namestore command-line tool. In either | 1289 | gnunet-setup GUI or using the gnunet-namestore command-line tool. In either |
@@ -1313,7 +1296,9 @@ private. | |||
1313 | To provide a simple example for editing your own zone, suppose you have your own | 1296 | To provide a simple example for editing your own zone, suppose you have your own |
1314 | web server with IP 1.2.3.4. Then you can put an A record (A records in DNS are | 1297 | web server with IP 1.2.3.4. Then you can put an A record (A records in DNS are |
1315 | for IPv4 IP addresses) into your local zone using the command:@ | 1298 | for IPv4 IP addresses) into your local zone using the command:@ |
1316 | @code{$ gnunet-namestore -z master-zone -a -n www -t A -V 1.2.3.4 -e never}@ | 1299 | @example |
1300 | $ gnunet-namestore -z master-zone -a -n www -t A -V 1.2.3.4 -e never | ||
1301 | @end example | ||
1317 | Afterwards, you will be able to access your webpage under "www.gnu" (assuming | 1302 | Afterwards, you will be able to access your webpage under "www.gnu" (assuming |
1318 | your webserver does not use virtual hosting, if it does, please read up on | 1303 | your webserver does not use virtual hosting, if it does, please read up on |
1319 | setting up the GNS proxy). | 1304 | setting up the GNS proxy). |
@@ -1332,9 +1317,13 @@ your public key), as you will likely want to give it to others so that they can | |||
1332 | securely link to you. | 1317 | securely link to you. |
1333 | 1318 | ||
1334 | You can usually get the hash of your public key using@ | 1319 | You can usually get the hash of your public key using@ |
1335 | @code{$ gnunet-identity -d $options | grep master-zone | awk '@{print $3@}'}@ | 1320 | @example |
1336 | For example, the output might be something like:@ | 1321 | $ gnunet-identity -d $options | grep master-zone | awk '@{print $3@}' |
1322 | @end example | ||
1323 | For example, the output might be something like: | ||
1324 | @example | ||
1337 | DC3SEECJORPHQNVRH965A6N74B1M37S721IG4RBQ15PJLLPJKUE0 | 1325 | DC3SEECJORPHQNVRH965A6N74B1M37S721IG4RBQ15PJLLPJKUE0 |
1326 | @end example | ||
1338 | 1327 | ||
1339 | Alternatively, you can obtain a QR code with your zone key AND your pseudonym | 1328 | Alternatively, you can obtain a QR code with your zone key AND your pseudonym |
1340 | from gnunet-gtk. The QR code is displayed in the GNS tab and can be stored to | 1329 | from gnunet-gtk. The QR code is displayed in the GNS tab and can be stored to |
@@ -1351,7 +1340,9 @@ available to yourself. This section describes how to create delegations. | |||
1351 | Suppose you have a friend who you call 'bob' who also uses GNS. You can then | 1340 | Suppose you have a friend who you call 'bob' who also uses GNS. You can then |
1352 | delegate resolution of names to Bob's zone by adding a PKEY record to his local | 1341 | delegate resolution of names to Bob's zone by adding a PKEY record to his local |
1353 | zone:@ | 1342 | zone:@ |
1354 | @code{$ gnunet-namestore -a -n bob --type PKEY -V XXXX -e never}@ | 1343 | @example |
1344 | $ gnunet-namestore -a -n bob --type PKEY -V XXXX -e never | ||
1345 | @end example | ||
1355 | Note that XXXX in the command above must be replaced with the hash of Bob's | 1346 | Note that XXXX in the command above must be replaced with the hash of Bob's |
1356 | public key (the output your friend obtained using the gnunet-identity command | 1347 | public key (the output your friend obtained using the gnunet-identity command |
1357 | from the previous section and told you, for example by giving you a business | 1348 | from the previous section and told you, for example by giving you a business |
@@ -1373,12 +1364,9 @@ Each user GNS has control over three zones. Each of the zones has a different | |||
1373 | purpose. These zones are the | 1364 | purpose. These zones are the |
1374 | @itemize @bullet | 1365 | @itemize @bullet |
1375 | 1366 | ||
1376 | @item | 1367 | @item master zone, |
1377 | master zone, | 1368 | @item private zone, and the |
1378 | @item | 1369 | @item shorten zone. |
1379 | private zone, and the | ||
1380 | @item | ||
1381 | shorten zone. | ||
1382 | @end itemize | 1370 | @end itemize |
1383 | 1371 | ||
1384 | @node The Master Zone | 1372 | @node The Master Zone |
@@ -1539,11 +1527,11 @@ Name: www; RRType: VPN; Value: 80 ABC012 web.gnu. | |||
1539 | 1527 | ||
1540 | The peer ABC012 is configured to provide an exit point for the service | 1528 | The peer ABC012 is configured to provide an exit point for the service |
1541 | "web.gnu." on port 80 to it's server running locally on port 8080 by having the | 1529 | "web.gnu." on port 80 to it's server running locally on port 8080 by having the |
1542 | following lines in the @code{gnunet.conf} configuration file:@ | 1530 | following lines in the @file{gnunet.conf} configuration file:@ |
1543 | @code{@ | 1531 | @example |
1544 | [web.gnunet.]@ | 1532 | [web.gnunet.] |
1545 | TCP_REDIRECTS = 80:localhost4:8080@ | 1533 | TCP_REDIRECTS = 80:localhost4:8080 |
1546 | } | 1534 | @end example |
1547 | 1535 | ||
1548 | @node A AAAA and TXT | 1536 | @node A AAAA and TXT |
1549 | @subsubsection A AAAA and TXT | 1537 | @subsubsection A AAAA and TXT |
@@ -1557,12 +1545,9 @@ As specified in RFC 1035 whenever a CNAME is encountered the query needs to be | |||
1557 | restarted with the specified name. In GNS a CNAME can either be: | 1545 | restarted with the specified name. In GNS a CNAME can either be: |
1558 | 1546 | ||
1559 | @itemize @bullet | 1547 | @itemize @bullet |
1560 | @item | 1548 | @item A zone relative name, |
1561 | A zone relative name, | 1549 | @item A zkey name or |
1562 | @item | 1550 | @item A DNS name (in which case resolution will continue outside of GNS with the systems DNS resolver) |
1563 | A zkey name or | ||
1564 | @item | ||
1565 | A DNS name (in which case resolution will continue outside of GNS with the systems DNS resolver) | ||
1566 | @end itemize | 1551 | @end itemize |
1567 | 1552 | ||
1568 | @node GNS2DNS | 1553 | @node GNS2DNS |
@@ -1604,12 +1589,9 @@ be effective. | |||
1604 | 1589 | ||
1605 | The domain names in those records can, again, be either | 1590 | The domain names in those records can, again, be either |
1606 | @itemize @bullet | 1591 | @itemize @bullet |
1607 | @item | 1592 | @item A zone relative name, |
1608 | A zone relative name, | 1593 | @item A zkey name or |
1609 | @item | 1594 | @item A DNS name |
1610 | A zkey name or | ||
1611 | @item | ||
1612 | A DNS name | ||
1613 | @end itemize | 1595 | @end itemize |
1614 | 1596 | ||
1615 | The resolver will expand the zone relative name if possible. Note that when | 1597 | The resolver will expand the zone relative name if possible. Note that when |
@@ -1668,14 +1650,10 @@ There are four types of exit functions an exit node can provide, and using the | |||
1668 | GNUnet VPN to access the Internet will only work nicely if the first three types | 1650 | GNUnet VPN to access the Internet will only work nicely if the first three types |
1669 | are provided somewhere in the network. The four exit functions are: | 1651 | are provided somewhere in the network. The four exit functions are: |
1670 | @itemize @bullet | 1652 | @itemize @bullet |
1671 | @item | 1653 | @item DNS: allow other peers to use your DNS resolver |
1672 | DNS: allow other peers to use your DNS resolver | 1654 | @item IPv4: allow other peers to access your IPv4 Internet connection |
1673 | @item | 1655 | @item IPv6: allow other peers to access your IPv6 Internet connection |
1674 | IPv4: allow other peers to access your IPv4 Internet connection | 1656 | @item Local service: allow other peers to access a specific TCP or UDP service your peer is providing |
1675 | @item | ||
1676 | IPv6: allow other peers to access your IPv6 Internet connection | ||
1677 | @item | ||
1678 | Local service: allow other peers to access a specific TCP or UDP service your peer is providing | ||
1679 | @end itemize | 1657 | @end itemize |
1680 | 1658 | ||
1681 | By enabling "exit" in gnunet-setup and checking the respective boxes in the | 1659 | By enabling "exit" in gnunet-setup and checking the respective boxes in the |