GCC Code Coverage Report
Directory: ./ Exec Total Coverage
File: fx_file_date_time_set.c Lines: 15 15 100.0 %
Date: 2024-03-11 05:15:45 Branches: 4 4 100.0 %

Line Branch Exec Source
1
/***************************************************************************
2
 * Copyright (c) 2024 Microsoft Corporation
3
 *
4
 * This program and the accompanying materials are made available under the
5
 * terms of the MIT License which is available at
6
 * https://opensource.org/licenses/MIT.
7
 *
8
 * SPDX-License-Identifier: MIT
9
 **************************************************************************/
10
11
12
/**************************************************************************/
13
/**************************************************************************/
14
/**                                                                       */
15
/** FileX Component                                                       */
16
/**                                                                       */
17
/**   File                                                                */
18
/**                                                                       */
19
/**************************************************************************/
20
/**************************************************************************/
21
22
#define FX_SOURCE_CODE
23
24
25
/* Include necessary system files.  */
26
27
#include "fx_api.h"
28
#include "fx_directory.h"
29
#include "fx_file.h"
30
31
32
/**************************************************************************/
33
/*                                                                        */
34
/*  FUNCTION                                               RELEASE        */
35
/*                                                                        */
36
/*    _fx_file_date_time_set                              PORTABLE C      */
37
/*                                                           6.1          */
38
/*  AUTHOR                                                                */
39
/*                                                                        */
40
/*    William E. Lamie, Microsoft Corporation                             */
41
/*                                                                        */
42
/*  DESCRIPTION                                                           */
43
/*                                                                        */
44
/*    This function sets the specified file's date and time with the      */
45
/*    values provided.                                                    */
46
/*                                                                        */
47
/*  INPUT                                                                 */
48
/*                                                                        */
49
/*    media_ptr                             Media control block pointer   */
50
/*    file_name                             File name pointer             */
51
/*    year                                  Year                          */
52
/*    month                                 Month                         */
53
/*    day                                   Day                           */
54
/*    hour                                  Hour                          */
55
/*    minute                                Minute                        */
56
/*    second                                Second                        */
57
/*                                                                        */
58
/*  OUTPUT                                                                */
59
/*                                                                        */
60
/*    return status                                                       */
61
/*                                                                        */
62
/*  CALLS                                                                 */
63
/*                                                                        */
64
/*    _fx_directory_search                  Search for the file name in   */
65
/*                                          the directory structure       */
66
/*    _fx_directory_entry_write             Write the directory entry     */
67
/*                                                                        */
68
/*  CALLED BY                                                             */
69
/*                                                                        */
70
/*    Application Code                                                    */
71
/*                                                                        */
72
/*  RELEASE HISTORY                                                       */
73
/*                                                                        */
74
/*    DATE              NAME                      DESCRIPTION             */
75
/*                                                                        */
76
/*  05-19-2020     William E. Lamie         Initial Version 6.0           */
77
/*  09-30-2020     William E. Lamie         Modified comment(s),          */
78
/*                                            resulting in version 6.1    */
79
/*                                                                        */
80
/**************************************************************************/
81
15
UINT  _fx_file_date_time_set(FX_MEDIA *media_ptr, CHAR *file_name,
82
                             UINT year, UINT month, UINT day, UINT hour, UINT minute, UINT second)
83
{
84
85
UINT         status;
86
FX_DIR_ENTRY dir_entry;
87
88
89
    /* Setup pointer to media name buffer.  */
90
15
    dir_entry.fx_dir_entry_name =  media_ptr -> fx_media_name_buffer + FX_MAX_LONG_NAME_LEN;
91
92
    /* Clear the short name string.  */
93
15
    dir_entry.fx_dir_entry_short_name[0] =  0;
94
95
    /* Check the media to make sure it is open.  */
96
15
    if (media_ptr -> fx_media_id != FX_MEDIA_ID)
97
    {
98
99
        /* Return the media not opened error.  */
100
1
        return(FX_MEDIA_NOT_OPEN);
101
    }
102
103
    /* If trace is enabled, insert this event into the trace buffer.  */
104
    FX_TRACE_IN_LINE_INSERT(FX_TRACE_FILE_DATE_TIME_SET, media_ptr, file_name, year, month, FX_TRACE_FILE_EVENTS, 0, 0)
105
106
    /* Protect against other threads accessing the media.  */
107
14
    FX_PROTECT
108
109
    /* Search the system for the supplied directory name.  */
110
14
    status =  _fx_directory_search(media_ptr, file_name, &dir_entry, FX_NULL, FX_NULL);
111
112
    /* Determine if the search was successful.  */
113
14
    if (status != FX_SUCCESS)
114
    {
115
116
        /* Release media protection.  */
117
1
        FX_UNPROTECT
118
119
        /* Return the error code.  */
120
1
        return(status);
121
    }
122
123
    /* Set the new time and date.  */
124
13
    dir_entry.fx_dir_entry_time =  (hour << FX_HOUR_SHIFT) | (minute << FX_MINUTE_SHIFT) | (second / 2);
125
13
    dir_entry.fx_dir_entry_date =  ((year - FX_BASE_YEAR) << FX_YEAR_SHIFT) | (month << FX_MONTH_SHIFT) | day;
126
127
    /* Write the directory entry to the media.  */
128
13
    status = _fx_directory_entry_write(media_ptr, &dir_entry);
129
130
    /* Release media protection.  */
131
13
    FX_UNPROTECT
132
133
    /* Directory information write is complete, return status.  */
134
13
    return(status);
135
}
136