1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2 * vim:expandtab:shiftwidth=8:tabstop=8:
6 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 only,
10 * as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License version 2 for more details (a copy is included
16 * in the LICENSE file that accompanied this code).
18 * You should have received a copy of the GNU General Public License
19 * version 2 along with this program; If not, see
20 * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
22 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
23 * CA 95054 USA or visit www.sun.com if you need additional information or
29 * Copyright 2008 Sun Microsystems, Inc. All rights reserved
30 * Use is subject to license terms.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
36 * libcfs/include/libcfs/user-time.h
38 * Implementation of portable time API for user-level.
40 * Author: Nikita Danilov <nikita@clusterfs.com>
43 #ifndef __LIBCFS_USER_TIME_H__
44 #define __LIBCFS_USER_TIME_H__
46 #ifndef __LIBCFS_LIBCFS_H__
47 #error Do not #include this file directly. #include <libcfs/libcfs.h> instead
50 /* Portable time API */
53 * Platform provides three opaque data-types:
55 * cfs_time_t represents point in time. This is internal kernel
56 * time rather than "wall clock". This time bears no
57 * relation to gettimeofday().
59 * cfs_duration_t represents time interval with resolution of internal
62 * cfs_fs_time_t represents instance in world-visible time. This is
63 * used in file-system time-stamps
65 * cfs_time_t cfs_time_current(void);
66 * cfs_time_t cfs_time_add (cfs_time_t, cfs_duration_t);
67 * cfs_duration_t cfs_time_sub (cfs_time_t, cfs_time_t);
68 * int cfs_time_before (cfs_time_t, cfs_time_t);
69 * int cfs_time_beforeq(cfs_time_t, cfs_time_t);
71 * cfs_duration_t cfs_duration_build(int64_t);
73 * time_t cfs_duration_sec (cfs_duration_t);
74 * void cfs_duration_usec(cfs_duration_t, struct timeval *);
75 * void cfs_duration_nsec(cfs_duration_t, struct timespec *);
77 * void cfs_fs_time_current(cfs_fs_time_t *);
78 * time_t cfs_fs_time_sec (cfs_fs_time_t *);
79 * void cfs_fs_time_usec (cfs_fs_time_t *, struct timeval *);
80 * void cfs_fs_time_nsec (cfs_fs_time_t *, struct timespec *);
81 * int cfs_fs_time_before (cfs_fs_time_t *, cfs_fs_time_t *);
82 * int cfs_fs_time_beforeq(cfs_fs_time_t *, cfs_fs_time_t *);
91 #define ONE_BILLION ((u_int64_t)1000000000)
92 #define ONE_MILLION 1000000
95 * Liblustre. time(2) based implementation.
98 typedef time_t cfs_fs_time_t;
99 typedef time_t cfs_time_t;
100 typedef time_t cfs_duration_t;
102 /* looks like linux */
103 #define time_after(a, b) ((long)(b) - (long)(a) < 0)
104 #define time_before(a, b) time_after(b,a)
105 #define time_after_eq(a,b) ((long)(a) - (long)(b) >= 0)
106 #define time_before_eq(a,b) time_after_eq(b,a)
108 static inline cfs_time_t cfs_time_current(void)
113 static inline cfs_duration_t cfs_time_seconds(cfs_time_t seconds)
118 static inline time_t cfs_time_current_sec(void)
120 return cfs_time_seconds(cfs_time_current());
123 static inline cfs_duration_t cfs_duration_build(int64_t nano)
125 return (cfs_duration_t) (nano / ONE_BILLION);
128 static inline time_t cfs_duration_sec(cfs_duration_t d)
133 static inline void cfs_duration_usec(cfs_duration_t d, struct timeval *s)
139 static inline void cfs_duration_nsec(cfs_duration_t d, struct timespec *s)
145 static inline void cfs_fs_time_current(cfs_fs_time_t *t)
150 static inline time_t cfs_fs_time_sec(cfs_fs_time_t *t)
155 static inline void cfs_fs_time_usec(cfs_fs_time_t *t, struct timeval *v)
161 static inline void cfs_fs_time_nsec(cfs_fs_time_t *t, struct timespec *s)
167 static inline int cfs_fs_time_before(cfs_fs_time_t *t1, cfs_fs_time_t *t2)
172 static inline int cfs_fs_time_beforeq(cfs_fs_time_t *t1, cfs_fs_time_t *t2)
179 #define cfs_time_current_64 cfs_time_current
180 #define cfs_time_add_64 cfs_time_add
181 #define cfs_time_shift_64 cfs_time_shift
182 #define cfs_time_before_64 cfs_time_before
183 #define cfs_time_beforeq_64 cfs_time_beforeq
185 /* XXX needs to move to arch specific header or configured */
187 #define CFS_TIME_T "%lu"
190 #define CFS_DURATION_T "%ld"
195 /* __LIBCFS_USER_TIME_H__ */
199 * c-indentation-style: "K&R"