1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22 /*
23 * Copyright (c) 1993, 2010, Oracle and/or its affiliates. All rights reserved.
24 */
25
26 #ifndef __HDRS_LIBINST_H__
27 #define __HDRS_LIBINST_H__
28
29
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33
34 #include <stdio.h>
35 #include <fcntl.h>
36 #include <sys/types.h>
37 #include <sys/stat.h>
38 #include <pkgstrct.h>
39 #include <pkginfo.h>
40 #include "pkglib.h"
41 #include <cfext.h>
42 #include "install.h"
43
44 #define DEF_NONE_SCR "i.CompCpio"
45
46 #define BL_ALL -1 /* refers to all allocated lists */
47
48 /* signal handler function definition */
49
50 typedef void (sighdlrFunc_t)(int);
51
52 /* maximum parameter length */
53
54 #define MAX_PKG_PARAM_LENGTH (64+1) /* +1 for null termination */
55
56 /* flag for check_applicability */
57
58 typedef unsigned long CAF_T;
59
60 /* flags for check_applicability */
61
62 #define CAF_IN_GLOBAL_ZONE 0x00000001 /* in global zone */
63 #define CAF_SCOPE_GLOBAL 0x00000002 /* -G specified */
64 #define CAF_SCOPE_NONGLOBAL 0x00000004 /* -Z specified */
65
66 /* path to the request file in the package directory */
67
68 #define REQUEST_FILE "install/request"
69
70 /* path to the copyright file in the package directory */
71
72 #define COPYRIGHT_FILE "install/copyright"
73
74 /* path to the depend file in the package directory */
75
76 #define DEPEND_FILE "install/depend"
77
78 /*
79 * name of environment variable set to non-global zone name being installed:
80 * pkgadd/pkginstall expects this name and passes it on to any scripts that
81 * are run if it is set.
82 */
83
84 #define PKG_ZONENAME_VARIABLE "SUNW_PKG_INSTALL_ZONENAME"
85
86 /*
87 * name of environment variable set to indicate this package should be installed
88 * in the current zone only - see PSARC/2004/789 - New Pkginfo(4) attributes
89 * for zones
90 */
91
92 #define PKG_THISZONE_VARIABLE "SUNW_PKG_THISZONE"
93
94 /*
95 * name of environment variable set to indicate this package should be installed
96 * in all zones, and only from the global zone - see PSARC/2003/460
97 */
98
99 #define PKG_ALLZONES_VARIABLE "SUNW_PKG_ALLZONES"
100
101 /*
102 * name of environment variable set to indicate this package should be installed
103 * hollow (db update only) when installed in nonglobal zone - see PSARC/2003/460
104 */
105
106 #define PKG_HOLLOW_VARIABLE "SUNW_PKG_HOLLOW"
107
108 /*
109 * General purpose return codes used for functions which don't return a basic
110 * success or failure. For those functions wherein a yes/no result is
111 * possible, then 1 means OK and 0 means FAIL.
112 */
113 #define RESULT_OK 0x0
114 #define RESULT_WRN 0x1
115 #define RESULT_ERR 0x2
116
117 /* These are the file status indicators for the contents file */
118 #define INST_RDY '+' /* entry is ready to installf -f */
119 #define RM_RDY '-' /* entry is ready for removef -f */
120 #define NOT_FND '!' /* entry (or part of entry) was not found */
121 #define SERVED_FILE '%' /* using the file server's RO partition */
122 #define STAT_NEXT '@' /* this is awaiting eptstat */
123 #define DUP_ENTRY '#' /* there's a duplicate of this */
124 #define CONFIRM_CONT '*' /* need to confirm contents */
125 #define CONFIRM_ATTR '~' /* need to confirm attributes */
126 #define ENTRY_OK '\0' /* entry is a confirmed file */
127
128 /* control bits for pkgdbmerg() */
129 #define NO_COPY 0x0001
130 #define CLIENT_PATHS 0x0002 /* working with a client database */
131
132 /* control bits for file verification by class */
133 #define DEFAULT 0x0 /* standard full verification */
134 #define NOVERIFY 0x1 /* do not verify */
135 #define QKVERIFY 0x2 /* do a quick verification instead */
136
137 /* control bit for path type to pass to CAS */
138 #define DEFAULT 0x0 /* standard server-relative absolute path */
139 #define REL_2_CAS 0x1 /* pass pkgmap-type relative path */
140
141 /* findscripts() argument */
142 #define I_ONLY 0x0 /* find install class action scripts */
143 #define R_ONLY 0x1 /* find removal class action scripts */
144
145 struct cl_attr {
146 char name[CLSSIZ+1]; /* name of class */
147 char *inst_script; /* install class action script */
148 char *rem_script; /* remove class action script */
149 unsigned src_verify:3; /* source verification level */
150 unsigned dst_verify:4; /* destination verification level */
151 unsigned relpath_2_CAS:1; /* CAS gets relative paths */
152 };
153
154 #if defined(__STDC__)
155 #define __P(protos) protos
156 #else /* __STDC__ */
157 #define __P(protos) ()
158 #endif /* __STDC__ */
159
160 /* Common quit declaration used across many package commands */
161 extern void quit(int) __NORETURN;
162
163
164 /* listmgr.c */
165 extern int bl_create __P((int count_per_block, int struct_size,
166 char *desc));
167 extern char *bl_next_avail __P((int list_handle));
168 extern char *bl_get_record __P((int list_handle, int recno));
169 extern void bl_free __P((int list_handle));
170 extern int ar_create __P((int count_per_block, int struct_size,
171 char *desc));
172 extern char **ar_next_avail __P((int list_handle));
173 extern char **ar_get_head __P((int list_handle));
174 extern int ar_delete __P((int list_handle, int index));
175 extern void ar_free __P((int list_handle));
176
177 /* doulimit.c */
178 extern int set_ulimit __P((char *script, char *err_msg));
179 extern int clr_ulimit __P((void));
180 extern int assign_ulimit __P((char *fslimit));
181
182 /* dryrun.c */
183 extern void set_continue_not_ok __P((void));
184 extern int continue_is_ok __P((void));
185 extern int in_dryrun_mode __P((void));
186 extern int in_continue_mode __P((void));
187 extern void init_dryrunfile __P((char *dr_dir));
188 extern void init_contfile __P((char *cn_dir));
189 extern void set_dr_exitmsg __P((char *value));
190 extern void set_dr_info __P((int type, int value));
191 extern void write_dryrun_file __P((struct cfextra **extlist));
192
193 /* instvol.c */
194 extern void regfiles_free __P((void));
195
196 /* lockinst.c */
197 extern int lockinst __P((char *util_name, char *pkg_name, char *place));
198 extern void lockupd __P((char *place));
199 extern void unlockinst __P((void));
200
201 extern char *pathdup __P((char *s));
202 extern char *pathalloc __P((int n));
203 extern char *fixpath __P((char *path));
204 extern char *get_info_basedir __P((void));
205 extern char *get_basedir __P((void));
206 extern char *get_client_basedir __P((void));
207 extern int set_basedirs __P((int reloc, char *adm_basedir,
208 char *pkginst, int nointeract));
209 extern int eval_path __P((char **server_ptr, char **client_ptr,
210 char **map_ptr, char *path));
211 extern int get_orig_offset __P((void));
212 extern char *get_inst_root __P((void));
213 extern char *get_mount_point __P((short n));
214 extern char *get_remote_path __P((short n));
215 extern void set_env_cbdir __P((void));
216 extern int set_inst_root __P((char *path));
217 extern void put_path_params __P((void));
218 extern int mkpath __P((char *p));
219 extern void mkbasedir __P((int flag, char *path));
220 extern int is_an_inst_root __P((void));
221 extern int is_a_basedir __P((void));
222 extern int is_a_cl_basedir __P((void));
223 extern int is_relocatable __P((void));
224 extern char *orig_path __P((char *path));
225 extern char *orig_path_ptr __P((char *path));
226 extern char *qreason __P((int caller, int retcode, int started,
227 int includeZonename));
228 extern char *qstrdup __P((char *s));
229 extern char *srcpath __P((char *d, char *p, int part, int nparts));
230 extern char *trans_srcp_pi __P((char *local_path));
231 extern int copyf __P((char *from, char *to, time_t mytime));
232 extern int copyFile __P((int, int, char *, char *, struct stat *, long));
233 extern int openLocal __P((char *a_path, int a_oflag, char *a_tmpdir));
234 extern int dockdeps __P((char *depfile, int removeFlag,
235 boolean_t a_preinstallCheck));
236 extern int finalck __P((struct cfent *ept, int attrchg, int contchg,
237 boolean_t a_warning));
238
239 /* dockdeps.c */
240 extern void setUpdate __P((void));
241 extern int isUpdate __P((void));
242
243 /* mntinfo.c */
244 extern int get_mntinfo __P((int map_client, char *vfstab_file));
245 extern short fsys __P((char *path));
246 extern struct fstable *get_fs_entry __P((short n));
247 extern int mount_client __P((void));
248 extern int unmount_client __P((void));
249 extern short resolved_fsys __P((char *path));
250 extern char *get_server_host __P((short n));
251 extern char *server_map __P((char *path, short fsys_value));
252 extern int use_srvr_map __P((char *path, short *fsys_value));
253 extern int use_srvr_map_n __P((short n));
254 extern int is_fs_writeable __P((char *path, short *fsys_value));
255 extern int is_remote_fs __P((char *path, short *fsys_value));
256 extern int is_served __P((char *path, short *fsys_value));
257 extern int is_mounted __P((char *path, short *fsys_value));
258 extern int is_fs_writeable_n __P((short n));
259 extern int is_remote_fs_n __P((short n));
260 extern int is_served_n __P((short n));
261 extern int is_mounted_n __P((short n));
262 extern fsblkcnt_t get_blk_size_n __P((short n));
263 extern fsblkcnt_t get_frag_size_n __P((short n));
264 extern fsblkcnt_t get_blk_used_n __P((short n));
265 extern fsblkcnt_t get_blk_free_n __P((short n));
266 extern fsblkcnt_t get_inode_used_n __P((short n));
267 extern fsblkcnt_t get_inode_free_n __P((short n));
268 extern void set_blk_used_n __P((short n, fsblkcnt_t value));
269 extern char *get_source_name_n __P((short n));
270 extern char *get_fs_name_n __P((short n));
271 extern int load_fsentry __P((struct fstable *fs_entry, char *name,
272 char *fstype, char *remote_name));
273 extern int isreloc __P((char *pkginstdir));
274 extern int is_local_host __P((char *hostname));
275 extern void fs_tab_free __P((void));
276
277 /* pkgdbmerg.c */
278 extern int pkgdbmerg __P((PKGserver server, VFP_T *tmpvfp,
279 struct cfextra **extlist));
280 extern int files_installed __P((void));
281
282 /* ocfile.c */
283 extern int trunc_tcfile __P((int fd));
284 extern int ocfile __P((PKGserver *serverp, VFP_T **tmpvfp,
285 fsblkcnt_t map_blks));
286 extern int swapcfile __P((PKGserver server, VFP_T **a_tmpvfp,
287 char *pkginst, int dbchg));
288 extern int set_cfdir __P((char *cfdir));
289 extern int socfile __P((PKGserver *server, boolean_t quiet));
290 extern int relslock __P((void));
291 extern int pkgWlock __P((int verbose));
292 extern int iscfile __P((void));
293 extern int vcfile __P((void));
294
295 extern fsblkcnt_t nblk __P((fsblkcnt_t size, ulong_t bsize,
296 ulong_t frsize));
297 extern struct cfent **procmap __P((VFP_T *vfp, int mapflag, char *ir));
298 extern void repl_cfent __P((struct cfent *new, struct cfent *old));
299 extern struct cfextra **pkgobjmap __P((VFP_T *vfp, int mapflag, char *ir));
300 extern void pkgobjinit __P((void));
301 extern int seed_pkgobjmap __P((struct cfextra *ext_entry, char *path,
302 char *local));
303 extern int init_pkgobjspace __P((void));
304
305 /* eptstat.c */
306 extern void pinfo_free __P((void));
307 extern struct pinfo *eptstat __P((struct cfent *entry, char *pkg, char c));
308
309 /* echo.c */
310 /*PRINTFLIKE1*/
311 extern void echo __P((char *a_fmt, ...));
312 /*PRINTFLIKE1*/
313 extern void echoDebug __P((char *a_fmt, ...));
314 extern boolean_t echoGetFlag __P((void));
315 extern boolean_t echoDebugGetFlag __P((void));
316 extern boolean_t echoSetFlag __P((boolean_t a_debugFlag));
317 extern boolean_t echoDebugSetFlag __P((boolean_t a_debugFlag));
318
319 /* ptext.c */
320 /*PRINTFLIKE2*/
321 extern void ptext __P((FILE *fp, char *fmt, ...));
322
323 /* putparam.c */
324 extern void putparam __P((char *param, char *value));
325 extern void getuserlocale __P((void));
326 extern void putuserlocale __P((void));
327 extern void putConditionInfo __P((char *, char *));
328
329 /* setadmin.c */
330 extern void setadminFile __P((char *file));
331 extern char *setadminSetting __P((char *a_paramName,
332 char *a_paramValue));
333 extern char *set_keystore_admin __P((void));
334 extern boolean_t get_proxy_port_admin __P((char **, ushort_t *));
335 extern boolean_t check_keystore_admin __P((char **));
336 extern int web_ck_retries __P((void));
337 extern int web_ck_timeout __P((void));
338 extern int web_ck_authentication __P((void));
339
340 /* setlist.c */
341 extern char *cl_iscript __P((int idx));
342 extern char *cl_rscript __P((int idx));
343 extern void find_CAS __P((int CAS_type, char *bin_ptr, char *inst_ptr));
344 extern int setlist __P((struct cl_attr ***plist, char *slist));
345 extern void addlist __P((struct cl_attr ***plist, char *item));
346 extern char *cl_nam __P((int cl_idx));
347 extern char *flex_device(char *device_name, int dev_ok);
348 extern int cl_getn __P((void));
349 extern int cl_idx __P((char *cl_nam));
350 extern void cl_sets __P((char *slist));
351 extern void cl_setl __P((struct cl_attr **cl_lst));
352 extern void cl_putl __P((char *parm_name, struct cl_attr **list));
353 extern int cl_deliscript __P((int i));
354 extern unsigned cl_svfy __P((int i));
355 extern unsigned cl_dvfy __P((int i));
356 extern unsigned cl_pthrel __P((int i));
357
358 /* passwd.c */
359 extern int pkg_passphrase_cb __P((char *, int, int, void *));
360 extern void set_passarg __P((char *));
361 extern void set_prompt __P((char *));
362
363 /* fixpath.c */
364 extern void __P(export_client_env(char *));
365 extern void __P(set_partial_inst(void));
366 extern int __P(is_partial_inst(void));
367 extern void __P(set_depend_pkginfo_DB(boolean_t a_setting));
368 extern boolean_t __P(is_depend_pkginfo_DB(void));
369 extern void __P(disable_spool_create(void));
370 extern int __P(is_spool_create(void));
371
372 /* open_package_datastream.c */
373 extern boolean_t open_package_datastream(int a_argc, char **a_argv,
374 char *a_spoolto, char *a_device,
375 int *r_repeat, char **r_idsName,
376 char *a_tmpdir, struct pkgdev *a_pkgdev,
377 int a_optind);
378
379 /* setup_temporary_directory.c */
380 extern boolean_t setup_temporary_directory(char **r_dirname,
381 char *a_tmpdir, char *a_suffix);
382
383 /* unpack_package_from_stream.c */
384 extern boolean_t unpack_package_from_stream(char *a_idsName,
385 char *a_pkginst, char *a_tempDir);
386
387 /* pkgops.c */
388
389 extern boolean_t pkgAddPackageToGzonlyList(char *a_pkgInst,
390 char *a_rootPath);
391 extern void pkgAddThisZonePackage(char *a_pkgInst);
392 extern boolean_t pkgRemovePackageFromGzonlyList(char *a_rootPath,
393 char *a_pkgInst);
394 extern FILE *pkgOpenInGzOnlyFile(char *a_rootPath);
395 extern void pkginfoFree(struct pkginfo **r_info);
396 extern boolean_t pkginfoIsPkgInstalled(struct pkginfo **r_pinfo,
397 char *a_pkgInst);
398 extern boolean_t pkgIsPkgInGzOnly(char *a_rootPath, char *a_pkgInst);
399 extern boolean_t pkgIsPkgInGzOnlyFP(FILE *a_fp, char *a_pkgInst);
400 extern boolean_t pkginfoParamTruth(FILE *a_fp, char *a_param,
401 char *a_value, boolean_t a_default);
402 extern int pkgGetPackageList(char ***r_pkgList, char **a_argv,
403 int a_optind, char *a_categories,
404 char **a_categoryList, struct pkgdev *a_pkgdev);
405 extern void pkgLocateHighestInst(char *r_path, int r_pathLen,
406 char *r_pkgInst, int r_pkgInstLen,
407 char *a_rootPath, char *a_pkgInst);
408 extern boolean_t pkgPackageIsThisZone(char *a_pkgInst);
409 extern char *pkgGetGzOnlyPath(void);
410 extern boolean_t pkgTestInstalled(char *a_packageName, char *a_rootPath);
411
412 /* depchk.c */
413
414 struct depckErrorRecord {
415 int ier_numZones;
416 char *ier_packageName;
417 char **ier_zones;
418 char **ier_values;
419 };
420
421 typedef struct depckErrorRecord depckErrorRecord_t;
422
423 struct depckError {
424 int er_numEntries;
425 depckErrorRecord_t *er_theEntries;
426 };
427
428 typedef struct depckError depckError_t;
429
430 typedef int (depcklFunc_t)(char *a_msg, char *a_pkg);
431
432 /*
433 * ignore_values:
434 * == NULL - record one message for each instance of "name" found
435 * == "" - record multiple instances
436 * != "" - record multiple instances if value not in ignore_values
437 */
438
439 struct depckl_struct {
440 char *name;
441 char *ignore_values;
442 char **err_msg;
443 depcklFunc_t *depcklFunc;
444 depckError_t *record;
445 };
446
447 typedef struct depckl_struct depckl_t;
448
449 extern int depchkReportErrors(depckl_t *depckl);
450 extern void depchkRecordError(depckError_t *a_erc,
451 char *a_pkginst, char *a_zoneName,
452 char *a_value);
453
454 /* log.c */
455
456 /* types of log messages we recognize */
457 typedef enum {
458 LOG_MSG_ERR,
459 LOG_MSG_WRN,
460 LOG_MSG_INFO,
461 LOG_MSG_DEBUG
462 } LogMsgType;
463
464 /*PRINTFLIKE2*/
465 extern void log_msg(LogMsgType, const char *, ...);
466 extern void log_set_verbose(boolean_t);
467 extern boolean_t log_get_verbose(void);
468
469 /*
470 * typedef for the 'ckreturn' function
471 */
472 typedef void (ckreturnFunc_t)(int a_retcode);
473
474 /* sml.c */
475
476 /* null reference to SML_TAG object */
477
478 #define SML_TAG__NULL ((SML_TAG*)NULL)
479
480 /* null reference to SML_TAG * object */
481
482 #define SML_TAG__R_NULL ((SML_TAG**)NULL)
483
484 /* is reference to SML_TAG object valid? */
485
486 #define SML_TAG__ISVALID(tag) ((tag) != (SML_TAG__NULL))
487
488 /* is indirect reference to SML_TAG object valid? */
489
490 #define SML_TAG__R_ISVALID(r_tag) \
491 ((r_tag) != ((SML_TAG**)(SML_TAG__NULL)))
492
493 /* definitions for sml passed from pkginstall to pkgcond */
494
495 #define PKGCOND_GLOBAL_VARIABLE "SUNW_PKGCOND_GLOBAL_DATA"
496 #define TAG_COND_TOPLEVEL "environmentConditionInformation"
497 #define TAG_COND_PARENT_ZONE "parentZone"
498 #define TAG_COND_CURRENT_ZONE "currentZone"
499 #define TAG_COND_ZONE_NAME "zoneName"
500 #define TAG_COND_ZONE_TYPE "zoneType"
501 #define TAG_COND_FS_NAME "fileSystemName"
502 #define TAG_VALUE_GLOBAL_ZONE "global"
503 #define TAG_VALUE_NONGLOBAL_ZONE "nonglobal"
504
505 typedef struct _sml_tag_struct SML_TAG;
506 typedef struct _sml_parameter_struct SML_PARAM;
507
508 struct _sml_tag_struct {
509 char *name; /* tag name */
510 int params_num; /* # params in *params */
511 SML_PARAM *params; /* tag parameters */
512 int tags_num; /* # subtags in *tags */
513 SML_TAG *tags; /* tag subtags */
514 };
515
516 struct _sml_parameter_struct {
517 char *name; /* tag name */
518 char *value; /* parameters */
519 };
520
521 SML_TAG *smlAddTag(SML_TAG **r_tag, int a_index,
522 SML_TAG *a_subTag);
523 boolean_t smlFstatCompareEq(struct stat *statbuf,
524 SML_TAG *tag, char *path);
525 char *smlConvertTagToString(SML_TAG *tag);
526 /*PRINTFLIKE2*/
527 void smlDbgPrintTag(SML_TAG *a_tag, char *a_format, ...);
528 void smlDelTag(SML_TAG *tag, SML_TAG *sub_tag);
529 void smlDelParam(SML_TAG *tag, char *name);
530 SML_TAG *smlDup(SML_TAG *tag);
531 boolean_t smlFindAndDelTag(SML_TAG *tag, char *findTag);
532 void smlFreeTag(SML_TAG *tag);
533 char *smlGetElementName(SML_TAG *a_tag);
534 int smlGetNumParams(SML_TAG *a_tag);
535 char *smlGetParam(SML_TAG *tag, char *name);
536 /*PRINTFLIKE2*/
537 char *smlGetParamF(SML_TAG *tag, char *format, ...);
538 void smlGetParam_r(SML_TAG *tag, char *name, char *buf,
539 int bufLen);
540 char *smlGetParamByTag(SML_TAG *tag, int index,
541 char *tagName, char *parmName);
542 char *smlGetParamByTagParam(SML_TAG *tag, int index,
543 char *tagName, char *parmName, char *parmValue,
544 char *parmReturn);
545 char *smlGetParamName(SML_TAG *tag, int index);
546 SML_TAG *smlGetTag(SML_TAG *tag, int index);
547 SML_TAG *smlGetTagByName(SML_TAG *tag, int index, char *name);
548 SML_TAG *smlGetTagByTagParam(SML_TAG *tag, int index,
549 char *tagName, char *paramName, char *paramValue);
550 boolean_t smlGetVerbose(void);
551 int smlLoadTagFromFile(SML_TAG **r_tag, char *a_fileName);
552 SML_TAG *smlNewTag(char *name);
553 boolean_t smlParamEq(SML_TAG *tag, char *findTag,
554 char *findParam, char *str);
555 /*PRINTFLIKE4*/
556 boolean_t smlParamEqF(SML_TAG *tag, char *findTag, char *findParam,
557 char *format, ...);
558 void smlPrintTag(SML_TAG *tag);
559 int smlReadOneTag(SML_TAG **r_tag, char *a_str);
560 int smlConvertStringToTag(SML_TAG **r_tag, char *str);
561 void smlSetFileStatInfo(SML_TAG **tag,
562 struct stat *statbuf, char *path);
563 void smlSetParam(SML_TAG *tag, char *name, char *value);
564 /*PRINTFLIKE3*/
565 void smlSetParamF(SML_TAG *tag, char *name, char *format, ...);
566 void smlSetVerbose(boolean_t a_setting);
567 int smlWriteTagToFd(SML_TAG *tag, int fd);
568 int smlWriteTagToFile(SML_TAG *tag, char *filename);
569 /*PRINTFLIKE3*/
570 void sml_strPrintf_r(char *a_buf, int a_bufLen, char *a_format, ...);
571 /*PRINTFLIKE1*/
572 char *sml_strPrintf(char *a_format, ...);
573 char *sml_XmlEncodeString(char *a_plainTextString);
574 char *sml_XmlDecodeString(char *a_xmlEncodedString);
575
576 #if defined(lint) && !defined(gettext)
577 #define gettext(x) x
578 #endif /* defined(lint) && !defined(gettext) */
579
580 #ifdef __cplusplus
581 }
582 #endif
583
584 #endif /* __HDRS_LIBINST_H__ */