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 31extern "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 50typedef 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 58typedef 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 145struct 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 */ 161extern void quit(int) __NORETURN; 162 163 164/* listmgr.c */ 165extern int bl_create __P((int count_per_block, int struct_size, 166 char *desc)); 167extern char *bl_next_avail __P((int list_handle)); 168extern char *bl_get_record __P((int list_handle, int recno)); 169extern void bl_free __P((int list_handle)); 170extern int ar_create __P((int count_per_block, int struct_size, 171 char *desc)); 172extern char **ar_next_avail __P((int list_handle)); 173extern char **ar_get_head __P((int list_handle)); 174extern int ar_delete __P((int list_handle, int index)); 175extern void ar_free __P((int list_handle)); 176 177/* doulimit.c */ 178extern int set_ulimit __P((char *script, char *err_msg)); 179extern int clr_ulimit __P((void)); 180extern int assign_ulimit __P((char *fslimit)); 181 182/* dryrun.c */ 183extern void set_continue_not_ok __P((void)); 184extern int continue_is_ok __P((void)); 185extern int in_dryrun_mode __P((void)); 186extern int in_continue_mode __P((void)); 187extern void init_dryrunfile __P((char *dr_dir)); 188extern void init_contfile __P((char *cn_dir)); 189extern void set_dr_exitmsg __P((char *value)); 190extern void set_dr_info __P((int type, int value)); 191extern void write_dryrun_file __P((struct cfextra **extlist)); 192 193/* instvol.c */ 194extern void regfiles_free __P((void)); 195 196/* lockinst.c */ 197extern int lockinst __P((char *util_name, char *pkg_name, char *place)); 198extern void lockupd __P((char *place)); 199extern void unlockinst __P((void)); 200 201extern char *pathdup __P((char *s)); 202extern char *pathalloc __P((int n)); 203extern char *fixpath __P((char *path)); 204extern char *get_info_basedir __P((void)); 205extern char *get_basedir __P((void)); 206extern char *get_client_basedir __P((void)); 207extern int set_basedirs __P((int reloc, char *adm_basedir, 208 char *pkginst, int nointeract)); 209extern int eval_path __P((char **server_ptr, char **client_ptr, 210 char **map_ptr, char *path)); 211extern int get_orig_offset __P((void)); 212extern char *get_inst_root __P((void)); 213extern char *get_mount_point __P((short n)); 214extern char *get_remote_path __P((short n)); 215extern void set_env_cbdir __P((void)); 216extern int set_inst_root __P((char *path)); 217extern void put_path_params __P((void)); 218extern int mkpath __P((char *p)); 219extern void mkbasedir __P((int flag, char *path)); 220extern int is_an_inst_root __P((void)); 221extern int is_a_basedir __P((void)); 222extern int is_a_cl_basedir __P((void)); 223extern int is_relocatable __P((void)); 224extern char *orig_path __P((char *path)); 225extern char *orig_path_ptr __P((char *path)); 226extern char *qreason __P((int caller, int retcode, int started, 227 int includeZonename)); 228extern char *qstrdup __P((char *s)); 229extern char *srcpath __P((char *d, char *p, int part, int nparts)); 230extern char *trans_srcp_pi __P((char *local_path)); 231extern int copyf __P((char *from, char *to, time_t mytime)); 232extern int copyFile __P((int, int, char *, char *, struct stat *, long)); 233extern int openLocal __P((char *a_path, int a_oflag, char *a_tmpdir)); 234extern int dockdeps __P((char *depfile, int removeFlag, 235 boolean_t a_preinstallCheck)); 236extern int finalck __P((struct cfent *ept, int attrchg, int contchg, 237 boolean_t a_warning)); 238 239/* dockdeps.c */ 240extern void setUpdate __P((void)); 241extern int isUpdate __P((void)); 242extern void setPatchUpdate __P((void)); 243extern int isPatchUpdate __P((void)); 244 245/* mntinfo.c */ 246extern int get_mntinfo __P((int map_client, char *vfstab_file)); 247extern short fsys __P((char *path)); 248extern struct fstable *get_fs_entry __P((short n)); 249extern int mount_client __P((void)); 250extern int unmount_client __P((void)); 251extern short resolved_fsys __P((char *path)); 252extern char *get_server_host __P((short n)); 253extern char *server_map __P((char *path, short fsys_value)); 254extern int use_srvr_map __P((char *path, short *fsys_value)); 255extern int use_srvr_map_n __P((short n)); 256extern int is_fs_writeable __P((char *path, short *fsys_value)); 257extern int is_remote_fs __P((char *path, short *fsys_value)); 258extern int is_served __P((char *path, short *fsys_value)); 259extern int is_mounted __P((char *path, short *fsys_value)); 260extern int is_fs_writeable_n __P((short n)); 261extern int is_remote_fs_n __P((short n)); 262extern int is_served_n __P((short n)); 263extern int is_mounted_n __P((short n)); 264extern fsblkcnt_t get_blk_size_n __P((short n)); 265extern fsblkcnt_t get_frag_size_n __P((short n)); 266extern fsblkcnt_t get_blk_used_n __P((short n)); 267extern fsblkcnt_t get_blk_free_n __P((short n)); 268extern fsblkcnt_t get_inode_used_n __P((short n)); 269extern fsblkcnt_t get_inode_free_n __P((short n)); 270extern void set_blk_used_n __P((short n, fsblkcnt_t value)); 271extern char *get_source_name_n __P((short n)); 272extern char *get_fs_name_n __P((short n)); 273extern int load_fsentry __P((struct fstable *fs_entry, char *name, 274 char *fstype, char *remote_name)); 275extern int isreloc __P((char *pkginstdir)); 276extern int is_local_host __P((char *hostname)); 277extern void fs_tab_free __P((void)); 278 279/* pkgdbmerg.c */ 280extern int pkgdbmerg __P((PKGserver server, VFP_T *tmpvfp, 281 struct cfextra **extlist)); 282extern int files_installed __P((void)); 283 284/* ocfile.c */ 285extern int trunc_tcfile __P((int fd)); 286extern int ocfile __P((PKGserver *serverp, VFP_T **tmpvfp, 287 fsblkcnt_t map_blks)); 288extern int swapcfile __P((PKGserver server, VFP_T **a_tmpvfp, 289 char *pkginst, int dbchg)); 290extern int set_cfdir __P((char *cfdir)); 291extern int socfile __P((PKGserver *server, boolean_t quiet)); 292extern int relslock __P((void)); 293extern int pkgWlock __P((int verbose)); 294extern int iscfile __P((void)); 295extern int vcfile __P((void)); 296 297extern fsblkcnt_t nblk __P((fsblkcnt_t size, ulong_t bsize, 298 ulong_t frsize)); 299extern struct cfent **procmap __P((VFP_T *vfp, int mapflag, char *ir)); 300extern void repl_cfent __P((struct cfent *new, struct cfent *old)); 301extern struct cfextra **pkgobjmap __P((VFP_T *vfp, int mapflag, char *ir)); 302extern void pkgobjinit __P((void)); 303extern int seed_pkgobjmap __P((struct cfextra *ext_entry, char *path, 304 char *local)); 305extern int init_pkgobjspace __P((void)); 306 307/* eptstat.c */ 308extern void pinfo_free __P((void)); 309extern struct pinfo *eptstat __P((struct cfent *entry, char *pkg, char c)); 310 311/* echo.c */ 312/*PRINTFLIKE1*/ 313extern void echo __P((char *a_fmt, ...)); 314/*PRINTFLIKE1*/ 315extern void echoDebug __P((char *a_fmt, ...)); 316extern boolean_t echoGetFlag __P((void)); 317extern boolean_t echoDebugGetFlag __P((void)); 318extern boolean_t echoSetFlag __P((boolean_t a_debugFlag)); 319extern boolean_t echoDebugSetFlag __P((boolean_t a_debugFlag)); 320 321/* psvr4ck.c */ 322extern void psvr4cnflct __P((void)); 323extern void psvr4mail __P((char *list, char *msg, int retcode, char *pkg)); 324extern void psvr4pkg __P((char **ppkg)); 325 326/* ptext.c */ 327/*PRINTFLIKE2*/ 328extern void ptext __P((FILE *fp, char *fmt, ...)); 329 330/* putparam.c */ 331extern void putparam __P((char *param, char *value)); 332extern void getuserlocale __P((void)); 333extern void putuserlocale __P((void)); 334extern void putConditionInfo __P((char *, char *)); 335 336/* setadmin.c */ 337extern void setadminFile __P((char *file)); 338extern char *setadminSetting __P((char *a_paramName, 339 char *a_paramValue)); 340extern char *set_keystore_admin __P((void)); 341extern boolean_t get_proxy_port_admin __P((char **, ushort_t *)); 342extern boolean_t check_keystore_admin __P((char **)); 343extern int web_ck_retries __P((void)); 344extern int web_ck_timeout __P((void)); 345extern int web_ck_authentication __P((void)); 346 347/* setlist.c */ 348extern char *cl_iscript __P((int idx)); 349extern char *cl_rscript __P((int idx)); 350extern void find_CAS __P((int CAS_type, char *bin_ptr, char *inst_ptr)); 351extern int setlist __P((struct cl_attr ***plist, char *slist)); 352extern void addlist __P((struct cl_attr ***plist, char *item)); 353extern char *cl_nam __P((int cl_idx)); 354extern char *flex_device(char *device_name, int dev_ok); 355extern int cl_getn __P((void)); 356extern int cl_idx __P((char *cl_nam)); 357extern void cl_sets __P((char *slist)); 358extern void cl_setl __P((struct cl_attr **cl_lst)); 359extern void cl_putl __P((char *parm_name, struct cl_attr **list)); 360extern int cl_deliscript __P((int i)); 361extern unsigned cl_svfy __P((int i)); 362extern unsigned cl_dvfy __P((int i)); 363extern unsigned cl_pthrel __P((int i)); 364 365/* passwd.c */ 366extern int pkg_passphrase_cb __P((char *, int, int, void *)); 367extern void set_passarg __P((char *)); 368extern void set_prompt __P((char *)); 369 370/* fixpath.c */ 371extern void __P(export_client_env(char *)); 372extern void __P(set_partial_inst(void)); 373extern int __P(is_partial_inst(void)); 374extern void __P(set_depend_pkginfo_DB(boolean_t a_setting)); 375extern boolean_t __P(is_depend_pkginfo_DB(void)); 376extern void __P(disable_spool_create(void)); 377extern int __P(is_spool_create(void)); 378 379/* open_package_datastream.c */ 380extern boolean_t open_package_datastream(int a_argc, char **a_argv, 381 char *a_spoolto, char *a_device, 382 int *r_repeat, char **r_idsName, 383 char *a_tmpdir, struct pkgdev *a_pkgdev, 384 int a_optind); 385 386/* setup_temporary_directory.c */ 387extern boolean_t setup_temporary_directory(char **r_dirname, 388 char *a_tmpdir, char *a_suffix); 389 390/* unpack_package_from_stream.c */ 391extern boolean_t unpack_package_from_stream(char *a_idsName, 392 char *a_pkginst, char *a_tempDir); 393 394/* pkgops.c */ 395 396extern boolean_t pkgAddPackageToGzonlyList(char *a_pkgInst, 397 char *a_rootPath); 398extern void pkgAddThisZonePackage(char *a_pkgInst); 399extern boolean_t pkgRemovePackageFromGzonlyList(char *a_rootPath, 400 char *a_pkgInst); 401extern FILE *pkgOpenInGzOnlyFile(char *a_rootPath); 402extern void pkginfoFree(struct pkginfo **r_info); 403extern boolean_t pkginfoIsPkgInstalled(struct pkginfo **r_pinfo, 404 char *a_pkgInst); 405extern boolean_t pkgIsPkgInGzOnly(char *a_rootPath, char *a_pkgInst); 406extern boolean_t pkgIsPkgInGzOnlyFP(FILE *a_fp, char *a_pkgInst); 407extern boolean_t pkginfoParamTruth(FILE *a_fp, char *a_param, 408 char *a_value, boolean_t a_default); 409extern int pkgGetPackageList(char ***r_pkgList, char **a_argv, 410 int a_optind, char *a_categories, 411 char **a_categoryList, struct pkgdev *a_pkgdev); 412extern void pkgLocateHighestInst(char *r_path, int r_pathLen, 413 char *r_pkgInst, int r_pkgInstLen, 414 char *a_rootPath, char *a_pkgInst); 415extern boolean_t pkgPackageIsThisZone(char *a_pkgInst); 416extern char *pkgGetGzOnlyPath(void); 417extern boolean_t pkgTestInstalled(char *a_packageName, char *a_rootPath); 418 419/* depchk.c */ 420 421struct depckErrorRecord { 422 int ier_numZones; 423 char *ier_packageName; 424 char **ier_zones; 425 char **ier_values; 426}; 427 428typedef struct depckErrorRecord depckErrorRecord_t; 429 430struct depckError { 431 int er_numEntries; 432 depckErrorRecord_t *er_theEntries; 433}; 434 435typedef struct depckError depckError_t; 436 437typedef int (depcklFunc_t)(char *a_msg, char *a_pkg); 438 439/* 440 * ignore_values: 441 * == NULL - record one message for each instance of "name" found 442 * == "" - record multiple instances 443 * != "" - record multiple instances if value not in ignore_values 444 */ 445 446struct depckl_struct { 447 char *name; 448 char *ignore_values; 449 char **err_msg; 450 depcklFunc_t *depcklFunc; 451 depckError_t *record; 452}; 453 454typedef struct depckl_struct depckl_t; 455 456extern int depchkReportErrors(depckl_t *depckl); 457extern void depchkRecordError(depckError_t *a_erc, 458 char *a_pkginst, char *a_zoneName, 459 char *a_value); 460 461/* log.c */ 462 463/* types of log messages we recognize */ 464typedef enum { 465 LOG_MSG_ERR, 466 LOG_MSG_WRN, 467 LOG_MSG_INFO, 468 LOG_MSG_DEBUG 469} LogMsgType; 470 471/*PRINTFLIKE2*/ 472extern void log_msg(LogMsgType, const char *, ...); 473extern void log_set_verbose(boolean_t); 474extern boolean_t log_get_verbose(void); 475 476/* 477 * typedef for the 'ckreturn' function 478 */ 479typedef void (ckreturnFunc_t)(int a_retcode); 480 481/* sml.c */ 482 483/* null reference to SML_TAG object */ 484 485#define SML_TAG__NULL ((SML_TAG*)NULL) 486 487/* null reference to SML_TAG * object */ 488 489#define SML_TAG__R_NULL ((SML_TAG**)NULL) 490 491/* is reference to SML_TAG object valid? */ 492 493#define SML_TAG__ISVALID(tag) ((tag) != (SML_TAG__NULL)) 494 495/* is indirect reference to SML_TAG object valid? */ 496 497#define SML_TAG__R_ISVALID(r_tag) \ 498 ((r_tag) != ((SML_TAG**)(SML_TAG__NULL))) 499 500/* definitions for sml passed from pkginstall to pkgcond */ 501 502#define PKGCOND_GLOBAL_VARIABLE "SUNW_PKGCOND_GLOBAL_DATA" 503#define TAG_COND_TOPLEVEL "environmentConditionInformation" 504#define TAG_COND_PARENT_ZONE "parentZone" 505#define TAG_COND_CURRENT_ZONE "currentZone" 506#define TAG_COND_ZONE_NAME "zoneName" 507#define TAG_COND_ZONE_TYPE "zoneType" 508#define TAG_COND_FS_NAME "fileSystemName" 509#define TAG_VALUE_GLOBAL_ZONE "global" 510#define TAG_VALUE_NONGLOBAL_ZONE "nonglobal" 511 512typedef struct _sml_tag_struct SML_TAG; 513typedef struct _sml_parameter_struct SML_PARAM; 514 515struct _sml_tag_struct { 516 char *name; /* tag name */ 517 int params_num; /* # params in *params */ 518 SML_PARAM *params; /* tag parameters */ 519 int tags_num; /* # subtags in *tags */ 520 SML_TAG *tags; /* tag subtags */ 521}; 522 523struct _sml_parameter_struct { 524 char *name; /* tag name */ 525 char *value; /* parameters */ 526}; 527 528SML_TAG *smlAddTag(SML_TAG **r_tag, int a_index, 529 SML_TAG *a_subTag); 530boolean_t smlFstatCompareEq(struct stat *statbuf, 531 SML_TAG *tag, char *path); 532char *smlConvertTagToString(SML_TAG *tag); 533/*PRINTFLIKE2*/ 534void smlDbgPrintTag(SML_TAG *a_tag, char *a_format, ...); 535void smlDelTag(SML_TAG *tag, SML_TAG *sub_tag); 536void smlDelParam(SML_TAG *tag, char *name); 537SML_TAG *smlDup(SML_TAG *tag); 538boolean_t smlFindAndDelTag(SML_TAG *tag, char *findTag); 539void smlFreeTag(SML_TAG *tag); 540char *smlGetElementName(SML_TAG *a_tag); 541int smlGetNumParams(SML_TAG *a_tag); 542char *smlGetParam(SML_TAG *tag, char *name); 543/*PRINTFLIKE2*/ 544char *smlGetParamF(SML_TAG *tag, char *format, ...); 545void smlGetParam_r(SML_TAG *tag, char *name, char *buf, 546 int bufLen); 547char *smlGetParamByTag(SML_TAG *tag, int index, 548 char *tagName, char *parmName); 549char *smlGetParamByTagParam(SML_TAG *tag, int index, 550 char *tagName, char *parmName, char *parmValue, 551 char *parmReturn); 552char *smlGetParamName(SML_TAG *tag, int index); 553SML_TAG *smlGetTag(SML_TAG *tag, int index); 554SML_TAG *smlGetTagByName(SML_TAG *tag, int index, char *name); 555SML_TAG *smlGetTagByTagParam(SML_TAG *tag, int index, 556 char *tagName, char *paramName, char *paramValue); 557boolean_t smlGetVerbose(void); 558int smlLoadTagFromFile(SML_TAG **r_tag, char *a_fileName); 559SML_TAG *smlNewTag(char *name); 560boolean_t smlParamEq(SML_TAG *tag, char *findTag, 561 char *findParam, char *str); 562/*PRINTFLIKE4*/ 563boolean_t smlParamEqF(SML_TAG *tag, char *findTag, char *findParam, 564 char *format, ...); 565void smlPrintTag(SML_TAG *tag); 566int smlReadOneTag(SML_TAG **r_tag, char *a_str); 567int smlConvertStringToTag(SML_TAG **r_tag, char *str); 568void smlSetFileStatInfo(SML_TAG **tag, 569 struct stat *statbuf, char *path); 570void smlSetParam(SML_TAG *tag, char *name, char *value); 571/*PRINTFLIKE3*/ 572void smlSetParamF(SML_TAG *tag, char *name, char *format, ...); 573void smlSetVerbose(boolean_t a_setting); 574int smlWriteTagToFd(SML_TAG *tag, int fd); 575int smlWriteTagToFile(SML_TAG *tag, char *filename); 576/*PRINTFLIKE3*/ 577void sml_strPrintf_r(char *a_buf, int a_bufLen, char *a_format, ...); 578/*PRINTFLIKE1*/ 579char *sml_strPrintf(char *a_format, ...); 580char *sml_XmlEncodeString(char *a_plainTextString); 581char *sml_XmlDecodeString(char *a_xmlEncodedString); 582 583#if defined(lint) && !defined(gettext) 584#define gettext(x) x 585#endif /* defined(lint) && !defined(gettext) */ 586 587#ifdef __cplusplus 588} 589#endif 590 591#endif /* __HDRS_LIBINST_H__ */ 592