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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
|
.Dd January 10, 2017
.Dt liblnk 3
.Os liblnk
.Sh NAME
.Nm liblnk.h
.Nd Library to access the Windows Shortcut File (LNK) format
.Sh LIBRARY
.Lb liblnk
.Sh SYNOPSIS
.In liblnk.h
.Pp
Support functions
.Ft const char *
.Fn liblnk_get_version "void"
.Ft int
.Fn liblnk_get_access_flags_read "void"
.Ft int
.Fn liblnk_get_codepage "int *codepage, liblnk_error_t **error"
.Ft int
.Fn liblnk_set_codepage "int codepage, liblnk_error_t **error"
.Ft int
.Fn liblnk_check_file_signature "const char *filename, liblnk_error_t **error"
.Pp
Available when compiled with wide character string support:
.Ft int
.Fn liblnk_check_file_signature_wide "const wchar_t *filename, liblnk_error_t **error"
.Pp
Available when compiled with libbfio support:
.Ft int
.Fn liblnk_check_file_signature_file_io_handle "libbfio_handle_t *file_io_handle, liblnk_error_t **error"
.Pp
Notify functions
.Ft void
.Fn liblnk_notify_set_verbose "int verbose"
.Ft int
.Fn liblnk_notify_set_stream "FILE *stream, liblnk_error_t **error"
.Ft int
.Fn liblnk_notify_stream_open "const char *filename, liblnk_error_t **error"
.Ft int
.Fn liblnk_notify_stream_close "liblnk_error_t **error"
.Pp
Error functions
.Ft void
.Fn liblnk_error_free "liblnk_error_t **error"
.Ft int
.Fn liblnk_error_fprint "liblnk_error_t *error, FILE *stream"
.Ft int
.Fn liblnk_error_sprint "liblnk_error_t *error, char *string, size_t size"
.Ft int
.Fn liblnk_error_backtrace_fprint "liblnk_error_t *error, FILE *stream"
.Ft int
.Fn liblnk_error_backtrace_sprint "liblnk_error_t *error, char *string, size_t size"
.Pp
File functions
.Ft int
.Fn liblnk_file_initialize "liblnk_file_t **file, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_free "liblnk_file_t **file, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_signal_abort "liblnk_file_t *file, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_open "liblnk_file_t *file, const char *filename, int access_flags, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_close "liblnk_file_t *file, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_ascii_codepage "liblnk_file_t *file, int *ascii_codepage, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_set_ascii_codepage "liblnk_file_t *file, int ascii_codepage, liblnk_error_t **error"
.Pp
Available when compiled with wide character string support:
.Ft int
.Fn liblnk_file_open_wide "liblnk_file_t *file, const wchar_t *filename, int access_flags, liblnk_error_t **error"
.Pp
Available when compiled with libbfio support:
.Ft int
.Fn liblnk_file_open_file_io_handle "liblnk_file_t *file, libbfio_handle_t *file_io_handle, int access_flags, liblnk_error_t **error"
.Pp
Link information functions
.Ft int
.Fn liblnk_file_get_data_flags "liblnk_file_t *file, uint32_t *data_flags, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_link_refers_to_file "liblnk_file_t *file, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_file_creation_time "liblnk_file_t *file, uint64_t *filetime, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_file_modification_time "liblnk_file_t *file, uint64_t *filetime, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_file_access_time "liblnk_file_t *file, uint64_t *filetime, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_file_size "liblnk_file_t *file, uint32_t *file_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_icon_index "liblnk_file_t *file, uint32_t *icon_index, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_show_window_value "liblnk_file_t *file, uint32_t *show_window_value, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_hot_key_value "liblnk_file_t *file, uint16_t *hot_key_value, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_file_attribute_flags "liblnk_file_t *file, uint32_t *file_attribute_flags, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_drive_type "liblnk_file_t *file, uint32_t *drive_type, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_drive_serial_number "liblnk_file_t *file, uint32_t *drive_serial_number, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_volume_label_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_volume_label "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_volume_label_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_volume_label "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_local_path_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_local_path "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_local_path_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_local_path "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_network_path_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_network_path "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_network_path_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_network_path "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_description_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_description "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_description_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_description "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_relative_path_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_relative_path "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_relative_path_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_relative_path "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_working_directory_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_working_directory "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_working_directory_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_working_directory "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_command_line_arguments_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_command_line_arguments "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_command_line_arguments_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_command_line_arguments "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_icon_location_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_icon_location "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_icon_location_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_icon_location "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_environment_variables_location_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_environment_variables_location "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_environment_variables_location_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_environment_variables_location "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_link_target_identifier_data_size "liblnk_file_t *file, size_t *data_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_copy_link_target_identifier_data "liblnk_file_t *file, uint8_t *data, size_t data_size, liblnk_error_t **error"
.Pp
Distributed link tracking data functions
.Ft int
.Fn liblnk_file_has_distributed_link_tracking_data "liblnk_file_t *file, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_machine_identifier_size "liblnk_file_t *file, size_t *utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf8_machine_identifier "liblnk_file_t *file, uint8_t *utf8_string, size_t utf8_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_machine_identifier_size "liblnk_file_t *file, size_t *utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_utf16_machine_identifier "liblnk_file_t *file, uint16_t *utf16_string, size_t utf16_string_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_droid_volume_identifier "liblnk_file_t *file, uint8_t *guid_data, size_t guid_data_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_droid_file_identifier "liblnk_file_t *file, uint8_t *guid_data, size_t guid_data_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_birth_droid_volume_identifier "liblnk_file_t *file, uint8_t *guid_data, size_t guid_data_size, liblnk_error_t **error"
.Ft int
.Fn liblnk_file_get_birth_droid_file_identifier "liblnk_file_t *file, uint8_t *guid_data, size_t guid_data_size, liblnk_error_t **error"
.Sh DESCRIPTION
The
.Fn liblnk_get_version
function is used to retrieve the library version.
.Sh RETURN VALUES
Most of the functions return NULL or \-1 on error, dependent on the return type.
For the actual return values see "liblnk.h".
.Sh ENVIRONMENT
None
.Sh FILES
None
.Sh NOTES
liblnk allows to be compiled with wide character support (wchar_t).
To compile liblnk with wide character support use:
.Ar ./configure --enable-wide-character-type=yes
or define:
.Ar _UNICODE
or
.Ar UNICODE
during compilation.
.Ar LIBLNK_WIDE_CHARACTER_TYPE
in liblnk/features.h can be used to determine if liblnk was compiled with wide character support.
.Sh BUGS
Please report bugs of any kind on the project issue tracker: https://github.com/libyal/liblnk/issues
.Sh AUTHOR
These man pages are generated from "liblnk.h".
.Sh COPYRIGHT
Copyright (C) 2009-2017, Joachim Metz <joachim.metz@gmail.com>.
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.Sh SEE ALSO
the liblnk.h include file
|
