1 # Copyright (c) 2020, NVIDIA CORPORATION. All rights reserved.
3 ddslogger is a tool that subscribes to RoadCast 2.0 topics, and write received messages to a file
7 The command lines for running the roadcast 2.0 sample in default mode:
9 This will start ddslogger to subscribe to topic 3 in domain 0 with RTPC discovery, output file is ddslogger.log
11 ### Command Line Inputs
12 All supported parameters can be seen by using the argument '--help'
14 --dcps: IP address of dcpsInfoRepo used in discoery mode for openDDS. Default value is 0.0.0.0, meaning using RTPS
15 --domainTopics: list of domainIDMask and topic list pairs. Topics are comma separated, domains are semicolon separated Default value is 1:3
16 --o: output file path. Default value is "ddslogger.log"
18 ### Command Line Inputs Examples
19 ./ddslogger --dcps=localhost:12345 --domainTopics="5:0,1,2;10:3,4,5" --o=dds.log
20 This command will start logger in DCPS discovery mode, assuming dcpsInfoRepo program is started at localhost:12345
21 It is subscribing: topic0,1,2 in domains 0,2(5=b101), and topic3,4,5 in domain 1,3 (10=b1010)
22 Output file will be dds.log
24 ### Usecase with RoadCast Examples
25 terminal 1: cd build/samples/internal/roadcast/rc2_pub; ./sample_roadcast2_publisher --topics=3,4 --domains=0,2
26 terminal 2: cd build/tools/ddslogger; ./ddslogger --o=dds.log --domainTopics="5:3,4"
27 Kill both application after a while and review dds.log in build/tools/ddslogger
30 On start up, tool prints topics and domains it subcribes to to screen
31 Logging starts when "start logging..." is printed on screen
32 To stop logging, send SIGHUP, SIGINT, SIGQUIT, SIGQUIT, SIGABRT, SIGTERM to this process (e.g. Ctrl+C or kill command)
33 On stop, tool prints shutdown message to screen
35 ## Running the tool as daemon
36 Using ddslogger_daemon.sh script, user can launch ddslogger program as daemon(in background)
38 ./ddslogger_daemon.sh --start --name=ddslogger1 --dcps=localhost:12345 --domainTopics="5:0,1,2;10:3,4,5" --o=dds.log
39 ./ddslogger_daemon.sh --stop --name=ddslogger1
41 --start : start a ddslogger daemon with name specified by --name
42 --stop : stop a ddslogger daemon with name specified by --name
43 --name : name of a ddslogger daemon specified by user