1    /* 
     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     * */
    13    /*
    14     *  ======== Timestamp.xdc ========
    15     */
    16    
    17    package xdc.runtime;
    18    
    19    /*!
    20     *  ======== Timestamp ========
    21     *  Timestamp services
    22     *
    23     *  This module provides `{@link xdc.runtime.ITimestampClient}` APIs for
    24     *  the xdc Runtime Support Library. Calls to these APIs are forwarded
    25     *  to a platform specific `{@link xdc.runtime.ITimestampProvider}`
    26     *  implementation.
    27     *
    28     *  A user can attach their own ITimestampProvider module
    29     *  using the following config file command:
    30     *  @p(code)
    31     *
    32     *  xdc.runtime.Timestamp.SupportProxy = xdc.useModule("usersTimestampProvider");
    33     *  @p
    34     *  If no such `{@link #SupportProxy SupportProxy}` initialization is done,
    35     *  the `{@link xdc.runtime.TimestampNull}` ITimestampProvider implementation,
    36     *  which provides null stubs for the APIs, will be attached by default.
    37     *
    38     *  If the user is developing code using CCS, the
    39     *  `{@link xdc.runtime.TimestampStd}`
    40     *  ITimestampProvider implementation, which uses the ANSI C clock()
    41     *  function, may provide a satisfactory timestamp source (remember to
    42     *  enable the profile clock in CCS).
    43     *
    44     *  To use the TimestampStd implementation, add the following to
    45     *  your config script:
    46     *  @p(code)
    47     *
    48     *  xdc.runtime.Timestamp.SupportProxy = xdc.useModule("xdc.runtime.TimestampStd");
    49     *  @p
    50     */
    51    module Timestamp inherits ITimestampClient {
    52    
    53        /*!
    54         *  ======== SupportProxy ========
    55         *  User supplied time stamp provider module.
    56         *
    57         *  The SupportProxy module provides application/platform
    58         *  specific implementations of the 
    59         *  `{@link xdc.runtime.ITimestampProvider}` APIs.
    60         *
    61         *  If not explicitly supplied by the user, this proxy defaults to
    62         *  `{@link xdc.runtime.TimestampNull}`, 
    63         *  which provides null stubs for all of the ITimestampProvider APIs.
    64         */
    65        proxy SupportProxy inherits ITimestampProvider;
    66    }
    67    /*
    68     *  @(#) xdc.runtime; 2, 1, 0,0; 5-8-2019 15:48:09; /db/ztree/library/trees/xdc/xdc-G16/src/packages/
    69     */
    70