glxshell.utilities.touch module¶

glxshell.utilities.touch.glxsh_touch(a=None, c=None, d=None, m=None, r=None, t=None, files=None)[source]¶

The glxsh_touch function shall change the last data modification timestamps, the last data access timestamps, or both.

The time used can be specified by the time option-argument, the corresponding time fields of the file referenced by the -r ref_file option-argument, or the -d date_time option-argument, as specified in the following sections.

If none of these are specified, touch shall use the current time

date_time format:

YYYY-MM-DDThh:mm:SS[.frac][tz] or YYYY-MM-DDThh:mm:SS[,frac][tz]

where:

• YYYY are at least four decimal digits giving the year.

• MM, DD, hh, mm, and SS are as with -t time.

• T is the time designator, and can be replaced by a single <space>.

• [.frac] and [,frac] are either empty, or a <period> ( ‘.’ ) or a <comma> ( ‘,’ ) respectively, followed by one or more decimal digits, specifying a fractional second.

• [tz] is either empty, signifying local time, or the letter ‘Z’, signifying UTC. If [tz] is empty, the resulting time shall be affected by the value of the TZ environment variable.

Parameters:

• a (bool) – Change the access time of file. Do not change the modification time unless m is also specified.

• c (bool) – Do not create a specified file if it does not exist. Do not write any diagnostic messages concerning this conditionself.

• d (string) – Use the specified date_time instead of the current time.

• m (bool) – Change the modification time of file. Do not change the access time unless -a is also specifiedself.

• r (string) – Use the corresponding time of the file path named by the value instead of the current time.

• t – Use the specified time instead of the current time.

• files (list) – A pathname of a file whose times shall be modified.

• date_time (string) – Use the specified date_time instead of the current time.

• time (int or float) – Use the specified time instead of the current time.