1    /* --COPYRIGHT--,ESD
     2     *  Copyright (c) 2008 Texas Instruments. All rights reserved. 
     3     *  This program and the accompanying materials are made available under the 
     4     *  terms of the Eclipse Public License v1.0 and Eclipse Distribution License
     5     *  v. 1.0 which accompanies this distribution. The Eclipse Public License is
     6     *  available at http://www.eclipse.org/legal/epl-v10.html and the Eclipse
     7     *  Distribution License is available at 
     8     *  http://www.eclipse.org/org/documents/edl-v10.php.
     9     *
    10     *  Contributors:
    11     *      Texas Instruments - initial implementation
    12     * --/COPYRIGHT--*/
    13    /*
    14     *  ======== Timestamp.xdc ========
    15     *
    16     *! Revision History
    17     *! ================
    18     *! 11-Mar-2008 agd     xdc runtime review changes
    19     *! 14-Dec-2007 sasa    started revision history
    20     */
    21    
    22    package xdc.runtime;
    23    
    24    /*!
    25     *  ======== Timestamp ========
    26     *  Timestamp services
    27     *  
    28     *  This module provides `{@link xdc.runtime.ITimestampClient}` APIs for 
    29     *  the xdc Runtime Support Library. Calls to these APIs are forwarded
    30     *  to a platform specific `{@link xdc.runtime.ITimestampProvider}` 
    31     *  implementation.
    32     *
    33     *  A user can attach their own ITimestampProvider module
    34     *  using the following config file command:
    35     *  @p(code)
    36     *
    37     *  xdc.runtime.Timestamp.SupportProxy = xdc.useModule("usersTimestampProvider");
    38     *  @p
    39     *  If no such `{@link #SupportProxy SupportProxy}` initialization is done, 
    40     *  the `{@link xdc.runtime.TimestampNull}` ITimestampProvider implementation,
    41     *  which provides null stubs for the APIs, will be attached by default.
    42     *
    43     *  If the user is developing code using CCS, the 
    44     *  `{@link xdc.runtime.TimestampStd}`
    45     *  ITimestampProvider implementation, which uses the ANSI C clock() 
    46     *  function, may provide a satisfactory timestamp source (remember to 
    47     *  enable the profile clock in CCS). 
    48     *
    49     *  To use the TimestampStd implementation, add the following to 
    50     *  your config script:
    51     *  @p(code)
    52     *
    53     *  xdc.runtime.Timestamp.SupportProxy = xdc.useModule("xdc.runtime.TimestampStd");
    54     *  @p
    55     */
    56    module Timestamp inherits ITimestampClient {
    57    
    58        /*!
    59         *  ======== SupportProxy ========
    60         *  User supplied time stamp provider module.
    61         *
    62         *  The SupportProxy module provides application/platform
    63         *  specific implementations of the 
    64         *  `{@link xdc.runtime.ITimestampProvider}` APIs.
    65         *
    66         *  If not explicitly supplied by the user, this proxy defaults to
    67         *  `{@link xdc.runtime.TimestampNull}`, 
    68         *  which provides null stubs for all of the ITimestampProvider APIs.
    69         */
    70        proxy SupportProxy inherits ITimestampProvider;
    71    }
    72    /*
    73     *  @(#) xdc.runtime; 2, 0, 0, 0,214; 7-29-2009 14:53:45; /db/ztree/library/trees/xdc-t56x/src/packages/
    74     */
    75