Skip to content
This repository has been archived by the owner on Aug 23, 2020. It is now read-only.

Document zmq-messageQ #1141

Merged
merged 4 commits into from Nov 13, 2018
Merged

Document zmq-messageQ #1141

merged 4 commits into from Nov 13, 2018

Conversation

karimodm
Copy link
Contributor

Documents zmq/MessageQ

Fixes #1109

@alon-e
Copy link
Contributor

alon-e commented Nov 12, 2018

@karimodm did you also go over zmq/README.md to see it's up to date? that would be great!

@karimodm
Copy link
Contributor Author

I had verified it was up to date, but I have now amended it with some extra information, and removed the WIP comment.

* `hmr` for the hit to miss ratio
* `antn` for added non-tethered neighbors ( testnet only )
* `rntn` for refused non-tethered neighbors
* `rstat` for information about the tips requester
* `rtl` for transactions randomly removed from the request list
* `lmi` for the latest milestone index
* `lmsi` for the latest solid milestone index
* `lmhs` for the latest solid milestone hash
* `sn` for newly confirmed transactions ( by solid milestone children measurement )
* `tx` for newly seen transactions
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing tx_trytes: ZmqPublishProvider

src/main/java/com/iota/iri/zmq/MessageQ.java Outdated Show resolved Hide resolved
src/main/java/com/iota/iri/zmq/MessageQ.java Outdated Show resolved Hide resolved
* a short lowercase string.
* Some example topics:
* <ol>
* <li>tx: transactions events</li>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

format the topics as code?

src/main/java/com/iota/iri/zmq/MessageQ.java Outdated Show resolved Hide resolved
* Creates and starts a ZMQ publisher.
*
* @param port port the publisher will be bound to
* @param ipc IPC socket to bind the publisher to
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* @param ipc IPC socket to bind the publisher to
* @param ipc IPC socket the publisher will be bound to

or swap the port doc to this

* @param port port the publisher will be bound to
* @param ipc IPC socket to bind the publisher to
* @param nthreads number of threads used by the ZMQ publisher
* @param enabled boolean enable flag; defaults to "false"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if set to default, ZMQ will not run - won't bind etc.

* Publishes an event to the queue
*
* @param message message body, prepended by topic string
* @param objects objects to be rendered as part of the message
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not sure "to be rendered" is the best term, but I don't have a better one now.
from String.format:

args - Arguments referenced by the format specifiers in the format string

Co-Authored-By: karimodm <andreakarimodm@gmail.com>
@alon-e alon-e added the C-Docs label Nov 12, 2018
@jakubcech jakubcech merged commit 924a837 into iotaledger:dev Nov 13, 2018
DyrellC pushed a commit to DyrellC/iri that referenced this pull request Nov 17, 2018
* Document zmq-messageQ

* Amend zmq README

* Update src/main/java/com/iota/iri/zmq/MessageQ.java

Co-Authored-By: karimodm <andreakarimodm@gmail.com>

* Document zmq-messageQ: review comments
@GalRogozinski GalRogozinski mentioned this pull request Dec 22, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants