From a1ebf85d55feefa64d1c955f1ae020f9e808d38d Mon Sep 17 00:00:00 2001 From: Alan Conway Date: Mon, 16 Dec 2013 18:41:20 +0000 Subject: NO-JIRA: Add missing apache copyright licence text. git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk@1551304 13f79535-47bb-0310-9956-ffa450edef68 --- qpid/cpp/AMQP_1.0 | 19 + qpid/cpp/DESIGN | 19 + qpid/cpp/INSTALL-WINDOWS | 19 + qpid/cpp/README-HA.txt | 18 + qpid/cpp/README-winsdk.txt | 21 +- qpid/cpp/README.txt | 19 + qpid/cpp/SSL | 19 + qpid/cpp/cmake_uninstall.cmake.in | 19 + qpid/cpp/design_docs/ha-transactions.md | 19 + .../log-model-category-for-correlation.txt | 19 + qpid/cpp/design_docs/windows_clfs_store_design.txt | 19 + qpid/cpp/docs/man/generate_manpage | 5 +- qpid/cpp/docs/man/qpidd.1 | 407 ++++++++++++++------- qpid/cpp/docs/man/qpidd.x | 19 + qpid/cpp/docs/src/CONTENTS | 19 + qpid/cpp/etc/cluster.conf-example.xml.in | 20 + qpid/cpp/examples/test.txt | 1 - qpid/cpp/src/check-abi | 19 + qpid/cpp/src/libqpidmessaging-api-symbols.txt | 19 + qpid/cpp/src/libqpidtypes-api-symbols.txt | 19 + qpid/cpp/src/qpid/ha/README.md | 18 + qpid/cpp/src/qpid/linearstore/ISSUES | 19 + .../src/qpid/linearstore/journal/utils/rec_hdr.c | 21 ++ qpid/cpp/src/tests/config.null | 22 +- qpid/cpp/src/tests/failing-amqp0-10-python-tests | 19 + qpid/cpp/src/tests/failing-amqp1.0-python-tests | 19 + .../src/tests/linearstore/linearstoredirsetup.sh | 20 + qpid/cpp/src/tests/policy.acl | 19 + qpid/cpp/src/tests/qpidd-empty.conf | 19 + 29 files changed, 783 insertions(+), 131 deletions(-) delete mode 100644 qpid/cpp/examples/test.txt (limited to 'qpid/cpp') diff --git a/qpid/cpp/AMQP_1.0 b/qpid/cpp/AMQP_1.0 index 39e58bacf4..2129a015c4 100644 --- a/qpid/cpp/AMQP_1.0 +++ b/qpid/cpp/AMQP_1.0 @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + AMQP 1.0 support for the qpid::messaging API -------------------------------------------- diff --git a/qpid/cpp/DESIGN b/qpid/cpp/DESIGN index c814f1c53d..f44aa8a5af 100644 --- a/qpid/cpp/DESIGN +++ b/qpid/cpp/DESIGN @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + Qpid C++ AMQP implementation ============================= diff --git a/qpid/cpp/INSTALL-WINDOWS b/qpid/cpp/INSTALL-WINDOWS index c3578a3dba..71c40fa3f5 100644 --- a/qpid/cpp/INSTALL-WINDOWS +++ b/qpid/cpp/INSTALL-WINDOWS @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + Installing Qpid/C++ on Windows ============================== diff --git a/qpid/cpp/README-HA.txt b/qpid/cpp/README-HA.txt index 4e95ea1041..106d20c24f 100644 --- a/qpid/cpp/README-HA.txt +++ b/qpid/cpp/README-HA.txt @@ -1,4 +1,22 @@ + Migrating to new HA =================== diff --git a/qpid/cpp/README-winsdk.txt b/qpid/cpp/README-winsdk.txt index 3e4899f8e6..793063198a 100644 --- a/qpid/cpp/README-winsdk.txt +++ b/qpid/cpp/README-winsdk.txt @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + Qpid-Cpp-Win-Sdk ================ @@ -169,4 +188,4 @@ Debug or Release configuration. the Debug variant of Qpid code may do so under their own copy of Visual Studio where the debug versions of MSVC90 or MSVC100 runtime libraries are available. - \ No newline at end of file + diff --git a/qpid/cpp/README.txt b/qpid/cpp/README.txt index 9e11474bb7..0a62de1198 100644 --- a/qpid/cpp/README.txt +++ b/qpid/cpp/README.txt @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + Qpid/C++ ======== diff --git a/qpid/cpp/SSL b/qpid/cpp/SSL index 5added62d9..65f4577ab2 100644 --- a/qpid/cpp/SSL +++ b/qpid/cpp/SSL @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + Using SSL ========= diff --git a/qpid/cpp/cmake_uninstall.cmake.in b/qpid/cpp/cmake_uninstall.cmake.in index c6d809418e..02244f32e7 100644 --- a/qpid/cpp/cmake_uninstall.cmake.in +++ b/qpid/cpp/cmake_uninstall.cmake.in @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + if (NOT EXISTS "@CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt") message(FATAL_ERROR "Cannot find install manifest: \"@CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt\"") endif(NOT EXISTS "@CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt") diff --git a/qpid/cpp/design_docs/ha-transactions.md b/qpid/cpp/design_docs/ha-transactions.md index ab4b1c6925..bfa5456a2c 100644 --- a/qpid/cpp/design_docs/ha-transactions.md +++ b/qpid/cpp/design_docs/ha-transactions.md @@ -1,3 +1,22 @@ + + # Design note: HA with Transactions. Clients can use transactions (TX or DTX) with the current HA module but: diff --git a/qpid/cpp/design_docs/log-model-category-for-correlation.txt b/qpid/cpp/design_docs/log-model-category-for-correlation.txt index 69253a417a..280f53bb9d 100644 --- a/qpid/cpp/design_docs/log-model-category-for-correlation.txt +++ b/qpid/cpp/design_docs/log-model-category-for-correlation.txt @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + This documennt describes the new logging entries written for "QPID-4079 C++ Broker needs log messages to track object life cycles for auditing". diff --git a/qpid/cpp/design_docs/windows_clfs_store_design.txt b/qpid/cpp/design_docs/windows_clfs_store_design.txt index 76ae419b40..944d957083 100644 --- a/qpid/cpp/design_docs/windows_clfs_store_design.txt +++ b/qpid/cpp/design_docs/windows_clfs_store_design.txt @@ -1,3 +1,22 @@ +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# + Design for Hybrid SQL/CLFS-Based Store in Qpid ============================================== diff --git a/qpid/cpp/docs/man/generate_manpage b/qpid/cpp/docs/man/generate_manpage index 2fe57250be..2d6c1461ba 100755 --- a/qpid/cpp/docs/man/generate_manpage +++ b/qpid/cpp/docs/man/generate_manpage @@ -17,7 +17,10 @@ # specific language governing permissions and limitations # under the License. # -$2 --help | grep -v 'Usage: ' | sed -f $(dirname $0)/groffify_options.sed > .temp.options.groff + +test -n "$3" || { echo "Usage: $0 "; exit 1; } + +$2 --help --no-module-dir | grep -v 'Usage: ' | sed -f $(dirname $0)/groffify_options.sed > .temp.options.groff cat $1 | sed -f $(dirname $0)/groffify_template.sed | sed -e '/^\.PP$/ r .temp.options.groff' -e "/^.SH NAME/ i\ .TH QPIDD \"1\" \"$(date +'%B %Y')\" \"$($2 -v)\" \"User Commands\" " > $3 diff --git a/qpid/cpp/docs/man/qpidd.1 b/qpid/cpp/docs/man/qpidd.1 index d2cff454cf..f48712fad8 100644 --- a/qpid/cpp/docs/man/qpidd.1 +++ b/qpid/cpp/docs/man/qpidd.1 @@ -1,230 +1,369 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.38.2. -.TH QPIDD "1" "March 2011" "qpidd (qpidc) version 0.11" "User Commands" +.\" +.\" Licensed to the Apache Software Foundation (ASF) under one +.\" or more contributor license agreements. See the NOTICE file +.\" distributed with this work for additional information +.\" regarding copyright ownership. The ASF licenses this file +.\" to you under the Apache License, Version 2.0 (the +.\" "License"); you may not use this file except in compliance +.\" with the License. You may obtain a copy of the License at +.\" +.\" http://www.apache.org/licenses/LICENSE-2.0 +.\" +.\" Unless required by applicable law or agreed to in writing, +.\" software distributed under the License is distributed on an +.\" "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.\" KIND, either express or implied. See the License for the +.\" specific language governing permissions and limitations +.\" under the License. +.\" + +.TH QPIDD "1" "December 2013" "qpidd (qpid-cpp) version 0.27" "User Commands" .SH NAME qpidd \- the Qpid AMQP Message Broker Daemon + .SH SYNOPSIS qpidd [-p port] [--config config_file] [--data-dir directory] + .SH DESCRIPTION An AMQP message broker daemon that stores, routes and forwards messages using the Advanced Message Queueing Protocol (AMQP). + .SH OPTIONS The options below are built-in to qpidd. Installing add-on modules provides additional options. To see the full set of options available type "qpidd --help" Options may be specified via command line, environment variable or configuration file. See FILES and ENVIRONMENT below for details. + .PP +.SS Options + .TP -\fB\-h\fR [ \fB\-\-help\fR ] +\-h [ \-\-help ] Displays the help message .TP -\fB\-v\fR [ \fB\-\-version\fR ] +\-v [ \-\-version ] Displays version information .TP -\fB\-\-config\fR FILE +\-\-config FILE (/etc/qpid/qpidd.conf) Reads configuration from FILE -.SS "Module options:" -.TP -\fB\-\-module\-dir\fR DIR -Load all shareable modules in this +\-\-client\-config FILE (/etc/qpid/qpidc.conf) +Reads client configuration from FILE +(for cluster interconnect) + +.SS Module options +\-\-module\-dir DIR (/usr/lib64/qpid/daemon) +Load all shareable modules in this directory .TP -\fB\-\-load\-module\fR FILE -Specifies additional module(s) to be +\-\-load\-module FILE +Specifies additional module(s) to be loaded .TP -\fB\-\-no\-module\-dir\fR -Don't load modules from module +\-\-no\-module\-dir +Don't load modules from module directory -.SS "Broker Options:" -.TP -\fB\-\-data\-dir\fR DIR -Directory to contain persistent data + +.SS Broker Options +\-\-data\-dir DIR (/home/aconway/.qpidd) +Directory to contain persistent data generated by the broker .TP -\fB\-\-no\-data\-dir\fR -Don't use a data directory. No +\-\-no\-data\-dir +Don't use a data directory. No persistent configuration will be loaded or stored .TP -\fB\-p\fR [ \fB\-\-port\fR ] PORT (5672) +\-\-paging\-dir DIR +Directory in which paging files will be +created for paged queues +.TP +\-p [ \-\-port ] PORT (5672) Tells the broker to listen on PORT +\-\-interface | +Which network interfaces to use to +listen for incoming connections +\-\-listen\-disable Transports to disable listening .TP -\fB\-\-worker\-threads\fR N (3) +\-\-worker\-threads N (5) Sets the broker thread pool size .TP -\fB\-\-max\-connections\fR N (500) -Sets the maximum allowed connections -.TP -\fB\-\-connection\-backlog\fR N (10) -Sets the connection backlog limit for +\-\-connection\-backlog N (10) +Sets the connection backlog limit for the server socket .TP -\fB\-m\fR [ \fB\-\-mgmt\-enable\fR ] yes|no (1) +\-m [ \-\-mgmt\-enable ] yes|no (1) Enable Management .TP -\fB\-\-mgmt\-qmf2\fR yes|no (1) -Enable broadcast of management +\-\-mgmt\-publish yes|no (1) +Enable Publish of Management Data (\&'no' +implies query\-only) +.TP +\-\-mgmt\-qmf2 yes|no (1) +Enable broadcast of management information over QMF v2 .TP -\fB\-\-mgmt\-qmf1\fR yes|no (1) -Enable broadcast of management +\-\-mgmt\-qmf1 yes|no (0) +Enable broadcast of management information over QMF v1 .TP -\fB\-\-mgmt\-pub\-interval\fR SECONDS (10) +\-\-mgmt\-pub\-interval SECONDS (10s) Management Publish Interval -.TP -\fB\-\-queue\-purge\-interval\fR SECONDS (600) -Interval between attempts to purge any +\-\-queue\-purge\-interval SECONDS (600s) +Interval between attempts to purge any expired messages from queues .TP -\fB\-\-auth\fR yes|no (1) -Enable authentication, if disabled all +\-\-auth yes|no (1) +Enable authentication, if disabled all incoming connections will be trusted .TP -\fB\-\-realm\fR REALM (QPID) -Use the given realm when performing +\-\-realm REALM (QPID) +Use the given realm when performing authentication -.TP -\fB\-\-default\-queue\-limit\fR BYTES (104857600) -Default maximum size for queues (in +\-\-default\-queue\-limit BYTES (104857600) +Default maximum size for queues (in bytes) .TP -\fB\-\-tcp\-nodelay\fR +\-\-tcp\-nodelay Set TCP_NODELAY on TCP connections .TP -\fB\-\-require\-encryption\fR -Only accept connections that are +\-\-require\-encryption +Only accept connections that are encrypted -.TP -\fB\-\-known\-hosts\-url\fR URL or 'none' -URL to send as 'known\-hosts' to clients -('none' implies empty list) -.TP -\fB\-\-sasl\-config\fR DIR -gets sasl config info from nonstandard -location -.TP -\fB\-\-max\-session\-rate\fR MESSAGES/S (0) -Sets the maximum message rate per -session (0=unlimited) -.TP -\fB\-\-async\-queue\-events\fR yes|no (0) -Set Queue Events async, used for -services like replication -.TP -\fB\-\-default\-flow\-stop\-threshold\fR PERCENT (80) -Percent of queue's maximum capacity at +\-\-known\-hosts\-url URL or \&'none' (none) +URL to send as \&'known\-hosts' to clients +(\&'none' implies empty list) +.TP +\-\-sasl\-config DIR +Allows SASL config path, if supported +by platform, to be overridden. For +default location on Linux, see Cyrus +SASL documentation. There is no SASL +config dir on Windows. +\-\-default\-flow\-stop\-threshold PERCENT (80) +Percent of queue's maximum capacity at which flow control is activated. -.TP -\fB\-\-default\-flow\-resume\-threshold\fR PERCENT (70) -Percent of queue's maximum capacity at +\-\-default\-flow\-resume\-threshold PERCENT (70) +Percent of queue's maximum capacity at which flow control is de\-activated. -.TP -\fB\-\-default\-event\-threshold\-ratio\fR %age of limit (80) -The ratio of any specified queue limit +\-\-default\-event\-threshold\-ratio %age of limit (80) +The ratio of any specified queue limit at which an event will be raised -.SS "Logging options:" +\-\-default\-message\-group GROUP\-IDENTIFER (qpid.no\-group) +Group identifier to assign to messages +delivered to a message group queue that +do not contain an identifier. +.TP +\-\-enable\-timestamp yes|no (0) +Add current time to each received +message. +\-\-link\-maintenance\-interval SECONDS (2s) +Interval to check link health and +.TP + re\-connect +if need be +\-\-link\-heartbeat\-interval SECONDS (120s) +Heartbeat interval for a federation +link +\-\-max\-negotiate\-time MILLISECONDS (10000) +Maximum time a connection can take to +send the initial protocol negotiation +.TP +\-\-federation\-tag NAME +Override the federation tag + +.SS Logging options .TP -\fB\-t\fR [ \fB\-\-trace\fR ] +\-t [ \-\-trace ] Enables all logging .TP -\fB\-\-log\-enable\fR RULE (notice+) +\-\-log\-enable RULE (notice+) Enables logging for selected levels and -components. RULE is in the form -\&'LEVEL[+][:PATTERN]' Levels are one of: -.IP -trace debug info notice warning error -.IP +components. RULE is in the form +\&'LEVEL[+\-][:PATTERN]' +LEVEL is one of: +trace debug info notice warning error +critical +PATTERN is a logging category name, or +a namespace\-qualified function name or +name fragment. Logging category names +are: +Security Broker Management Protocol +System HA Messaging Store Network Test +Client Model Unspecified +For example: +\&'\-\-log\-enable warning+' +logs all warning, error and critical +messages. +\&'\-\-log\-enable trace+:Broker' +logs all category \&'Broker' messages. +\&'\-\-log\-enable debug:framing' +logs debug messages from all functions +with \&'framing' in the namespace or +function name. +This option can be used multiple times +.TP +\-\-log\-disable RULE +Disables logging for selected levels +and components. RULE is in the form +\&'LEVEL[+\-][:PATTERN]' +LEVEL is one of: +trace debug info notice warning error critical +PATTERN is a logging category name, or +a namespace\-qualified function name or +name fragment. Logging category names +are: +Security Broker Management Protocol +System HA Messaging Store Network Test +Client Model Unspecified For example: -\&'\-\-log\-enable warning+' logs all -warning, error and critical messages. -\&'\-\-log\-enable debug:framing' logs debug -messages from the framing namespace. +\&'\-\-log\-disable warning\-' +disables logging all warning, notice, +info, debug, and trace messages. +\&'\-\-log\-disable trace:Broker' +disables all category \&'Broker' trace +messages. +\&'\-\-log\-disable debug\-:qmf::' +disables logging debug and trace +messages from all functions with +\&'qmf::' in the namespace. This option can be used multiple times .TP -\fB\-\-log\-time\fR yes|no (1) +\-\-log\-time yes|no (1) Include time in log messages .TP -\fB\-\-log\-level\fR yes|no (1) +\-\-log\-level yes|no (1) Include severity level in log messages .TP -\fB\-\-log\-source\fR yes|no (0) -Include source file:line in log +\-\-log\-source yes|no (0) +Include source file:line in log messages .TP -\fB\-\-log\-thread\fR yes|no (0) +\-\-log\-thread yes|no (0) Include thread ID in log messages .TP -\fB\-\-log\-function\fR yes|no (0) -Include function signature in log +\-\-log\-function yes|no (0) +Include function signature in log messages .TP -\fB\-\-log\-prefix\fR STRING -Prefix to append to all log messages -.SS "Logging sink options:" +\-\-log\-hires\-timestamp yes|no (0) +Use hi\-resolution timestamps in log +messages +.TP +\-\-log\-category yes|no (1) +Include category in log messages .TP -\fB\-\-log\-to\-stderr\fR yes|no (1) +\-\-log\-prefix STRING +Prefix to prepend to all log messages + +.SS Logging sink options +.TP +\-\-log\-to\-stderr yes|no (1) Send logging output to stderr .TP -\fB\-\-log\-to\-stdout\fR yes|no (0) +\-\-log\-to\-stdout yes|no (0) Send logging output to stdout .TP -\fB\-\-log\-to\-file\fR FILE +\-\-log\-to\-file FILE Send log output to FILE. .TP -\fB\-\-log\-to\-syslog\fR yes|no (0) +\-\-log\-to\-syslog yes|no (0) Send logging output to syslog; -customize using \fB\-\-syslog\-name\fR and -\fB\-\-syslog\-facility\fR +customize using \-\-syslog\-name and +\-\-syslog\-facility .TP -\fB\-\-syslog\-name\fR NAME (lt\-qpidd) +\-\-syslog\-name NAME (qpidd) Name to use in syslog messages -.TP -\fB\-\-syslog\-facility\fR LOG_XXX (LOG_DAEMON) +\-\-syslog\-facility LOG_XXX (LOG_DAEMON) Facility to use in syslog messages -.SS "Daemon options:" + +.SS Daemon options .TP -\fB\-d\fR [ \fB\-\-daemon\fR ] -Run as a daemon. Logs to syslog by +\-d [ \-\-daemon ] +Run as a daemon. Logs to syslog by default in this mode. .TP -\fB\-\-transport\fR TRANSPORT (tcp) -The transport for which to return the +\-\-transport TRANSPORT (tcp) +The transport for which to return the port .TP -\fB\-\-pid\-dir\fR DIR -Directory where port\-specific PID file +\-\-pid\-dir DIR (/home/aconway/.qpidd) +Directory where port\-specific PID file is stored .TP -\fB\-w\fR [ \fB\-\-wait\fR ] SECONDS (600) -Sets the maximum wait time to -initialize the daemon. If the daemon -fails to initialize, prints an error -and returns 1 +\-w [ \-\-wait ] SECONDS (600) +Sets the maximum wait time to +initialize or shutdown the daemon. If +the daemon fails to initialize/shutdown +, prints an error and returns 1 .TP -\fB\-c\fR [ \fB\-\-check\fR ] -Prints the daemon's process ID to -stdout and returns 0 if the daemon is +\-c [ \-\-check ] +Prints the daemon's process ID to +stdout and returns 0 if the daemon is running, otherwise returns 1 .TP -\fB\-q\fR [ \fB\-\-quit\fR ] +\-q [ \-\-quit ] Tells the daemon to shut down -.SH ENVIRONMENT -.I QPID_