|
APIs in Category: clock |
API version 1.9 |
clock-get-clock |
These APIs allow for manipulation of timezone and date on the filer. Timezone and date can be set on the filer as well as we can get the current date, timezone and compliance clock time on the filer. |
| clock-get-clock | [top] |
gets current date and time from filer.
Input Name Range Type Description is-compliance-clock boolean
optional
If this is true, then clock for the compliance is returned, otherwise clock for local is returned. Default is false. Output Name Range Type Description local-time -43200..2^31-1 integer
Local date and time of the filer in seconds since Midnight, 1/1/1970. Depending on the time zone and clock settings, this might be negative by up to 12 hours. utc-time 0..2^31-1 integer
Current date and time of the filer in seconds since Midnight, 1/1/1970.
Errno Description EINTERNALERROR ESNAPLOCKNOTLICENSED ECOMPLIANCECLOCKNOTSET
| clock-get-timezone | [top] |
Gets current timezone and timezone file version.
Output Name Range Type Description timezone string
Current timezone name where the storage system is operating. A timezone can have one of the two formats:
- "Using a location string specified in Arthur David Olsen's public domain time zone database. For example, "Americas/New_York" represents most of the Eastern Time Zone.";
- "A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US Eastern Time Zone.";
timezone-UTC string
Current timezone of the storage system in UTC +/-hhmm format. This indicates that the local time zone is hh hours and mm minutes ahead or behind UTC. For example, Central European Time(CET) is +0100 and U.S./Canadian Eastern Standard Time(EST) is -0500. timezone-version string
Version of the time zone database. "YYYY" is the year the data base was released and "v" is the version within that year. "YYYY" will be four decimal digits and "v" will be an ASCII letter starting with "a" and increasing with each version. For example, the second 2007 version is "2007b".
Errno Description ENOTIMEZONESET ENOTIMEZONEVERSION
| clock-set-clock | [top] |
Set current date and time to the specified date and time.
Input Name Range Type Description is-utc-clock boolean
If this is true, then clock is given in UTC (universal time) instead of local time. time -43200..2^31-1 integer
Actual value of the date and time which has to be set as the current date and time on filer. Value will be seconds since Midnight, 1/1/1970. Depending on the time zone and clock settings, this might be negative by up to 12 hours.
Errno Description EINVALIDINPUTERROR EINTERNALERROR ETAKENOVER EDATENOTSETONPARTNER
| clock-set-timezone | [top] |
Set current timezone to the specified timezone.
Input Name Range Type Description timezone string
Name of the timezone value which has to be set as current timezone value. A timezone can have one of the two formats:
- "Using a location string specified in Arthur David Olsen's public domain time zone database. For example, "Americas/New_York" represents most of the Eastern Time Zone.";
- "A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US Eastern Time Zone.";
Errno Description EINVALIDTIMEZONE ETIMEZONEDIFFERENTINRC