1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/* -*- C++ -*- */
//=============================================================================
/**
* @file FILE.h
*
* @author Gerhard Lenzer
*/
//=============================================================================
#ifndef ACE_FILE_H
#define ACE_FILE_H
#include /**/ "ace/pre.h"
#include "ace/IO_SAP.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "ace/FILE_Addr.h"
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
/**
* @class ACE_FILE_Info
*
* @brief Abstracts basic OS FILE information.
*/
class ACE_Export ACE_FILE_Info
{
public:
/// Mode of file
mode_t mode_;
/// No of links
nlink_t nlink_;
/// Size of file
ACE_OFF_T size_;
};
/**
* @class ACE_FILE
*
* @brief Defines the core methods of the ACE_FILE abstraction.
*/
class ACE_Export ACE_FILE : public ACE_IO_SAP
{
public:
/// Close the ACE_FILE handle without removing the ACE_FILE from
/// the file system.
int close (void);
/// Close and remove the ACE_FILE from the file system.
int remove (void);
/// Remove the ACE_FILE from the file system without closing the
/// ACE_FILE handle.
int unlink (void);
/// Get information on this ACE_FILE.
int get_info (ACE_FILE_Info *finfo);
/// Get information on this ACE_FILE.
int get_info (ACE_FILE_Info &finfo);
/// Set filesize to length byte.
int truncate (ACE_OFF_T length);
/**
* Sets the file pointer as follows:
* o If @ whence is @c SEEK_SET, the pointer is set to @a offset
* bytes.
*
* o If @a whence> is @c SEEK_CUR, the pointer is set to its
* current location plus @a offset.
*
* o If @a whence is @c SEEK_END, the pointer is set to the size
* of the file plus offset.
*/
ACE_OFF_T seek (ACE_OFF_T offset,
int whence = SEEK_CUR);
/// Return an offset for the file handle.
ACE_OFF_T tell (void);
/**
* Disable signal @a signum
* This is here to prevent Win32 from
* disabling SPIPE using socket calls
*/
int disable (int signum) const ;
/// Return the local endpoint address in the referenced ACE_Addr.
/// Returns 0 if successful, else -1.
int get_local_addr (ACE_Addr &) const;
/// Return the same thing as get_local_addr().
int get_remote_addr (ACE_Addr &) const;
/// Dump the state of an object.
void dump (void) const;
/// Declare the dynamic allocation hooks.
ACE_ALLOC_HOOK_DECLARE;
protected:
/// Ensure that this class is only created by the
/// ACE_FILE_Connector.
ACE_FILE (void);
/// File we are "connected" with...
ACE_FILE_Addr addr_;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#if defined (__ACE_INLINE__)
#include "ace/FILE.inl"
#endif /* __ACE_INLINE__ */
#include /**/ "ace/post.h"
#endif /* ACE_FILE_H */
|
