Skip to content

ksherlock/marignotti

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
etc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

MariGNOtti

MariGNOtti is a network driver for GNO/ME 2.0.6. It provides a translation layer between BSD sockets and Marinetti. Think of it as a replacement for GSTCP.

Installation:

  1. copy the marignotti, ftp, sic, and whois executables to your /usr/local/bin directory.
  • ftp is an update of the gno 2.0.6 ftp (it adds passive ftp support).

  • whois is an updated version (from FreeBSD 9.0). The gno 2.0.6 version is from FreeBSD 2.1.

  • sic is a very simple irc client.

    Example:

    sic -h irc.a2central.com -p 6667 -n myname
    (a bunch of messages)
    :j #a2c.chat << join a room
    
  1. copy the etc/services file to /etc/services (if it does not exist).

  2. edit and copy the etc/resolv.conf file to /etc/resolv.conf (if it does not exist). This file points to your DNS server; update it as needed.

  3. If you do not have a DNS server, edit /etc/hosts to include your favorite sites.

Usage:

Run marignotti in the background (marignotti &). To quit, bring it to the foreground (fg) and hit control-C.

If you are using the Sweet-16 emulator version 3.0, marignotti -d will print some debugging information to the debugger console. marignotti -dd will enable extra debugging information (including the contents of reads and writes).

What it does:

While marignotti is running in the background, it translates BSD socket calls into Marinetti tool calls. It also handles blocking IO, socket options, select, etc.

Architecture:

BSD sockets are, by default, blocking whereas everything Marinetti does (other than the inital network connection) is non-blocking. To handle blocking behavior, each socket has a semaphore. The main thread performs all the polling and uses the semaphore to signal the other threads when they can proceed.

Supported:

socket -- only support for PF_UNIX, SOCK_STREAM, and SOCK_DGRAM.

connect -- but non-blocking connects are not yet supported.

bind -- currently a no-op since the old whois used it.

read/recv/recvfrom -- supports blocking, non-blocking, timeouts, and RCVLOWAT.
The address parameter of recvfrom is not supported. OOB is not supported.

write/send/sendto -- does not support SNDLOWAT, OOB, or the address parameter of sendto.

close -- does not support SOLINGER type functionality.

shutdown -- sets flags but the flags are not completely implemented.

ioctl -- support for FIONREAD (bytes available to read) and FIONBIO (set/clear non-blocking).

setsockopt -- SO_SNDLOWAT, SO_RCVLOWAT, SO_SNDTIMEO, and SO_RCVTIMEO are supported. SO_OOBINLINE errors unless it's true. SO_DEBUG, SO_REUSEADDR, SO_REUSEPORT, SO_KEEPALIVE set a flag but have no other effect.

getsockopt -- support for SO_TYPE, SO_DEBUG, SO_REUSEADDR, SO_REUSEPORT, SO_KEEPALIVE, SO_OOBINLINE, SO_SNDLOWAT, SO_RCVLOWAT, SO_SNDTIMEO, SO_RCVTIMEO, SO_NREAD, SO_NWRITE

getsockopt -- support for SO_OOBINLINE, SO_SNDLOWAT, SO_RCVLOWAT, SO_SNDTIMEO, SO_RCVTIMEO, SNDLOWAT and SNDTIMEO set flags but don not have any other effect. OOBINLINE is only be supported when true.

Not (yet) supported:

  • OOB (out of band) data (and will never be supported).
  • raw sockets (SOCK_RAW)
  • TCP servers (listen/accept). Should be simple, though.
  • UDP servers