X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fsample_app_ug%2Ftimer.rst;h=98d762d2388c551512bed7281a016a48b0ededf2;hb=483a914d24a01683c8c450a6314109b7f6d35568;hp=bdd57d947fb434e02ce6116c9126a304dabf5e35;hpb=d0dff9ba445e47199a420dd4b5451ec2860d3d3b;p=dpdk.git diff --git a/doc/guides/sample_app_ug/timer.rst b/doc/guides/sample_app_ug/timer.rst index bdd57d947f..98d762d238 100644 --- a/doc/guides/sample_app_ug/timer.rst +++ b/doc/guides/sample_app_ug/timer.rst @@ -1,72 +1,29 @@ -.. BSD LICENSE - Copyright(c) 2010-2014 Intel Corporation. All rights reserved. - All rights reserved. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions - are met: - - * Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - * Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in - the documentation and/or other materials provided with the - distribution. - * Neither the name of Intel Corporation nor the names of its - contributors may be used to endorse or promote products derived - from this software without specific prior written permission. - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2010-2014 Intel Corporation. Timer Sample Application ======================== -The Timer sample application is a simple application that demonstrates the use of a timer in an Intel® DPDK application. +The Timer sample application is a simple application that demonstrates the use of a timer in a DPDK application. This application prints some messages from different lcores regularly, demonstrating the use of timers. Compiling the Application ------------------------- -#. Go to the example directory: +To compile the sample application see :doc:`compiling`. - .. code-block:: console - - export RTE_SDK=/path/to/rte_sdk cd ${RTE_SDK}/examples/timer - -#. Set the target (a default target is used if not specified). For example: - - .. code-block:: console - - export RTE_TARGET=x86_64-native-linuxapp-gcc - - See the *Intel® DPDK Getting Started Guide* for possible *RTE_TARGET* values. - -#. Build the application: - - .. code-block:: console - - make +The application is located in the ``timer`` sub-directory. Running the Application ----------------------- -To run the example in linuxapp environment: +To run the example in linux environment: .. code-block:: console - $ ./build/timer -c f -n 4 + $ ./build/timer -l 0-3 -n 4 -Refer to the *Intel® DPDK Getting Started Guide* for general information on running applications and +Refer to the *DPDK Getting Started Guide* for general information on running applications and the Environment Abstraction Layer (EAL) options. Explanation @@ -114,7 +71,7 @@ The main loop is very simple in this example: /* * Call the timer handler on each core: as we don't * need a very precise timer, so only call - * rte_timer_manage() every ~10ms (at 2 Ghz). In a real + * rte_timer_manage() every ~10ms (at 2 GHz). In a real * application, this will enhance performances as * reading the HPET timer is not efficient. */ @@ -180,7 +137,7 @@ In this case, the timer is stopped using the rte_timer_stop() function. /* timer0 callback */ static void - timer0_cb( attribute ((unused)) struct rte_timer *tim, __attribute ((unused)) void *arg) + timer0_cb(__rte_unused struct rte_timer *tim, __rte_unused void *arg) { static unsigned counter = 0; @@ -202,7 +159,7 @@ rte_timer_reset() function: /* timer1 callback */ static void - timer1_cb( attribute ((unused)) struct rte_timer *tim, _attribute ((unused)) void *arg) + timer1_cb(__rte_unused struct rte_timer *tim, __rte_unused void *arg) { unsigned lcore_id = rte_lcore_id(); uint64_t hz;