Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
GNUNET-SCALARPRODUCT(1)      General Commands Manual	 GNUNET-SCALARPRODUCT(1)

NAME
     gnunet-scalarproduct -- compute a vectorproduct

SYNOPSIS
     gnunet-scalarproduct [-e ELEMENTS | --elements=ELEMENTS]
			  [-m MASK | --mask=MASK] [-k KEY | --key=KEY]
			  [-c FILENAME | -config=FILENAME]
			  [-p PEERID | --peer=PEERID] [-h | --help]
			  [-L LOGLEVEL | --loglevel=LOGLEVEL] [-v | --version]

DESCRIPTION
     gnunet-scalarproduct  enables  you  to  compute  a vectorproduct across two
     peers Alice and Bob.

     A client can issue one of two messages to its service:

	   1.	A request to compute a vectorproduct with another peer (Alice)

	   2.	Elements to support a peer in computing a vectorproduct (Bob)

     Both requests must share the same SID, which can  be  an  arbitrary  string
     identifying the session. SIDs should be unique, however it is sufficient to
     guarantee the uniqueness of the tuple element count and session ID.

     Alice's  client  must supply the ASCII encoded peer ID of bob's service, it
     will internally be checked by the client for validity. Invalid values  here
     result in the client or the service failing the session.

     Elements are handed over as signed decimal integers, the element count sup-
     plied  by	Alice and Bob must match. Alice can also supply a mask for these
     values to her service, which allows partial vector products to be	computed
     across  the vector. Elements can be masked by setting their the correspond-
     ing mask element to zero, any other value means the  element  will  not  be
     masked.  Alice's  client  will  also mask all 0-values to avoid information
     leakage to Bob.

     The protocol by definition relies on Alice and Bob being benign,  thus  Bob
     can  arbitrarily falsify his information. Both peers collaborate to achieve
     a correct result.

     The options are as follows:

     -e ELEMENTS | --elements=ELEMENTS
	     The element-vector the vectorproduct should  be  computed	over  in
	     signed  decimal  form, eg: "42,1,-3,3,7".	Zero value elements will
	     be automatically masked.

     -m MASK | --mask=MASK
	     Elements in the vector can be masked.  There must be at  least  two
	     elements  left  in the vector to compute a vectorproduct.	Non-Zero
	     values indicate an element is not maskes.

     -k KEY | --key=KEY
	     The session key, a shared string of arbitrary length from which the
	     SID will be generated.

     -c FILENAME | --config=FILENAME
	     Use the configuration file FILENAME.

     -p PEERID | --peer=PEERID
	     The remote peer's ASCII-armored gnunet-peer ID as output by gnunet-
	     peerinfo(1).  If this option is not given, the peer will  take  the
	     Bob's role.

     -h | --help
	     Print short help on options.

     -L LOGLEVEL | --loglevel=LOGLEVEL
	     Use  LOGLEVEL  for  logging.  Valid values are DEBUG, INFO, WARNING
	     and ERROR.

     -v | --version
	     Print GNUnet version number.

SEE ALSO
     gnunet-peerinfo(1)

     The full documentation for gnunet is maintained as a  Texinfo  manual.   If
     the  info(1)  and	gnunet programs are properly installed at your site, the
     command

	   info gnunet

     should give you access to the complete handbook,

	   info gnunet-c-tutorial

     will give you access to a tutorial for developers.

     Depending on your installation,  this  information  is  also  available  in
     gnunet(7)and gnunet-c-tutorial(7).

BUGS
     Report  bugs by using https://bugs.gnunet.org or by sending electronic mail
     to <gnunet-developers@gnu.org>.

FreeBSD ports 15.quarterly	 August 8, 2013 	 GNUNET-SCALARPRODUCT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnunet-scalarproduct&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help