DOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOSDOS_cx* file name */ int mode; /* access mode */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns A return value of 0 indicates that access is allowed. If access is denied or the file cannot be found, -1 is returned. Additional error information can then be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" chmod() " Link "chmod()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "acos()" acos(`Zc)-Arccosine function Synopsis #include r = acos(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the arccosine of the angle expressed in radians. See Also @{" __matherr() " Link "__matherr()"}, @{" cos() " Link "cos()"} @EndNode @Node "argopt()" argopt()-Get options from argument list Synopsis #include optd = argopt(argc,argv,opts,argn,optc); a[) char *optd; /* option data pointer */ int argc; /* argument count */ const char *argv[]; /* argument vector */ const char *opts; /* options expecting data */ int *argn; /* next argument number (changed) */ char *optc; /* option character (changed) */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns If the next argument is not an option, the function returnb28s a NULL pointer. Otherwise, it returns a pointer to the option data, which will be an empty string if there was no data. Also, if an option was found, the character is placed into the byte referenced by optc, and argn is adjusted to index the next entry in argv. See Also @{" main() " Link "main()"} @EndNode @Node "asctime()" asctime()-Generate ASCII time string Synopsis #include s = asctime(t); char *s; /*points to time stringc */ const struct tm *t; /*points to time structure */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns an ASCII string of exactly 26 characters having the form: "DDD MMM dd hh:mm:ss YYYY\n\0" DDD is the day of the week, MMM is the month, dd is the day of the month, hh:mm:ss is the hour:minute:seconds, and YYYY is the year. An example is: "Wed Sep 04 15:13:22 1985\n\0" The time pointer returned bdVj{y the function refers to a static data area that is shared by both @{" ctime() " Link "ctime()"} and asctime. See Also @{" ctime() " Link "ctime()"}, @{" gmtime() " Link "gmtime()"}, @{" localtime() " Link "localtime()"}, @{" strftime() " Link "strftime()"} @EndNode @Node "asin()" asin()-Arcsine function Synopsis #include r = asin(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns e  This function returns the arcsine of the argument expressed in radians. See Also @{" __matherr() " Link "__matherr()"} , @{" sin() " Link "sin()"} @EndNode @Node "assert()" assert()-assert program validity Synopsis #include assert(x); __assert(x,file,line); int x; const char *file; /* source file name */ int *line; /* source line number */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" stcsma() " Link "stcsma()"f l} , @{" stcpma() " Link "stcpma()"} , @{" stcpm() " Link "stcpm()"} @EndNode @Node "astcsma()" astcsma()-AmigaDOS string pattern match (anchored) Synopsis #include length = astcsma(s,p); int length; /* length of matching string */ const char *s; /* string being scanned */ const char *p; /* pattern string */ Portability AmigaDOS Returns This function returns the length of the matching string or zero if there was no match. See Ag Ulso @{" stcsma() " Link "stcsma()"} , @{" stcpma() " Link "stcpma()"} , @{" stcpm() " Link "stcpm()"} @EndNode @Node "atan()" atan()-Arctangent function Synopsis #include r = atan(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the arctangent of the argument expressed in radians. See Also @{" atan2() " Link "atan2()"} , @{" __matherr() " Link "__matherr(h Y)"} , @{" tan() " Link "tan()"} @EndNode @Node "atan2()" atan2()-Arctangent of x/y Synopsis #include r = atan2(x,y); double r; /* result; */ double x,y; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the arctangent of the argument expressed in radians. See Also @{" atan() " Link "atan()"} , @{" __matherr() " Link "__matherr()"} , @{" tan() " Link "tan()"} @EndNode @Node "atexit()" atexit()-Set ani W exit trap Synopsis #include error = atexit(func); int error; /* non-zero for success */ void (*func)(void); /* trap function pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A zero is returned for success and a non-zero value is returned if an error is encountered. See Also @{" exit() " Link "exit()"} @EndNode @Node "atof()" atof()-Convert ASCII to float Synopsis #include d = atof(p); jm double d; /* floating point result */ const char *p; /* input string pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the double equivalent of the ASCII string. See Also @{" atoi() " Link "atoi()"} , @{" atol() " Link "atol()"} , @{" stcd_i() " Link "stcd_i()"} , @{" stcd_l() " Link "stcd_l()"} , @{" strtod() " Link "strtod()"} @EndNode @Node "atoi()" atoi()-Convert ASCII to integer Synopsis #include x = atoi(s); int x; const char *s; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the integer equivalent of the ASCII string. See Also @{" atol() " Link "atol()"} , @{" atof() " Link "atof()"} , @{" stcd_i() " Link "stcd_i()"} , @{" stcd_l() " Link "stcd_l()"} , @{" strtod() " Link "strtod()"} , @{" strtol() " Link "strtol()"} @EndNode @Node "atol()" atol()-Convert ASCII to long integer Synopsis #include l_b y = atol(s); long int y; const char *s; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the long integer equivalent of the ASCII string. See Also @{" atoi() " Link "atoi()"} , @{" atof() " Link "atof()"} , @{" stcd_i() " Link "stcd_i()"} , @{" stcd_l() " Link "stcd_l()"} , @{" strtod() " Link "strtod()"} , @{" strtol() " Link "strtol()"} @EndNode @Node "_BackGroundIO" _BackGroundIO-Route I/O to the console window Synopsis m!Zd long _BackGroundIO; Description _BackGroundIO is used by cback.o to indicate whether output will be sent to the console window by your background process. The default is 0, indicating that I/O will not be sent to the console window. This variable is of interest only for background processes. If you do not link with cback.o, this variable is ignored. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" _Backstdout " Link "_Backstdout"} @EndNoden2 r @Node "_Backstdout" _Backstdout-Pointer to the console window file handle Synopsis BPTR _Backstdout; Description _Backstdout is used by cback.o to point to the console window where I/O is to be routed. If @{" _BackGroundIO " Link "_BackGroundIO"} is set to 1, cback.o initializes _Backstdout to point to the console window. Otherwise, _Backstdout is not initialized. This variable is of interest only for background processes. If you do not link with cback.oQ7!o, this variable is ignored. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" _BackGroundIO " Link "_BackGroundIO"} @EndNode @Node "bldmem()" bldmem()-Build a memory pool of specified size Synopsis #include i=bldmem(n); int n; /* number of 1K-byte blocks in pool */ int i; /* -1 for failure */ Portability OLD Returns This function returns a -1 if @{" sbrk() " Link "sbrk()"} fails. See Also @{" getmem() " Link "gp betmem()"}, @{" getml() " Link "getml()"} , @{" rlsmem() " Link "rlsmem()"} , @{" rlsml() " Link "rlsml()"} , @{" sizmem() " Link "sizmem()"} , @{" sbrk() " Link "sbrk()"} @EndNode @Node "bsearch()" bsearch()-Perform a binary search Synopsis #include void *bsearch(srch, array, n, size,cmp); const void *srch; /* object searched for */ const void *array; /* pointer to array to search */ size_t n; /* number of membeqrs of array */ size_t size; /* size of each element */ int (*cmp)(const void *, const void *)); /* pointer to comparison function */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns bsearch() returns a pointer to the element that matches the search value. If no match can be found, NULL is returned. See Also @{" qsort() " Link "qsort()"} @EndNode @Node "__buffsize" __buffsize-Level 2 I/O buffer size Synropsis extern int __buffsize; Description This external integer is used by the level 2 I/O system to determine the size of the buffers allocated for level 2 files. This location is also used to determine the size of a buffer attached to a file with the @{" setbuf() " Link "setbuf()"} function. In this case, __buffsize must be set to the size of the buffer before @{" setbuf() " Link "setbuf()"} is called. Portability @{" SAS/C " Link "Glossary - SASC"} See sxŦAlso @{" fopen() " Link "fopen()"} , @{" setbuf() " Link "setbuf()"} @EndNode @Node "calloc()" calloc()-Allocate level 3 memory allocation Synopsis #include b = calloc(nelt,esize); void *b; /* block pointer */ size_t nelt; /* number of elements */ size_t esize; /* element size */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A null pointer is returned if there is not enough space for the requested block. Set Te Also @{" getmem() " Link "getmem()"} , @{" rlsmem() " Link "rlsmem()"} , @{" sbrk() " Link "sbrk()"} , @{" rbrk() " Link "rbrk()"} , @{" malloc() " Link "malloc()"} ,@{" realloc() " Link "realloc()"} ,@{" free() " Link "free()"} @EndNode @Node "ceil()" ceil()-Get floating point limits Synopsis #include x = ceil(y); double x,y; Portability @{" ANSI " Link "Glossary - ANSI"} Returns The result is a real number. See Also @{" floor() " Link u>K["floor()"} @EndNode @Node "chdir()" chdir()-Change current directory Synopsis #include error = chdir(path); int error; /* 0 if successful */ const char *path; /* points to new directory path string */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the return value is non-zero, then the operation failed. An AmigaDOS error code will be in @{" _OSERR " Link "_OSERR"}, and a @{" UNIX " Link "Glossary - UNIX"} error code will bevK in @{" errno " Link "errno"}. See Also @{" errno " Link "errno"} , @{" mkdir() " Link "mkdir()"} , @{" rmdir() " Link "rmdir()"} , @{" getcd() " Link "getcd()"} , @{" getcwd() " Link "getcwd()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "chgclk()" chgclk()-Change system clock Synopsis #include error = chgclk(clock); int error; const unsigned char *clock; Portability AmigaDOS Returns If the array is invalid or the operation failed, chgcw:slk() returns a non-zero value. See Also @{" errno " Link "errno"} , @{" getclk() " Link "getclk()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "chkabort()" Chk_abort(),chkabort()-Check for break character Synopsis #include void chkabort(void); void Chk_abort(void); Portability AmigaDOS See Also @{" _CXBRK() " Link "_CXBRK()"} , @{" onbreak() " Link "onbreak()"} , @{" signal() " Link "signal()"} @EndNode @Node "chkml()" chkml()-Check for largxest memory block Synopsis #include size = chkml(void); long size; Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the size of the largest level 2 block. See Also @{" getmem() " Link "getmem()"} , @{" getml() " Link "getml()"} , @{" rlsmem() " Link "rlsmem()"} , @{" rlsml() " Link "rlsml()"} , @{" sizmem() " Link "sizmem()"} @EndNode @Node "chkufb()" chkufb()-Check level 1 file handle Synopsis #include yXe ufb = chkufb(fh); struct UFB *ufb; /* pointer to UNIX file block */ int fh; /* file handle */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns If no UFB is currently attached to the file handle, a null pointer is returned. See Also @{" __ufbs " Link "__ufbs"} , @{" __nufbs " Link "__nufbs"} @EndNode @Node "chmod()" chmod()-Change file protection mode Synopsis #include #include error = chmod(name,mode); izBXxnt error; /* error code */ const char *name; /* file name */ int mode; /* protection mode */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" access() " Link "access()"} @EndNode @Node "clearerr()" clearerr()-Clear level 2 I/O error flag Synopsis #{~include void clearerr(fp); FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" clrerr() " Link "clrerr()"} , @{" ferror() " Link "ferror()"} @EndNode @Node "clock()" clock()-Measure program processor time Synopsis #include x = clock(void); clock_t x; Portability @{" ANSI " Link "Glossary - ANSI"} Returns clock() returns the number of seconds since the base time. If an accurate| . value cannot be returned, (clock_t)-1 is returned. See Also @{" time() " Link "time()"} , @{" system() " Link "system()"} @EndNode @Node "close()" close()-close a level 1 file Synopsis #include error = close(fh); int error; /* non-zero if error */ int fh; /* file handle */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns The function returns 0 if it is successful. Otherwise, it returns -1 and places additional error informatio}! n into @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" fclose() " Link "fclose()"} , @{" open() " Link "open()"} @EndNode @Node "closedir()" closedir()-Terminate directory operation Synopsis #include void closedir(dfd) DIR *dfd; /* directory file descriptor */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" opendir() " Link "opendir()"} , @{" readdir() " Link "readdir()"} , @{" telldir() " Link "telldir()~"V3"} , @{" seekdir() " Link "seekdir()"} @EndNode @Node "clrerr()" clrerr()-Clear level 2 I/O error flag Synopsis #include void clrerr(fp); FILE *fp; /* file pointer */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" clearerr() " Link "clearerr()"} , @{" ferror() " Link "ferror()"} , @{" fopen() " Link "fopen()"} @EndNode @Node "cos()" cos()-cosine function Synopsis #include r = cos(x); double r; /* result */ #^ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the cosine of the argument. See Also @{" __matherr() " Link "__matherr()"} @EndNode @Node "cosh()" cosh()-Hyperbolic cosine function Synopsis #include r = cosh(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the hyperbolic cosine of the argument expres$_sed in radians. See Also @{" exp() " Link "exp()"} , @{" __matherr() " Link "__matherr()"} @EndNode @Node "cot()" cot()-cotangent function Synopsis #include r = cot(x); double r; /* result */ double x; /* angle */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns the cotangent of the argument expressed in radians. See Also @{" __matherr() " Link "__matherr()"} @EndNode @Node "creat()" creat()-create% a level 1 file Synopsis #include fh = creat(name,prot); int fh; /* file handle */ const char *name; /* file name */ int prot; /* protection mode */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns a file handle, which is an integer equal to or greater than 0. Otherwise it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Lin&Y'k "_OSERR"}. See Also @{" errno " Link "errno"} , @{" chmod() " Link "chmod()"} , @{" close() " Link "close()"} , @{" open() " Link "open()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "ctime()" ctime()-Convert time value to string Synopsis #include s = ctime(t); char *s; /* points to time string */ const time_t *t; /* points to time value */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns an ASCII 'Jstring of exactly 26 characters having the form: "DDD MMM dd hh:mm:ss YYYY\n\0" DDD is the day of the week, MMM is the month, dd is the day of the month, hh:mm:ss is the hour:minute:seconds, and YYYY is the year. An example is: "Wed Sep 04 15:13:22 1985\n\0" The time pointer returned by the function refers to a static data area that is shared by both ctime() and @{" asctime() " Link "asctime()"}. See Also @{" asctime() " Link "asctim([e()"} , @{" gmtime() " Link "gmtime()"} , @{" localtime() " Link "localtime()"} , @{" strftime() " Link "strftime()"} , @{" time() " Link "time()"} @EndNode @Node "__ctype" __ctype-Character class table Synopsis #include Description The external character array __ctype is a table indicating the attributes of all ASCII characters. It is 257 bytes long; one byte per ASCII character. The individual bits within the byte are set to indicate attributes a)֪s described below. Bit Value Meaning --- ----- ------- _U 0x01 Upper-case alphabetic character (A-Z) _L 0x02 Lower-case alphabetic character (a-z) _N 0x04 Decimal digit (0-9) _S 0x08 White space _P 0x10 Punctuation character _C 0x20 Control character _B 0x40 Blank _X 0x80 Hexadecimal digit (0-9, A-F, a-f) All indexes are offs*imaet by one so that the table also handles the end-of-file character (-1). You must index the table by the character plus one. Normally, you will not need to access the array directly, but will instead use the is...() character test macros (@{" isupper() " Link "isupper()"}, @{" isascii() " Link "isascii()"}, and others) to access it for you. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" isalnum() " Link "isalnum()"} , @{" isalpha() " Link "isalph+a()"} , @{" isascii() " Link "isascii()"} , @{" iscntrl() " Link "iscntrl()"} , @{" iscsym() " Link "iscsym()"} , @{" iscsymf() " Link "iscsymf()"} , @{" isdigit() " Link "isdigit()"} , @{" isgraph() " Link "isgraph()"} , @{" islower() " Link "islower()"} , @{" isprint() " Link "isprint()"} , @{" ispunct() " Link "ispunct()"} , @{" isspace() " Link "isspace()"} , @{" isupper() " Link "isupper()"} , @{" isxdigit() " Link "isxdigit()"} @EndNode @Node "_CXBRK()" _CXBRK()-Defau,rclt signal handler for SIGINT Synopsis #include void _CXBRK(sig); int sig; /* signal which caused the abort request */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" chkabort() " Link "chkabort()"} , @{" raise() " Link "raise()"} , @{" signal() " Link "signal()"} @EndNode @Node "_CXFERR()" _CXFERR()-Low-level float error Synopsis #include void _CXFERR(code); int code; Portability @{" SAS/C " Link "G-4blossary - SASC"} See Also @{" _FPERR " Link "_FPERR"} , @{" __matherr() " Link "__matherr()"} @EndNode @Node "_CXOVF()" _CXOVF()-Default stack overflow handler Synopsis void _CXOVF(void); Portability @{" SAS/C " Link "Glossary - SASC"} @EndNode @Node "datecmp()" datecmp()-Compare two AmigaDOS dates Synopsis #include status = datecmp(d1, d2); int status; /* result of comparison: */ /* 0 if equal .Ab */ /* -1 if d1 > d2 */ /* 1 if d1 < d2 */ const struct DateStamp *d1; /* first date to compare */ const struct DateStamp *d2; /* second string to compare */ Portability AmigaDOS Returns If the dates match as described above, then 0 is returned. If the first date is greater than the second date, then -1 is returned. Otherwise, 1 is returned. See Also @{" DateStamp() " Lin/d'k "dos/DateStamp()"} (AmigaDOS Technical Reference) @EndNode @Node "__daylight" __daylight-Daylight savings time flag Synopsis extern int __daylight; Description __daylight indicates whether daylight savings time is currently in effect. This variable is initialized by the @{" __tzset() " Link "__tzset()"} function and used by the @{" localtime() " Link "localtime()"} function to adjust from Greenwich Mean Time (GMT) to the local time. Portability @{" UNIX "0< Link "Glossary - UNIX"} See Also @{" localtime() " Link "localtime()"} , @{" __timezone " Link "__timezone"} , @{" __tzname " Link "__tzname"} , @{" __tzdtn " Link "__tzdtn"} , @{" __tzset() " Link "__tzset()"} , @{" __tzstn " Link "__tzstn"} @EndNode @Node "__daytbl" __daytbl-Array of days by name Synopsis extern char *__daytbl[]; Description The external array __daytbl contains seven pointers to character strings representing the days of the week. Each strin1bP?g is three bytes long, plus a null terminator. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __months " Link "__months"} , @{" __montbl " Link "__montbl"} @EndNode @Node "DiskfontBase" DiskfontBase-Disk font library vector Synopsis extern struct library *DiskfontBase; DiskfontBase = OpenLibrary("diskfont.library",ver); Description This external location is used by various Amiga library routines that interface with the ROM Kernel text funct22ions that deal with new fonts. It must be initialized by an @{" OpenLibrary() " Link "exec/OpenLibrary()"} call before any of the disk font functions documented in the Amiga ROM Kernel manuals can be called. It is expected to contain the base address of the disk font library vector table. You must close the library before your program terminates. Note: Do not capitalize the letter 'f' in DiskfontBase. Portability AmigaDOS @EndNode @Node "dfind()" dfind()-Fin3[Zd directory entry Synopsis #include error = dfind(info,name,attr); int error; /* 0 if successful */ struct FileInfoBlock *info; /* file information area */ const char *name; /* file name or pattern */ int attr; /* file attribute bits */ Portability AmigaDOS Returns If the operation is successful, a value of 0 is returned. Otherwise, the return value is -1, and you can find additional error inform5sation in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" dnext() " Link "dnext()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "difftime()" difftime()-Compute the difference of two times Synopsis #include x = difftime(time2,time1); double x; time_t time1, time2; Portability @{" ANSI " Link "Glossary - ANSI"} Returns difftime() returns the difference between two times, in seconds. See Als4Hߖ|{zyxwvutsrqponmlkjihgfedcba`_^]\[ZYXWVUTSRQPONMLKJIHGFEDCBA@?>=<;:98765}6$o @{" time() " Link "time()"} @EndNode @Node "div()" div()-Compute quotient and remainder Synopsis #include x = div(y, z); div_t x; /* quotient and remainder */ int y; /* numerator */ int z; /* denominator */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns div() returns a structure of type div_t, which contains both the quotient and remainder. The return value is such that numer 7K= quot * denom + rem The sign of rem is the same as the sign of numer. See Also @{" ldiv() " Link "ldiv()"} @EndNode @Node "dnext()" dnext()-Find next directory entry Synopsis #include error = dnext(info); int error; /* 0 if successful */ struct FileInfoBlock *info; /* file information area */ Portability AmigaDOS Returns If the operation is successful, a value of 0 is returned. Otherwise, the return value is -1, and yo8"ǧu can find additional error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" dfind() " Link "dfind()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "DOSBase" DOSBase-AmigaDOS Library Vector Synopsis extern struct library *DOSBase; DOSBase = OpenLibrary("dos.library",ver); Description This external location is used by various Amiga library routines that interface with AmigaDOS system functions. 9M/ It is initialized by an @{" OpenLibrary() " Link "exec/OpenLibrary()"} call in the startup code and is expected to contain the base address of the AmigaDOS system library vector table. If you do not link with the startup module c.o, and if you make calls to AmigaDOS system functions or use @{" SAS/C " Link "Glossary - SASC"} features that call AmigaDOS system functions, then you must first initialize this location by calling @{" OpenLibrary() " Link "exec/OpenLibr:ary()"}. If you call @{" OpenLibrary() " Link "exec/OpenLibrary()"}, you must close the library before your program terminates. Portability AmigaDOS @EndNode @Node "dqsort()" dqsort()-Sort an array of doubles Synopsis #include void dqsort(da,n); double *da; /* pointer to beginning of an array of doubles */ size_t n; /* number of elements in array */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" fqsort() " Link "fqsort(;cj)"} , @{" lqsort() " Link "lqsort()"} , @{" qsort() " Link "qsort()"} , @{" sqsort() " Link "sqsort()"} , @{" tqsort() " Link "tqsort()"} @EndNode @Node "drand48()" drand48()-Generate random double (internal seed) Synopsis #include x = drand48(); double x; /* random double */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" erand48() " Link "erand48()"} , @{" jrand48() " Link "jrand48()"} , @{" lcong48() " Link "lcong48()"} , @{"<.d rand() " Link "rand()"} , @{" srand() " Link "srand()"} , @{" srand48() " Link "srand48()"} @EndNode @Node "ecvt()" ecvt()-Convert double to string Synopsis #include s = ecvt(v,dig,decx,sign); char *s; /* string pointer */ double v; /* floating point value */ int dig; /* number of digits */ int *decx; /* pointer to decimal index (returned) */ int *sign; /* pointer to sign indicator */ Portability @{" UNIX " Link "Glossary - UNIX"} Return=s This function returns a pointer to a character string containing the ASCII equivalent of the float argument. See Also @{" fcvt() " Link "fcvt()"} @EndNode @Node "__emit()" __emit()-Emit 68000 instruction word Synopsis #include void __emit(inst); int inst; Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" getreg() " Link "getreg()"} , @{" putreg() " Link "putreg()"} @EndNode @Node "erand48()" erand48()-Generate random double (e>Qˑxternal seed) Synopsis #include x = erand48(seed); double x; /* random double */ unsigned short seed[3]; /* seed value (high bits in seed[0]) */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns The erand48() function returns double values distributed uniformly over the interval from 0.0 up to but not including 1.0. See Also @{" drand48() " Link "drand48()"} , @{" jrand48() " Link "jrand48()"} , @{" lcong48() " Link "lcong?"i48()"} , @{" rand() " Link "rand()"} , @{" srand() " Link "srand()"} , @{" srand48() " Link "srand48()"} @EndNode @Node "errno" errno-@{" UNIX " Link "Glossary - UNIX"} error number Synopsis #include extern int errno; Description The external integer named errno is initialized to 0 at start-up time. Then, if an error is detected by one of the standard library functions, a non-zero value is placed there. The standard library never resets errno. Po@Srtability @{" UNIX " Link "Glossary - UNIX"} See Also @{" perror() " Link "perror()"} , @{" strerror() " Link "strerror()"} , @{" __sys_errlist " Link "__sys_errlist"} , @{" __sys_nerr " Link "__sys_nerr"} @EndNode @Node "except()" except()-Call math error handler Synopsis #include r = except(type,name,arg1,arg2,retval); double r; /* actual return value */ int type; /* error type */ const char *name; /* math funcA#tion name */ double arg1; /* first argument */ double arg2; /* second argument */ double retval; /* proposed return value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The actual return value (a double) is passed back. See Also @{" _FPERR " Link "_FPERR"} , @{" __matherr() " Link "__matherr()"} @EndNode @Node "exit()" exit()-Terminate program execution Synopsis #include void exit(code); int cBTode; Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" longjmp() " Link "longjmp()"} @EndNode @Node "__exit()" __exit()-Terminate program execution with no clean-up Synopsis #include void __exit(code); int code; Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" exit() " Link "exit()"} @EndNode @Node "exp()" exp()-exponential function Synopsis #include r = exp(x); double r, x; Portability @{"Cy ANSI " Link "Glossary - ANSI"} Returns This function returns a double containing the calculated exponential. See Also @{" log() " Link "log()"}, @{" __matherr() " Link "__matherr()"} @EndNode @Node "fabs()" fabs()-Float/double absolute value Synopsis #include ad = fabs(d); double ad,d; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a double containing the absolute value of the argument. See Also @{" absD*\() " Link "abs()"} , @{" iabs() " Link "iabs()"} , @{" labs() " Link "labs()"} @EndNode @Node "fclose()" fclose()-close a level 2 file Synopsis #include ret = fclose(fp); int ret; /* return code */ FILE *fp; /* file pointer for file to be closed */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, fclose() returns 0. This function returns EOF to indicate an error. If EOF is returned, additional error information can E%`be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" open() " Link "open()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "fcloseall()" fcloseall()-close all level 2 files Synopsis #include num = fcloseall(); int num; /* number of files closed */ Portability @{" XENIX " Link "Glossary - XENIX"} Returns If successful, fcloseall() returns the number of fileFs that were closed. This function returns -1 to indicate an error. If -1 is returned, additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "fcvt()" fcvt()-Convert float to string Synopsis #include s = fcvt(v,dig,decx,sign); char *s; /* string pointer */ double v; /* floating pointGr@ value */ int dig; /* number of digits */ int *decx; /* pointer to decimal index (returned) */ int *sign; /* pointer to sign indicator */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns a pointer to a string containing the ASCII representation of the float argument. See Also @{" ecvt() " Link "ecvt()"} @EndNode @Node "fdopen()" fdopen()-Attach level 1 file to level 2 Synopsis #include fp = fdopen(fh,mode); H FILE *fp; /* file pointer */ int fh; /* file handle */ const char *mode; /* access mode */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns a non-null file pointer. If it is not successful, the function returns a null pointer and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link Io"fopen()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "feof()" feof()-Check for level 2 end-of-file Synopsis #include ret = feof(fp); int ret; /* non-zero if condition is true */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns non-zero value if the specified file pointer is at end-of-file. If not, this function returns a 0. See Also @{" ferror() " Link "ferror()"} @EndNOde @NJq61ode "ferror()" ferror()-Check for level 2 error Synopsis #include ret = ferror(fp); int ret; /* non-zero if condition is true */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns The return value is 0 if no error has been set. If an error indicator was set, a non-zero value is returned. See Also @{" clearerr() " Link "clearerr()"} , @{" feof() " Link "feof()"} @EndNode @Node "fflush()" fflush()-Flush lKn=evel 2 output buffer Synopsis #include ret = fflush(fp); int ret; /* return code */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If an error occurs, the return value is EOF. The appropriate error code is placed into @{" errno " Link "errno"}, and additional information is placed in @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fclose() " Link "fclose()"} , @{" fcloseallLX h() " Link "fcloseall()"} , @{" flushall() " Link "flushall()"} , @{" fopen() " Link "fopen()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "fgetpos()" fgetpos()-Get the current file position Synopsis #include x = fgetpos(f, pos); int x; FILE *f; fpos_t *pos; Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, fgetpos() returns 0. If it fails, fgetpos() returns a nonzero value and stores an appropriate error code in @{"Mʲw errno " Link "errno"}. See the description of @{" errno " Link "errno"} in Chapter 6 of the library reference for the list of possible values. See Also @{" fseek() " Link "fseek()"}, @{" fsetpos() " Link "fsetpos()"}, @{" ftell() " Link "ftell()"} , @{" lseek() " Link "lseek()"} @EndNode @Node "fgetc()" fgetc()-Get a character from a file Synopsis #include c = fgetc(fp); int c; /* return character or code */ FILE *fp; /* file pointer */ N'&Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, the next input character is returned. Otherwise, the function returns EOF, which is defined in . In the event of an EOF return, error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fgetchar() " Link "fgetchar()"} , @{" fputc() " Link "fputc()"} , @{" getc() " Link "getc()"} , @{" getch() " Link "getch(O)"} , @{" getchar() " Link "getchar()"} , @{" fopen() " Link "fopen()"} , @{" ungetc() " Link "ungetc()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "fgetchar()" fgetchar()-Get a character from stdin Synopsis #include c = fgetchar(void); int c; /* return character or code */ Portability @{" XENIX " Link "Glossary - XENIX"} Returns If successful, the next input character is returned. Otherwise, the function returns EOF, which is defined P~yin . In the event of an EOF return, error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fgetc() " Link "fgetc()"} , @{" fopen() " Link "fopen()"} , @{" getc() " Link "getc()"} , @{" getchar() " Link "getchar()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "fgets()" fgets()-Get string from a level 2 file Synopsis #include p = fgets(buffer,length,fp); char *p;Q} /* buffer pointer or NULL */ char *buffer; /* buffer pointer */ int length; /* buffer length in bytes */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If the end-of-file is hit before any bytes are read, a NULL pointer is returned. If an I/O error occurs, a NULL pointer is returned and additional information is placed in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. If no I/O error occursR=I and at least one byte was read from the file, the buffer argument is returned. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" feof() " Link "feof()"} , @{" ferror() " Link "ferror()"} , @{" fgetc() " Link "fgetc()"} , @{" fread() " Link "fread()"} , @{" getc() " Link "getc()"} , @{" gets() " Link "gets()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "fileno()" fileno()-Get file number for a level 2 file Synopsis #include fSh = fileno(fp); int fh; /* file handle */ FILE *fp; /* file pointer */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns The return value is an integer representing the file handle. See Also @{" fopen() " Link "fopen()"} , @{" freopen() " Link "freopen()"} , @{" fdopen() " Link "fdopen()"} @EndNode @Node "findpath()" findpath()-Locate file in the current path Synopsis #include lock = findpath(filename); BPTR lock; const char *TFjfilename; Portability AmigaDOS Returns If findpath() finds the file, it returns a lock on that directory even if it is the current directory. The lock must be unlocked with the AmigaDOS @{" UnLock() " Link "dos/UnLock()"} function. If findpath() cannot find the file, it returns a -1. NULL is not used because it is a valid lock. See Also @{" getpath() " Link "getpath()"} , @{" UnLock() " Link "dos/UnLock()"} (AmigaDos Technical Reference) @EndNode @Node "fUB\loor()" floor()-Get floor of a real number Synopsis #include x = floor(y); double x,y; Portability @{" ANSI " Link "Glossary - ANSI"} Returns The result is a real number. See Also @{" ceil() " Link "ceil()"} @EndNode @Node "flushall()" flushall()-Flush all level 2 output buffers Synopsis #include num = flushall(void); int num; /* number of open files */ Portability XENIX Returns If an error occurs, the return valVBt@ue is EOF. The appropriate error code is placed into @{" errno " Link "errno"}, and additional information is placed in @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fcloseall() " Link "fcloseall()"} , @{" fflush() " Link "fflush()"} , @{" fopen() " Link "fopen()"} , @{" fclose() " Link "fclose()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "__fmask" __fmask-Default protection bits for opening a file Synopsis extern unsigned long __fmaskWV}J; Description This external integer indicates the default protection for any file created by the @{" SAS/C " Link "Glossary - SASC"} file I/O routines, including all @{" ANSI " Link "Glossary - ANSI"} I/O routines. This flag has no effect on AmigaDOS I/O routines such as @{" Open() " Link "dos/Open()"}. The default protection is read, write, and delete. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" creat() " Link "creat()"} , @{" fopen() " LinXgk "fopen()"} , @{" open() " Link "open()"} , AmigaDOS @{" Open() " Link "dos/Open()"} @EndNode @Node "fmod()" fmod()-Float modulus operations Synopsis #include x = fmod(y,z); double x,y,z; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns y if z is 0. Otherwise, it returns a value that has the same sign as y, is less than z, and satisfies the relationship: y = (i * z) + x i is an integer. See Also @{" modY! 6f() " Link "modf()"} @EndNode @Node "fmode()" fmode()-Change mode of level 2 file Synopsis #include void fmode(fp,mode); FILE *fp; /* file pointer */ int mode; /* 0 => mode A */ /* 1 => mode B */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" fopen() " Link "fopen()"} , @{" freopen() " Link "freopen()"} , @{" fdopen() " Link "fdopen()"} @EndNode @Node "__fmode" __fmode-Default level 2 I/O mode Synopsis extZvern int __fmode; Description This external integer is used by the @{" fopen() " Link "fopen()"} function to determine the translation mode to use when the programmer does not specify a mode in the @{" fopen() " Link "fopen()"} call. For AmigaDOS, it is set to 0x8000, which specifies untranslated mode. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" fopen() " Link "fopen()"} @EndNode @Node "fopen()" fopen()-open a level 2 file Synopsis #incl[WVude fp = fopen(name,"mode"); FILE *fp; /* file pointer */ const char *name; /* file name */ const char *mode; /* access mode string */ Portability @{" ANSI " Link "Glossary - ANSI"} (Mode A open modes are an extension to the @{" ANSI " Link "Glossary - ANSI"} standard, and you should not use them in programs that you want to be @{" ANSI " Link "Glossary - ANSI"}-compatible.) Returns A null pointer is returned if the file cann\Đot be opened. Consult @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"} for detailed error information. See Also @{" fclose() " Link "fclose()"} , @{" fdopen() " Link "fdopen()"} , @{" fgetc() " Link "fgetc()"} , @{" fgets() " Link "fgets()"} , @{" fputc() " Link "fputc()"} , @{" fputs() " Link "fputs()"} , @{" fread() " Link "fread()"} , @{" freopen() " Link "freopen()"} , @{" fwrite() " Link "fwrite()"} , @{" open() " Link "open()"} @EndNode @Node "forkl()" ]]#forkl()-create a child process with argument list Synopsis #include error = forkl(prog,arg0,arg1,...,argn,NULL,env,procid); int error; /* error code */ char *prog; /* program name */ char *arg0; /* argument #0 */ char *arg1; /* argument #1 */ char *argn; /* argument #n */ struct FORKENV *env; /* pointer to pseudo environment*/ /* structure (may be NULL)*/ struct ProcID *procid; ^T /* pointer to process ID structure*/ Portability @{" SAS/C " Link "Glossary - SASC"} Returns If the specified program file cannot be found, a -1 return is made, and additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. You must call the @{" wait() " Link "wait()"} function to obtain the completion code from the child process. See Also @{" exit() " Link "exit()"} , @{" forkv() " Link "forkv()"} , @{" wait() " L_]ink "wait()"} , @{" waitm() " Link "waitm()"} , @{" LoadSeg() " Link "exec/LoadSeg()"} , @{" CreateProc() " Link "dos/CreateProc()"} , @{" Execute() " Link "dos/Execute()"} , @{" Open() " Link "dos/Open()"} in the AmigaDOS Technical Reference Manual, @{" System() " Link "dos/System()"} in the AmigaDOS Technical Reference Manual for AmigaDOS 2.0 @EndNode @Node "forkv()" forkv()-create a child process with argument vector Synopsis #include error = forkv(prog,`argv,env,procid); int error; /* error code */ char *prog; /* program name */ char *argv[]; /* argument vector */ struct FORKENV *env; /* pointer to pseudo environment*/ /* structure (may be NULL)*/ struct ProcID *procid; /* pointer to process ID structure*/ Portability @{" SAS/C " Link "Glossary - SASC"} Returns If the specified program file cannot be found, a -1 return is made, and additional error ia}{@Hnformation can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. You must call the @{" wait() " Link "wait()"} function to obtain the completion code from the child process. See Also @{" exit() " Link "exit()"} , @{" forkl() " Link "forkl()"} , @{" wait() " Link "wait()"} , @{" waitm() " Link "waitm()"} , @{" LoadSeg() " Link "exec/LoadSeg()"} , @{" CreateProc() " Link "dos/CreateProc()"} , @{" Execute() " Link "dos/Execute()"} , @{" Open() " LinbHk "dos/Open()"} in the AmigaDOS Technical Reference Manual, @{" System() " Link "dos/System()"} in the AmigaDOS Technical Reference Manual for AmigaDOS 2.0 @EndNode @Node "_FPERR" _FPERR-Floating Point Error Code Synopsis extern int _FPERR; Description This location contains a non-zero value after any low-level floating point operation encounters an error. Low-level operations include addition, subtraction, multiplication, division, comparison, and conversion cKfrom one number representation to another (for example, float to double). Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" _CXFERR() " Link "_CXFERR()"} @EndNode @Node "fprintf()" fprintf()-Formatted print Synopsis #include length = fprintf(fp,fmt,arg1,arg2,...); int length; /* number of characters generated */ FILE *fp; /* file pointer */ const char *fmt; /* format string */ *arg; /*d;6 arguments */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of output characters generated. If an error occurs, fprintf() returns a negative value and places additional information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fscanf() " Link "fscanf()"} , @{" _OSERR " Link "_OSERR"} , @{" printf() " Link "printf()"} , @{" scanf() " Link "scanf()"} , @{" sprintfe,Y() " Link "sprintf()"} , @{" sscanf() " Link "sscanf()"} , @{" Formatted Input Specifiers " Link "Formatted Input Specifiers"} , @{" Formatted Output Specifiers " Link "Formatted Output Specifiers"} @EndNode @Node "fputc()" fputc()-Put a character to a level 2 file Synopsis #include r = fputc(c,fp); int r; /* EOF or c */ int c; /* character to be output */ FILE *fp; /* level 2 file pointer */ Portability @{" ANSI " Link "Glossary - ANf$mvSI"} Returns If successful, this function returns the character c; otherwise, it returns EOF. For disk files, an EOF return usually means that the disk is full. However, this type of return can also occur if the device is write-protected or if a write error occurs. In any case, additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" fputchagr() " Link "fputchar()"} , @{" _OSERR " Link "_OSERR"} , @{" putc() " Link "putc()"} , @{" putchar() " Link "putchar()"} @EndNode @Node "fputchar()" fputchar()-Put a character to stdout Synopsis #include r = fputchar(c); int r; /* EOF or c */ int c; /* Character to be output */ Portability XENIX Returns If successful, this function returns the character c; otherwise, it returns EOF. For disk files, an EOF return usually means thathԖ the disk is full. However, this type of return can also occur if the device is write-protected or if a write error occurs. In any case, additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" fputc() " Link "fputc()"} , @{" _OSERR " Link "_OSERR"} , @{" putc() " Link "putc()"} , @{" putchar() " Link "putchar()"} @EndNode @Node "fputs()" fputs()ib-Put string to level 2 file Synopsis #include error = fputs(s,fp); int error; /* non-zero if error */ const char *s; /* string pointer */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If an error occurs, the return value is EOF; otherwise, it is 0. Additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errnojA"} , @{" ferror() " Link "ferror()"} , @{" fopen() " Link "fopen()"} , @{" fputc() " Link "fputc()"} @{" _OSERR " Link "_OSERR"} , @{" puts() " Link "puts()"} @EndNode @Node "fqsort()" fqsort()-Sort an array of floats Synopsis #include void fqsort(fa,n); float *fa; /* pointer to float array */ stze_t n; /* number of elements in array */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" dqsort() " Link "dqsort()"} , @{" lqsort()k " Link "lqsort()"} , @{" qsort() " Link "qsort()"} , @{" sqsort() " Link "sqsort()"} , @{" tqsort() " Link "tqsort()"} @EndNode @Node "fread()" fread()-read and write blocks Synopsis #include a = fread(b,bsize,n,fp); size_t a; /* actual number of blocks */ void *b; /* pointer to first block */ size_t bsize; /* size of block in bytes */ size_t n; /* maximum number of blocks */ FILE *fp; /* file pointer */ Portability @l ?j{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of complete blocks that were read. See Also @{" fopen() " Link "fopen()"} , @{" fclose() " Link "fclose()"} , @{" ferror() " Link "ferror()"} , @{" feof() " Link "feof()"} , @{" fgetc() " Link "fgetc()"} , @{" fputc() " Link "fputc()"} , @{" fseek() " Link "fseek()"} , @{" fwrite() " Link "fwrite()"} @EndNode @Node "free()" free()-free memory Synopsis #include void free(b); mΫ void *b; /* block pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" calloc() " Link "calloc()"} , @{" getmem() " Link "getmem()"} , @{" malloc() " Link "malloc()"} , @{" rbrk() " Link "rbrk()"} , @{" realloc() " Link "realloc()"} , @{" rlsmem() " Link "rlsmem()"} , @{" sbrk() " Link "sbrk()"} @EndNode @Node "freopen()" freopen()-Reopen a level 2 file Synopsis #include fpr = freopen(name, mode, fp); FILE *fpr; /* nN(|file pointer after re-opening */ const char *name; /* file name */ const char *mode; /* access mode */ FILE *fp; /* current file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, this function returns the file pointer. Check the return code for null; the same errors as defined for @{" fopen() " Link "fopen()"} may occur. Also, for complete portability, do not assume that fpr and fp are identical. Use fpr to_o access the reopened file, not fp. See Also @{" fopen() " Link "fopen()"} , @{" fdopen() " Link "fdopen()"} @EndNode @Node "frexp()" frexp()-Split float value Synopsis #include f = frexp(v,xp); double f; /* fraction */ double v; /* value */ int *xp; /* exponent pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the mantissa as a double whose absolute value is greater than or equal to 0.5p? and less than 1.0. The exponent is returned as an integer whose absolute value is less than 1024. If the value v is zero, both returned values will be zero. See Also @{" fmod() " Link "fmod()"} , @{" ldexp() " Link "ldexp()"} , @{" __matherr() " Link "__matherr()"} , @{" modf() " Link "modf()"} @EndNode @Node "fscanf()" fscanf()-Formatted input conversions Synopsis #include n = fscanf(fp,fmt,arg1,arg2,...); int n; /* number of input itq}?O6ems matched, or EOF */ FILE *fp; /* file pointer (fscanf() only) */ const char *fmt; /* format string */ ---- *argx; /* pointers to input data areas */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns The function returns the number of assignments that were made. For example, a return value of 3 indicates that conversion results were assigned to arg1, arg2, and arg3. See Also @{" scanf() " Link "scanf()"} , @{" sscanf() " Link "sscar,nf()"} , @{" Formatted Input Specifiers() " Link "Formatted Input Specifiers"} @EndNode @Node "fseek()" fseek()-Set level 2 file position Synopsis #include error = fseek(fp,rpos,mode); int error; /* non-zero if error */ FILE *fp; /* file pointer returned from fopen() */ long int rpos; /* relative file position */ int mode; /* seek mode */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A value of -1 is returned if ans( error occurs. @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"} contain additional error information. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" ftell() " Link "ftell()"} , @{" lseek() " Link "lseek()"} , @{" _OSERR " Link "_OSERR"} , @{" rewind() " Link "rewind()"} @EndNode @Node "fsetpos()" fsetpos()-Reposition a file Synopsis #include x = fsetpos(fp,pos); int x; FILE *fp; const fpos_t *pos; Portabilitty @{" ANSI " Link "Glossary - ANSI"} Returns If successful, fsetpos() returns 0. If it fails, fsetpos() returns a nonzero value and stores an appropriate error code in @{" errno " Link "errno"}. See Also @{" fgetpos() " Link "fgetpos()"} , @{" fopen() " Link "fopen()"} , @{" fseek() " Link "fseek()"} , @{" ftell() " Link "ftell()"} , @{" lseek() " Link "lseek()"} @EndNode @Node "fstat()" fstat()-Get file status Synopsis #include rc = fstat(filugse, st); int rc; /* return code */ int file; /* file name */ struct stat *st; /* stat info structure */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" chmod() " Link "chmod()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Nva#ode "ftell()" ftell()-Get level 2 file position Synopsis #include apos = ftell(fp); long int apos; /* absolute file position */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns For ftell(), an error is indicated by a return value of -1L. @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"} contain additional error information. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} wc, @{" _OSERR " Link "_OSERR"} , @{" lseek() " Link "lseek()"} , @{" tell() " Link "tell()"} @EndNode @Node "fwrite()" fwrite()-write blocks to a level 2 file Synopsis #include a = fwrite(b,bsize,n,fp); size_t a; /* actual number of blocks */ const void *b; /* pointer to first block */ size_t bsize; /* size of block in bytes */ size_t n; /* maximum number of blocks */ FILE *fp; /* file pointer */ Portability @{" ANSI " Link "xǍ[Glossary - ANSI"} Returns This function returns the number of complete blocks that were processed. See Also @{" fopen() " Link "fopen()"} , @{" fclose() " Link "fclose()"} , @{" ferror() " Link "ferror()"} , @{" feof() " Link "feof()"} , @{" fgetc() " Link "fgetc()"} , @{" fputc() " Link "fputc()"} , @{" fread() " Link "fread()"} , @{" fseek() " Link "fseek()"} @EndNode @Node "gcvt()" gcvt()-Convert float to string Synopsis #include p = gcvt(v,dig,byuuffer); char *p; /* points to buffer */ double v; /* floating point value */ int dig; /* number of significant digits */ char *buffer; /* output buffer */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns The function returns a pointer to the buffer. See Also @{" ecvt() " Link "ecvt()"} , @{" fcvt() " Link "fcvt()"} @EndNode @Node "geta4()" geta4()-Establish addressability to the global data area Synopsis #include vzHWIoid geta4(void); Portability AmigaDOS @EndNode @Node "getasn()" getasn()-Get assigned device Synopsis #include dlist = getasn(name); struct DeviceList *dlist; /* pointer to device list entry */ /* for assignment */ const char *name; /* assigned name */ Portability AmigaDOS Returns NULL is returned if name cannot be located in the device list. NULL is defined in stddef.h. If {xcthe name is found, a pointer to the name's device node is returned. Some pointers in the device node are BCPL pointers, and strings are BCPL strings. See dos/dosextens.h for more information. See Also @{" getenv() " Link "getenv()"} , @{" putenv() " Link "putenv()"} @EndNode @Node "getc()" getc()-Get a character from a file Synopsis #include c = getc(fp); int c; /* return character or code */ FILE *fp; /* file pointer */ Portability | @{" ANSI " Link "Glossary - ANSI"} Returns If successful, the next input character is returned. Otherwise, this function returns EOF, which is defined in . In the event of an EOF return, error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. Most programmers treat any EOF return as an indication of end-of-file. However, if you want to distinguish errors from an end-of-file condition, you should reset @{" errno "~p; Link "errno"} before calling the function and then analyze its contents when you receive an EOF return. See Also @{" errno " Link "errno"} , @{" fgetc() " Link "fgetc()"} , @{" fgetchar() " Link "fgetchar()"} , @{" fopen() " Link "fopen()"} , @{" getchar() " Link "getchar()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getcd()" getcd()-Get current directory Synopsis #include error = getcd(drive,path); int error; /* 0 if successful */ int driv}H|~n(e; /* drive code */ char *path; /* points to path area (255 bytes recommended) */ Portability AmigaDOS Returns If the operation is successful, the function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" getcwd() " Link "getcwd()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getch()" getch()-Get a character from stdin immediately Synopisis #include c = getch(void); int c; /* return character or code */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns If successful, the next input character is returned. Otherwise, the function returns EOF, which is defined in . In the event of an EOF return, error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fgetc() " Link "fgetc()"} , _@{" fgetchar() " Link "fgetchar()"} , @{" fopen() " Link "fopen()"} , @{" getchar() " Link "getchar()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getchar()" getchar()-Get a character from stdin Synopsis #include c = getchar(void); int c; /* return character or code */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, the next input character is returned. Otherwise, the function returns EOF, which is defined in . In the event of an EOF return, error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fgetc() " Link "fgetc()"} , @{" fgetchar() " Link "fgetchar()"} , @{" fopen() " Link "fopen()"} , @{" getch() " Link "getch()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getclk()" getclk()-Get or change system clock Synopsis #include void getclk(clock); unsigned char clock[8]; >M Portability AmigaDOS See Also @{" chgclk() " Link "chgclk()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getcwd()" getcwd()-Get current working directory Synopsis #include p = getcwd(b,size); char *p; /*Same as b if successful, else NULL*/ char *b; /*Points to path buffer*/ int size; /*Size of path buffer*/ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns a pointer to the buffer. Otherwise, it returns a null pointer and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" getcd() " Link "getcd()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getdfs()" getdfs()-Get disk free space Synopsis #include error = getdfs(drive,info); int error; /*0 if successful*/ const char *drive; /*drive or volume ٶvname*/ /*NULL => current drive*/ struct InfoData *info; /*disk information*/ Portability AmigaDOS Returns A return value of 0 indicates success. If the drive code is invalid or no disk is mounted on that drive, then the return value is -1. No additional information is provided in @{" errno " Link "errno"} or @{" _OSERR " Link "_OSERR"}. @EndNode @Node "getenv()" getenv()-Get environment variable Synopsis #include var\S = getenv(name); char *var; /*environment variable pointer or NULL */ const char *name; /*environment variable name */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns NULL is returned if name cannot be located in the current environment. NULL is defined in stddef.h. See Also @{" free() " Link "free()"} , @{" malloc() " Link "malloc()"} , @{" putenv() " Link "putenv()"} @EndNode @Node "getfa()" getfa()-Get file attribute Synopsis #includeF$ fa = getfa(name); int fa; /* 1, -1, or 0 */ const char *name; /* file name */ Portability AmigaDOS Returns If the operation is unsuccessful, the function returns 0 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getfnl()" getfnl()-Get filename list Synopsis #include n = getfnl(fnp,fna,fnasize,attrL); int n; /* number of matching file names */ const char *fnp; /* file name pattern */ char *fna; /* file name array */ size_t fnasize; /* size of file name array */ int attr; /* file attribute */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function return value is the number of strings stored in the array, not including the terminating null string. A value of -1 is returned if the file name patte6trn is invalid or if there is not enough room in the file name array. In the first case, @{" _OSERR " Link "_OSERR"} will contain further error information. See Also @{" dfind() " Link "dfind()"} , @{" dnext() " Link "dnext()"} , @{" strbpl() " Link "strbpl()"} , @{" strsrt() " Link "strsrt()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getft()" getft()-Get file time() Synopsis #include ft = getft(name); long ft; /* file time() or -1 SPif error */ const char *name; /* file name */ Portability AmigaDOS Returns If getft() is successful, the file time() (a long integer) is returned. Otherwise, a value of -1 is returned. Additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" ctime() " Link "ctime()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "getmem()" getmem()-Get memory block (short) Synopsis [#include p = getmem(sbytes); void *p; /* block pointer */ unsigned int sbytes; /* number of bytes */ Portability OLD Returns A null pointer is returned if the block could not be allocated. Otherwise, a void pointer is returned, but it can be cast to any other pointer type. See Also @{" malloc() " Link "malloc()"} , @{" rlsmem() " Link "rlsmem()"} , @{" rlsml() " Link "rlsml()"} , @{" sizmem() " Link "sizmem()"} @EndNode @Node g"getml()" getml()-Get level 2 memory block (long) Synopsis #include p = getml(lbytes); void *p; /* block pointer */ long lbytes; /* number of bytes */ Portability OLD Returns A null pointer is returned if the block could not be allocated. Otherwise, a character pointer is returned, but it can be cast to any other pointer type. See Also @{" getmem() " Link "getmem()"} , @{" halloc() " Link "halloc()"} , @{" rlsmem() " Link "r_Slsmem()"} , @{" rlsml() " Link "rlsml()"} , @{" sizmem() " Link "sizmem()"} @EndNode @Node "getpath()" getpath()-Get the path for a specific directory/file Synopsis #include error = getpath(lock, path); int error; /* 0 if ok, -1 if error */ BPTR lock; /* input */ char *path; /* destination buffer */ Portability AmigaDOS Returns If getpath() is successful, it returns a zero; otherwise, it returns a -1. See Also @{" findpath() " LgHink "findpath()"} , @{" Lock() " Link "dos/Lock()"} and @{" UnLock() " Link "dos/UnLock()"} AmigaDOS Functions @EndNode @Node "getreg()" getreg()-Get 68000-specific registers Synopsis #include x = getreg(reg); /* obtain the current global static base */ long x; int reg; Portability @{" SAS/C " Link "Glossary - SASC"} Returns The getreg() function returns the current value of the register (a long integer). See Also @{" putreg() " Link "putregw()"} , @{" __emit() " Link "__emit()"} @EndNode @Node "gets()" gets()-Get string from stdin Synopsis #include p = gets(buffer); char *p; /*buffer pointer or NULL */ char *buffer; /*buffer pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the buffer argument unless an I/O error occurs, in which case a null pointer is returned, and @{" errno " Link "errno"} is set to describe the error. See Also P1 @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" feof() " Link "feof()"} , @{" ferror() " Link "ferror()"} , @{" fgetc() " Link "fgetc()"} , @{" fgets() " Link "fgets()"} , @{" getc() " Link "getc()"} @EndNode @Node "GfxBase" GfxBase-Graphics Library Vector Synopsis extern struct library * GfxBase; GfxBase = OpenLibrary("graphics.library",ver); Description This external location is used by various Amiga library routines that interface with the ROMIwo Kernel graphics system functions. It must be initialized by an @{" OpenLibrary() " Link "exec/OpenLibrary()"} call before any of the graphics functions documented in the Amiga ROM Kernel manuals can be called. It is expected to contain the base address of the graphics library vector table. You must close the library before your program terminates. Portability AmigaDOS @EndNode @Node "gmtime()" gmtime()-Unpack Greenwich Mean Time (GMT) Synopsis #include ut = gmtime(t); struct tm *ut; const time_t *t; Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" asctime() " Link "asctime()"} , @{" ctime() " Link "ctime()"} , @{" localtime() " Link "localtime()"} , @{" time() " Link "time()"} @EndNode @Node "halloc()" halloc()-Allocate a huge memory block Synopsis #include p = halloc(n); void *p; /* pointer to allocated memory */ unsigned long n; /* number of bytes to allocate */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The pointer is null if the request cannot be fulfilled. See Also @{" free() " Link "free()"} , @{" malloc() " Link "malloc()"} , @{" sbrk() " Link "sbrk()"} @EndNode @Node "iabs()" iabs()-Integer absolute value Synopsis #include ai = iabs(i); int ai,i; Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns an integer holding the absolute value of the` parameter. See Also @{" abs() " Link "abs()"} , @{" fabs() " Link "fabs()"} , @{" labs() " Link "labs()"} @EndNode @Node "IntuitionBase" IntuitionBase-Intuition Library Vector Synopsis extern struct library * IntuitionBase; IntuitionBase = OpenLibrary("intuition.library",ver); Description This external location is used by various Amiga library routines that interface with the Intuition system functions. It must be initialized by an @{" OpenLibrary() " LiConk "exec/OpenLibrary()"} call before any of the functions documented in the Amiga Intuition manuals can be called. It is expected to contain the base address of the Intuition library vector table. You must close the library before your program terminates. Portability AmigaDOS @EndNode @Node "iomode()" iomode()-Change mode of level 1 file Synopsis #include error = iomode(fh,mode); int error; /* error code */ int fh; /* file h randle */ int mode; /* 0 => translated mode */ /* 1 => raw mode */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns A non-zero return value indicates that the specified file handle is not associated with a level 1 file. See Also @{" getfc " Link "getfc"} , @{" open() " Link "open()"} @EndNode @Node "isalnum()" isalnum()-Test if alphanumeric character Synopsis #include t = isalnum(c); int t; /* 0 i1wf false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is an alphanumeric character, zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "islpha()" isalpha()-Test if alphabetic character Synopsis #include t = isalpha(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" -_UANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is an alphabetic character, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isascii()" isascii()-Test if ASCII character Synopsis #include t = isascii(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns a non-zero value if c is an ASCII character, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isatty()" isatty()-Test file descriptor for terminal Synopsis #include rc = isatty(fd) int fd; /* level 1 file descriptor */ int rc; /* return code */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the file descriptor is associated with a terminal device, the routine returns 1. Otherwise, it returns 0. See AlL+so @{" open() " Link "open()"} @EndNode @Node "iscntrl()" iscntrl()-Test if control character Synopsis #include t = iscntrl(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is a control character, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "iscsym()" iscsym()-Test if C symbol character Synopsis #include t = iscsym(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns a non-zero value if c is a valid C symbol character, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "iscsymf()" iscsymf()-Test if C symbol lead character Synopsis #include t = iscsymf(c); int t; v /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns a non-zero value if c is a valid leading C symbol character, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isdigit()" isdigit()-Test if decimal digit character (0 to 9) Synopsis #include t = isdigit(c); int t; /* 0 if false, non-zero if true */ int c: /* characMaVter to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is a decimal digit, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isgraph()" isgraph()-Test if graphic character (anything but space, ' ') Synopsis #include t = isgraph(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is anything other than a space character (' '), and a zero if it is a space. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "islower()" islower()-Test if lower case character Synopsis #include t = islower(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero valu%e if c is a lower case letter, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isprint()" isprint()-Test if printable character Synopsis #include t = isprint(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is any printable character other than space, and a zero if c is a space or a  non-printable character (such as a control character). See Also @{" __ctype " Link "__ctype"} @EndNode @Node "ispunct()" ispunct()-Test if punctuation character Synopsis #include t = ispunct(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is anything other than a space or an alphanumeric character, and a z3ero if it is a space or an alphanumeric character. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isspace()" isspace()-Test if space character Synopsis #include t = isspace(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is a C space character (including ' ', '\n', '\f', etc.), and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isupper()" isupper()-Test if upper case character Synopsis #include t = isupper(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is an upper case letter, and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "isxdigit()" isxdigit()-TeGst if hex digit character Synopsis #include t = isxdigit(c); int t; /* 0 if false, non-zero if true */ int c: /* character to test */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero value if c is a valid hexidecimal digit (including both upper and lower case A-F), and a zero if not. See Also @{" __ctype " Link "__ctype"} @EndNode @Node "jrand48()" jrand48()-Generate random long (external seed) S!ԑynopsis #include z = jrand48(seed); long z; /* random long */ unsigned short seed[3]; /* seed value (high bits in seed[0]) */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns The jrand48() function returns signed long integers uniformly distributed over the interval from -2**31 to 2**31-1. See Also @{" mrand() " Link "mrand()"} , @{" rand() " Link "rand()"} , @{" srand() " Link "srand()"} , @{" srand48() " Link "srand48(xD)"} , @{" lcong48() " Link "lcong48()"} @EndNode @Node "labs()" labs()-Long integer absolute value Synopsis #include al = labs(l); long int al,l; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a long integer holding the absolute value of the parameter. See Also @{" abs() " Link "abs()"} , @{" fabs() " Link "fabs()"} , @{" iabs() " Link "iabs()"} @EndNode @Node "lcong48()" lcong48()-Set linear congruence para߄Nmeters Synopsis #include void lcong48(parm); unsigned short parm[7]; /* parameters */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" jrand48() " Link "jrand48()"} , @{" rand() " Link "rand()"} , @{" seed48() " Link "seed48()"} , @{" srand() " Link "srand()"} , @{" srand48() " Link "srand48()"} @EndNode @Node "ldexp()" ldexp()-Combine float value Synopsis #include v = ldexp(d,x); double v; /* value */ doubR-le d; /* fraction */ int x; /* exponent */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a double holding the result of the above equation. See Also @{" fmod() " Link "fmod()"} , @{" frexp() " Link "frexp()"} , @{" __matherr() " Link "__matherr()"} , @{" modf() " Link "modf()"} @EndNode @Node "ldiv()" ldiv()-Return long quotient and remainder for divide Synopsis #include res = ldiv(numer, denom); S ldiv_t res; /* resulting quotient and remainder */ long int numer; /* numerator for the divide */ long int denom; /* denominator for the divide */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a structure containing both the quotient and remainder. The structure is defined in stdlib.h as follows: typedef struct { long int quot; long int rem; } ldiv_t; See Also @{" div() " Link "Ndiv()"} @EndNode @Node "localeconv()" localeconv()-Return info on locale formatting conventions Synopsis #include lcl = localeconv(void); struct lconv *lcl; /* Locale information structure */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to the @{" lconv " Link "lconv"} structure for the current locale. See Also @{" setlocale() " Link "setlocale()"} @EndNode @Node "localtime()" localtime()-Unpack֊u local time Synopsis #include ut = localtime(t); struct tm *ut; const time_t *t; Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" asctime() " Link "asctime()"} , @{" ctime() " Link "ctime()"} , @{" gmtime() " Link "gmtime()"} , @{" time() " Link "time()"} @EndNode @Node "log()" log()-Natural logarithm function Synopsis #include r = log(x); double r, x; Portability @{" ANSI " Link "Glossary - ANSI"} Returns  This function returns a double that contains the base E logarithm of the parameter. See Also @{" log10() " Link "log10()"} , @{" __matherr() " Link "__matherr()"} @EndNode @Node "log10()" log10()-Base 10 logarithm function Synopsis #include r = log10(x); double r, x; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a double the base 10 logarithm of the parameter. See Also @{" log() " Link "log()"} , @{" __mathEZierr() " Link "__matherr()"} @EndNode @Node "longjmp()" longjmp()-Perform long jump Synopsis #include void longjmp(save,value); jmp_buf save; /* address of save area */ int value; /* return value */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" exit() " Link "exit()"} , @{" setjmp() " Link "setjmp()"} @EndNode @Node "lqsort()" lqsort()-Sort an array of long integers Synopsis #include void lqsort(la,n); V) long *la; /* pointer to long int array */ size_t n; /* number of elements in array */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" dqsort() " Link "dqsort()"} , @{" fqsort() " Link "fqsort()"} , @{" qsort() " Link "qsort()"} , @{" sqsort() " Link "sqsort()"}, @{" tqsort() " Link "tqsort()"} @EndNode @Node "lrand48()" lrand48()-Generate random positive long (internal seed) Synopsis #include y = lrand48(void); long y; />D* random positive long */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns non-negative long integers uniformly distributed over the interval from -2**31 to 2**31-1. See Also @{" nrand() " Link "nrand()"} , @{" rand() " Link "rand()"} , @{" srand() " Link "srand()"} , @{" srand48() " Link "srand48()"} @EndNode @Node "lsbrk()" lsbrk()-Allocate memory Synopsis #include p = lsbrk(lbytes); void *p; /* block poi XZXnter */ long lbytes; /* number of bytes */ Portability OLD Returns This function returns the address of the block just allocated. An error is indicated by a null pointer. See Also @{" getmem() " Link "getmem()"} , @{" malloc() " Link "malloc()"} , @{" rbrk() " Link "rbrk()"} , @{" sbrk() " Link "sbrk()"} @EndNode @Node "lseek()" lseek()-Set level 1 file position Synopsis #include apos = lseek(fh,rpos,mode); long apos; /* absolute file  position */ int fh; /* file handle */ long rpos; /* relative file position */ int mode; /* seek mode */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" errno " Link "errno"} , @{" open() " Link "open()"} , @{" _OSERR " Link "_OSERR"} , @{" tell() " Link "tell()"} @EndNode @Node "lstat()" lstat()-Get file status Synopsis #include rc = lstat(file, st); const char *file; /* file name */ struct stat *st; /* stat info struc us'|ture */ int rc; /* return code */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" chmod() " Link "chmod()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "__main()" __main()-Standard preprocessing for the main module Synopsis #inc lude __stdargs __main(line); char *line; /* ptr to command line that caused execution */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" main() " Link "main()"} , @{" __tinymain() " Link "__tinymain()"} @EndNode @Node "main()" main()-Your main or principal function Synopsis #include "workbench/startup.h" void main(argc,argv); int argc; /* argument count */ union { char *args[]; struct WBStartup *msg;  _ } argv; /* argument vector */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns When main() returns to its caller (normally _main.c), the program exits to AmigaDOS with a termination code of 0. If you want to pass a non-zero termination code back to AmigaDOS, use the @{" exit() " Link "exit()"} or @{" __exit() " Link "__exit()"} function. See Also @{" exit() " Link "exit()"} , @{" __exit() " Link "__exit()"} , @{" __main() " Link "__main()"} K @{" __tinymain() " Link "__tinymain()"} @EndNode @Node "malloc()" malloc()-Allocate memory Synopsis #include b = malloc(n); void *b; /*block pointer */ size_t n; /*number of bytes */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A null pointer is returned if there is not enough space for the requested block. See Also @{" calloc() " Link "calloc()"} , @{" free() " Link "free()"} , @{" getmem() " Link "getmem()"} , @{" rbJrk() " Link "rbrk()"} , @{" realloc() " Link "realloc()"} , @{" rlsmem() " Link "rlsmem()"} , @{" sbrk() " Link "sbrk()"} @EndNode @Node "MathBase" MathBase-FFP Library Vector Synopsis extern struct library * MathBase; MathBase = OpenLibrary("mathffp.library",ver); Description This external location is used to interface with the Motorola Fast Floating Point library routines provided by Amiga. It is initialized by an @{" OpenLibrary() " Link "exec/OpenLibrary()(]"} call in the __fpinit routine when a program compiled with the FFP option starts. It contains the base address of the FFP math library vector table. If you make direct calls to the Amiga FFP functions you must first initialize this location by calling @{" OpenLibrary() " Link "exec/OpenLibrary()"}. You must close the library before your program terminates. Portability AmigaDOS @EndNode @Node "__matherr()" __matherr()-Math error handler Synopsis #include! a = __matherr(x); int a; /* action code */ struct __exception *x; /* exception vector */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns non-zero to indicate that the proposed return value in the exception vector has been changed and that the new value should be used. A zero return indicates that the proposed return value is OK. See Also @{" __except() " Link "__except()"} X!, @{" _FPERR " Link "_FPERR"} @EndNode @Node "MathTransBase" MathTransBase-FFP Transcendental Library Vector Synopsis extern struct library * MathTransBase; MathTransBase = OpenLibrary("mathtrans.library",ver); Description This external location is used to interface with the Motorola Fast Floating Point format transcendental function library routines provided by Amiga. It is initialized by an @{" OpenLibrary() " Link "exec/OpenLibrary()"} call when a program c$2ompiled with the FFP option starts. It contains the base address of the FFP transcendental math library vector table. If you make direct calls to the Amiga FFP transcendental functions you must first initialize this location by calling @{" OpenLibrary() " Link "exec/OpenLibrary()"}. You must close the library before your program terminates. Portability AmigaDOS @EndNode @Node "max()" max()-Compute maximum of two values Synopsis #include v = max(Ja,b); Portability @{" UNIX " Link "Glossary - UNIX"} Returns This macro returns the largest of the two parameters. See Also @{" min() " Link "min()"} @EndNode @Node "mblen()" mblen()-Determine length of multibyte character Synopsis #include length = mblen(s, n); int length; /* length or state information */ const char *s; /* pointer to characters or NULL */ size_t n; /* maximum number of characters to look at */ Portability @a-{" ANSI " Link "Glossary - ANSI"} Returns This function returns the amount of storage needed to hold result string. See Also @{" mbstowcs() " Link "mbstowcs()"} , @{" mbtowc() " Link "mbtowc()"} @EndNode @Node "mbstowcs()" mbstowcs()-Convert multibyte string to wide character string Synopsis #include length = mbstowcs(pwcs, s, n); size_t length; /* length or state information */ wchar_t *pwcs; /* pointer to wide character string .4 */ const char *s; /* pointer to characters or NULL */ size_t n; /* maximum number of characters to look at */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the length of the result string. See Also @{" mblen() " Link "mblen()"} , @{" mbtowc() " Link "mbtowc()"} @EndNode @Node "mbtowc()" mbtowc()-Maps a multibyte character to a wide character Synopsis #include length = mbtowc(pwc, s, n); % int length; /* length or state information */ wchar_t *pwc; /* pointer to wide character */ const char *s; /* pointer to characters or NULL */ size_t n; /* maximum number of characters to look at */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the length of the multibyte character defined by the locale information. If s is NULL or if n is equal to zero, this function returns \9a zero. See Also @{" mblen() " Link "mblen()"} , @{" mbtowc() " Link "mbtowc()"} @EndNode @Node "memccpy()" memccpy()-Copy a memory block up to a char Synopsis #include s = memccpy(to,from,c,n); void *s; /* return pointer */ void *to; /* destination pointer */ const void *from; /* source pointer */ int c; /* character value */ unsigned n; /* number of bytes */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns It returns a pointer to the character after c in the from block, or a null pointer if c was not found in the first n characters. See Also @{" memcpy() " Link "memcpy()"} , @{" strcpy() " Link "strcpy()"} @EndNode @Node "memchr()" memchr()-Find a character in a memory block Synopsis #include s = memchr(a,c,n); void *s; /* pointer to character in block */ const void *a; /* block pointers */ int c; /* characterل value */ size_t n; /* number of bytes */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to the first occurrence of the specified character in the block, or a null pointer if the character is not found. @EndNode @Node "_MemCleanup()" _MemCleanup()-Deallocate all allocated memory Synopsis #include void _MemCleanup(void); Portability AmigaDOS @EndNode @Node "memcmp()" memcmp()-Compare two memor̫y blocks Synopsis #include x = memcmp(a,b,n); int x; /* return value */ const void *a,*b; /* block pointers */ size_t n; /* number of bytes */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns an integral value as follows: Return Meaning ------ ------- Negative First block sorts below second Zero First block equals second Positive First block 3{ sorts above second @EndNode @Node "memcpy()" memcpy()-Copy a memory block Synopsis #include s = memcpy(to,from,n); void *s; /* return pointer */ void *to; /* destination pointer */ const void *from; /* source pointer */ size_t n; /* number of bytes */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to the destination block. See Also @{" memccpy() " Link "memccpy()"} , i,@{" memmove() " Link "memmove()"} , @{" movmem() " Link "movmem()"} , @{" strcpy() " Link "strcpy()"} @EndNode @Node "memmove()" memmove()-Copy bytes in memory Synopsis #include p = memmove(dest, source, nbytes); void *p; /* same as dest */ void *dest; /* destination for moved bytes */ const void *source; /* source of bytes for move */ size_t nbytes; /* number of bytes to be ʏtransferred */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to the destination block. See Also @{" memcpy() " Link "memcpy()"} , @{" movmem() " Link "movmem()"} , @{" strcpy() " Link "strcpy()"} @EndNode @Node "memset()" memset()-Set a memory block to a value Synopsis #include s = memset(to,c,n); void *s; /* return pointer */ void *to; /* destination pointer */ size_t n; /* number of bytes r|*/ int c; /* character value */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to the destination block. See Also @{" setmem() " Link "setmem()"} @EndNode @Node "_MemType" _MemType-Type of memory desired Synopsis #include extern long _MemType; Description The external long _MemType represents the type memory to be allocated by any of the memory allocation routines. The default is MEMF_ANY tY. You can set _MemType to any of the types defined in exec/memory.h. Portability AmigaDOS See Also @{" malloc() " Link "malloc()"} , @{" AllocMem " Link "AllocMem"} in autodocs from Commodore @EndNode @Node "min()" min()-Compute miminum of two values Synopsis #include v = min(a,b); Portability @{" UNIX " Link "Glossary - UNIX"} Returns This macro returns the smallest of the two parameters. See Also @{" max() " Link "max()"} @EndNode @NHb     !O>ode "mkdir()" mkdir()-Make a new directory Synopsis #include error = mkdir(path); int error; /* 0 if successful */ const char *path; /* points to new directory path string */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, this function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno""FiG} , @{" _OSERR " Link "_OSERR"} , @{" rmdir() " Link "rmdir()"} @EndNode @Node "mktime()" mktime()-Convert broken down time to time_t value Synopsis #include t = mktime(ts); time_t t; /* number of seconds since 1/1/70 */ struct tm *ts; /* broken down time structure */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of seconds since January 1, 1970. See Also @{" time() " Link "time()"} @EndNode#ʅ[ @Node "_MNEED" _MNEED-minimum Dynamic Memory Needed Synopsis extern long _MNEED; /* to reference default value */ long _MNEED = n; /* to set initial value */ Description _MNEED indicates the minimum number of bytes that must be provided as the heap space for use by the various memory allocators. This space, whose size is rounded up to be an even multiple of @{" _MSTEP " Link "_MSTEP"}, is the initial block of memory in the local memory pool. Portability$i @{" SAS/C " Link "Glossary - SASC"} See Also @{" calloc() " Link "calloc()"} , @{" malloc() " Link "malloc()"} , @{" _MSTEP " Link "_MSTEP"} @EndNode @Node "modf()" modf()-Split floating point value Synopsis #include x = modf(y,p); double x; /* fractional part of y */ double y; /* number to be broken up */ double *p; /* integral part of y */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns The function return value is the frac%ltional part of y, and the integral part is placed in the double pointed to by p. See Also @{" fmod() " Link "fmod()"} @EndNode @Node "__montbl" __montbl-Array of months by name Synopsis extern char *__montbl[]; Description The external array __montbl contains twelve pointers to character strings representing the months of the year. Each string is three bytes long, plus a null terminator. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" &f_\__months " Link "__months"} , @{" __daytbl " Link "__daytbl"} @EndNode @Node "__months" __months-Array month lengths Synopsis extern char __months[]; Description The external array __months contains twelve characters, each representing number of days in a specific month (in a non-leap year.) Your programs must account for leap years when dealing with February. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __daytbl " Link "__daytbl"} , @{" __'ΦpKmontbl " Link "__montbl"} @EndNode @Node "movmem()" movmem()-Move a memory block Synopsis #include void movmem(from,to,n); const void *from; /* source pointer */ void *to; /* destination pointer */ unsigned n; /* number of bytes */ Portability @{" UNIX " Link "Glossary - UNIX"} @EndNode @Node "mrand48()" mrand48()-Generate random long (internal seed) Synopsis #include z = mrand48(void); long z; /* rand(uom long */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns signed long integers uniformly distributed over the interval from -2**31 to 2**31-1. See Also @{" jrand48() " Link "jrand48()"} , @{" lcong48() " Link "lcong48()"} , @{" nrand48() " Link "nrand48()"} , @{" rand() " Link "rand()"} , @{" srand() " Link "srand()"} @EndNode @Node "__msflag" __msflag-MS-DOS File Pattern Flag Synopsis extern int __msflag; Description This)dۋ external integer is used by the file name pattern matching functions to specify AmigaDOS or MSDOS wildcard characters. If __msflag is non-zero then MSDOS file name patterns are used. The default is to use AmigaDOS file name patterns. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" dfind() " Link "dfind()"} , @{" getfnl() " Link "getfnl()"} @EndNode @Node "_MSTEP" _MSTEP-Memory pool increment size Synopsis extern int _MSTEP; Description Th*O]kis external integer is used by the memory allocation functions. It specifies the minimum amount of memory that will be allocated from the system for the local memory pool. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" free() " Link "free()"} , @{" getmem() " Link "getmem()"} , @{" malloc() " Link "malloc()"} , @{" rlsmem() " Link "rlsmem()"} @EndNode @Node "nrand48()" nrand48()-Generate random positive long (external seed) Synopsis #include y = nrand48(seed); long y; /* random positive long */ unsigned short seed[3]; /* seed value (high bits in seed[0]) */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns non-negative long integers uniformly distributed over the interval from 0 to 2**31-1. See Also @{" jrand48() " Link "jrand48()"} , @{" lcong48() " Link "lcong48()"} , @{" lrand() " Link "lrand()"} , @{" nrand48() " Link "nrand48()"} , @{" r,Uand() " Link "rand()"} , @{" srand() " Link "srand()"} @EndNode @Node "__nufbs" __nufbs-Count of level 1 file handle slots Synopsis #include extern int __nufbs; Description The external integer __nufbs indicates how many level 1 file handle slots are available in the __ufbs array. By default, this number is 40, although you can declare a larger __ufbs structure and __nufbs count in your program. Setting __nufbs does not affect the number of file h-sandles because storage must be allocated. In versions 5.10 and earlier, this data name was called _nufbs. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __ufbs " Link "__ufbs"} @EndNode @Node "offsetof()" offsetof()-Get the byte offset of a structure member Synopsis #include size_t offsetof(type, element) Portability @{" ANSI " Link "Glossary - ANSI"} Returns This macro returns the byte offset of element, within the structure. * type. @EndNode @Node "onbreak()" onbreak()-Plant break trap Synopsis #include error = onbreak(func); int error; /* 0 if successful */ int (*func)(void); /* pointer to function to be called */ Portability AmigaDOS Returns The onbreak() function returns 0 if it was successful. The break trap function should return 0 to continue execution and non-zero to abort. See Also @{" chkabort() " Link "chkabort()"} , @{" signal() " Link "sig/֞Enal()"} @EndNode @Node "onexit()" onexit()-Set an exit trap Synopsis #include success = onexit(func); int success; /* non-zero for success */ void (*func)(void); /* trap function pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A zero is returned for success and a non-zero value is returned if an error is encountered. See Also @{" exit() " Link "exit()"} @EndNode @Node "open()" open()-open a level 1 file Sy0$Fnopsis #include fh = open(name,mode,prot); int fh; /* file handle */ const char *name; /* file name */ int mode; /* access mode */ int prot; /* protection mode (O_CREAT only) */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns a file handle, which is an integer equal to or greater than 0. Otherwise, it returns -1 and places error information1M in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" chmod() " Link "chmod()"} , @{" close() " Link "close()"} , @{" creat() " Link "creat()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "opendir()" opendir()-Initiate directory operation Synopsis #include dfd = opendir(dirname); DIR *dfd; /* return directory file descriptor */ const char *dirname; /* directory name */ Portability 2ٔpӗ @{" UNIX " Link "Glossary - UNIX"} Returns If successful, this function returns a pointer to a handle that contains the following information: typedef struct _dirdesc { long dd_fd; /* system() directory lock */ long dd_loc; /* current directory posn */ long dd_size; /* size of dd_buf in bytes */ char *dd_buf; /* system() structure info */ } DIR; If it is not successful, this function returns a nul35z"l. See Also @{" readdir() " Link "readdir()"} , @{" seekdir() " Link "seekdir()"} , @{" telldir() " Link "telldir()"} , @{" closedir() " Link "closedir()"} @EndNode @Node "_OSERR" _OSERR-DOS Error Information Synopsis #include extern int _OSERR; Description _OSERR contains error information returned by AmigaDOS after a system call has failed. In general, the @{" SAS/C " Link "Glossary - SASC"} library resets _OSERR at the beginning of any function th4ۇi3at makes AmigaDOS system calls. Then, if a system call fails during that function, the system error code is saved in _OSERR. Portability AmigaDOS See Also AmigaDOS Technical Reference Manual , @{" errno " Link "errno"} , @{" poserr() " Link "poserr()"} @EndNode @Node "__os_errlist" __os_errlist-Array of operating system error messages Synopsis struct { short errnum; char *msg; } __os_errlist[]; Portability @{" SAS/C " Link "Glossary - SASC"} See Also 5 @{" _OSERR " Link "_OSERR"} , @{" __os_nerr " Link "__os_nerr"} , @{" poserr() " Link "poserr()"} @EndNode @Node "__os_nerr" __os_nerr-Highest valid error number in the __os_errlist array Synopsis int __os_nerr; /* Highest valid error number */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" _OSERR " Link "_OSERR"} , @{" __os_errlist " Link "__os_errlist"} , @{" poserr() " Link "poserr()"} @EndNode @Node "ovlyMgr()" ovlyMgr()-Overlay manager call p6`fVoint Synopsis MOVEQ #ovent,D0 JMP ovlyMgr() Portability AmigaDOS See Also @{" __stdargs " Link "__stdargs"} @EndNode @Node "perror()" perror()-Print error message Synopsis #include void perror(s); const char *s; /* message prefix */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" errno " Link "errno"} , @{" poserr() " Link "poserr()"} , @{" __sys_errlist " Link "__sys_errlist"} , @{" __sys_nerr " Link "__sys_nerr"} @7ޟEndNode @Node "poserr()" poserr()-Print AmigaDOS error message Synopsis #include error = poserr(s); int error; /* contents of @{" _OSERR " Link "_OSERR"} */ const char *s; /* message prefix */ Portability AmigaDOS Returns The function returns the contents of @{" _OSERR " Link "_OSERR"} so you can test for an error condition and print a message in one step, as in the example: if (poserr("foo")) goto abort; See Also @{" _OSERR " Link8ߩDL "_OSERR"} , @{" __os_errlist " Link "__os_errlist"} , @{" __os_nerr " Link "__os_nerr"} , @{" perror() " Link "perror()"} @EndNode @Node "pow()" pow()-raise a number to a power Synopsis #include r = pow(x,y); double r, x, y; Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" __matherr() " Link "__matherr()"} , @{" pow2() " Link "pow2()"} @EndNode @Node "pow2()" pow2()-raise 2 to a power Synopsis #include r = pow2(x); d9<9wouble r, x; Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value r is the value 2**x. See Also @{" __matherr() " Link "__matherr()"} @EndNode @Node "printf()" printf()-Formatted print to stdout Synopsis #include length = printf(fmt,arg1,arg2,...); int length; /* number of characters generated */ const char *fmt; /* format string */ .... arg ; /* arguments */ Portability @{" ANSI " Link "Glossary:w - ANSI"} Returns This function returns the number of output characters generated. See Also @{" fprintf() " Link "fprintf()"} , @{" sprintf() " Link "sprintf()"} , @{" Formatted Output Specifiers " Link "Formatted Output Specifiers"} @EndNode @Node "_priority" _priority-Default priority for a background program Synopsis long _priority=-5; Description _priority is used by the cback.o startup code to indicate the priority at which to start the background program;Ru.. A value of 0 is the normal priority while larger values run at higher priority. This number is limited to the range -128 to 127, inclusive. If you do not link with cback.o, this variable is ignored. Portability AmigaDOS See Also @{" _procname " Link "_procname"} , @{" __stack " Link "__stack"} @EndNode @Node "_procname" _procname-Process name for spawned program Synopsis char *_procname="MyBackgroundProcess"; Description _procname is the name that c<{+back.o uses when spawning a background process. You may choose any name, but should stick to something that is meaningful for your program. If you do not link with cback.o, this variable is ignored. Portability AmigaDOS See Also @{" _priority " Link "_priority"} , @{" __stack " Link "__stack"} @EndNode @Node "putc()" putc()-Put a character to a level 2 file Synopsis #include r = putc(c,fp); int r; /* EOF or c */ int c; /* Char==|acter to be output */ FILE *fp; /* Level 2 file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, this function returns the character to be output; otherwise, it returns EOF. For disk files, an EOF return usually means that the disk is full. However, this type of return can also occur if the device is write-protected or if a write error occurs. In any case, additional error information can be found in @{" errno " Link "errn>Io"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "putchar()" putchar()-Put a character to stdout Synopsis #include r = putchar(c); int r; /* EOF or c */ int c; /* Character to be output */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If successful, this function returns the character that was output; otherwise, it returns? b EOF. For disk files, an EOF return usually means that the disk is full. However, this type of return can also occur if the device is write-protected or if a write error occurs. In any case, additional error information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fopen() " Link "fopen()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "putenv()" putenv()-Put string into environment Synopsis #@޼include error = putenv(env); int error; /* 0 if successful */ const char *env; /* environment string */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If this function is unable to write to env:name, it returns a non-zero return code. See Also @{" getenv() " Link "getenv()"} @EndNode @Node "putreg()" putreg()-Set up 68000-specific registers Synopsis #include void putreg(reg,x); long x; /* value of reA g */ int reg; /* register number */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" getreg() " Link "getreg()"} @EndNode @Node "puts()" puts()-Put string to stdout Synopsis #include error = puts(s); int error; /*non-zero if error*/ const char *s; /*string pointer*/ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If an error occurs, the return value is -1; otherwise, it is 0. Additional error informationB`H can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"}, @{" ferror() " Link "ferror()"} , @{" fopen() " Link "fopen()"} , @{" fputc() " Link "fputc()"} , @{" fputs() " Link "fputs()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "qsort()" qsort()-Sort a data array Synopsis #include void qsort(a,n,size,cmp); void *a; /* data array pointer */ size_t n; /* number of elemeC6nts in array */ size_t size; /* element size in bytes */ /* pointer to comparison function */ int (*cmp)(const void *, const void *); Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" dqsort() " Link "dqsort()"} , @{" fqsort() " Link "fqsort()"} , @{" lqsort() " Link "lqsort()"} , @{" sqsort() " Link "sqsort()"} , @{" tqsort() " Link "tqsort()"} @EndNode @Node "raise()" raise()-Generate a signal Synopsis #include ret = Dyraise(sig); int ret; /* 0 if successful, nonzero if failed */ int sig; /* signal() to generate */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A non-zero return value indicates failure. See Also @{" signal() " Link "signal()"} , @{" __matherr() " Link "__matherr()"} , @{" onbreak() " Link "onbreak()"} , @{" _CXBRK() " Link "_CXBRK()"} , @{" _CXFERR() " Link "_CXFERR()"} @EndNode @Node "rand()" rand()-Generate a randoE[m number Synopsis #include x = rand(void); int x; /* random number */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns an integer value as noted above. See Also @{" drand48() " Link "drand48()"} , @{" srand() " Link "srand()"} @EndNode @Node "rawcon()" rawcon()-Set/unset raw console input. Synopsis #include error = rawcon(flag); int error; /* 0 on success */ int flag; F K( /* non-zero for raw, 0 for non-raw */ Portability AmigaDOS Returns A non-zero return value indicates failure. See Also @{" getch() " Link "getch()"} , @{" getchar() " Link "getchar()"} @EndNode @Node "rbrk()" rbrk()-Release memory Synopsis #include error = rbrk(void); int error; /* 0 if successful */ Portability OLD Returns This function returns 0 if successful. See Also @{" getmem() " Link "getmem()"} , @{" lsbrk() " LG_ink "lsbrk()"} , @{" malloc() " Link "malloc()"} , @{" sbrk() " Link "sbrk()"} @EndNode @Node "read()" read()-read from a level 1 file Synopsis #include count = read(fh,buffer,length); int count; /* actual bytes read or written */ int fh; /* file handle */ void *buffer; /* data buffer */ unsigned int length; /* number of bytes to read or write */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If thHdv;e operation is successful, the function returns the actual number of bytes transferred. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" close() " Link "close()"} , @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} , @{" open() " Link "open()"} , @{" write() " Link "write()"} @EndNode @Node "readdir()" readdir()-read directory element Synopsis #include dptr = readdirIU (dfd); struct dirent *dptr; /* pointer to a directory entry */ DIR *dfd; /* directory file descriptor */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns a pointer to a struct dirent which is the next directory entry. If readdir() reaches the end of the directory list or if an error occurs, a null is returned. For errors, the error information is placed in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. SeJ-Be Also @{" errno " Link "errno"} , @{" closedir() " Link "closedir()"} , @{" _OSERR " Link "_OSERR"} , @{" opendir() " Link "opendir()"} , @{" seekdir() " Link "seekdir()"} , @{" telldir() " Link "telldir()"} @EndNode @Node "readlocale()" readlocale()-read and initialize a new locale Synopsis #include ret = readlocale(locale); struct __locale *ret; /* Pointer to the read locale or NULL */ const char *locale; /* Identifies the type of environmenKWgt */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns a null if the locale is missing or invalid. See Also @{" setlocale() " Link "setlocale()"} @EndNode @Node "realloc()" realloc()-reallocate level 3 memory Synopsis #include nb = realloc(b,n); void *b; /* block pointer */ size_t n; /* number of bytes */ void *nb; /* new block pointer */ Portability @{" ANSI " Link "Glossary - ANL (SI"} Returns This function returns a null pointer if there is not enough space for the requested block. In this case, the original block b is unchanged. See Also @{" calloc() " Link "calloc()"} , @{" free() " Link "free()"} , @{" getmem() " Link "getmem()"} , @{" malloc() " Link "malloc()"} , @{" rlsmem() " Link "rlsmem()"} , @{" sbrk() " Link "sbrk()"} , @{" rbrk() " Link "rbrk()"} @EndNode @Node "remove()" remove()-remove a file Synopsis #include M/ error = remove(name); int error; /* non-zero if error */ const char *name; /* file name */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If a non-zero value is returned, some type of error occurred, and additional information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. The most common errors occur when you try to remove a file that doesn't exist, that is marked as read-only, or is in use. See Also @{Ng" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} , @{" unlink() " Link "unlink()"} @EndNode @Node "rename()" rename()-rename a file Synopsis #include error = rename(old,new); int error; /* 0 for success, nonzero for error */ const char *old; /* old file name */ const char *new; /* new file name */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If the function fails, it returns a nonzero integer and places additionaO׊?l error information into @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. If it is successful, it returns a 0. @EndNode @Node "repmem()" repmem()-Replicate values through a block Synopsis #include void repmem(to,vt,nv,nt); void *to; /* destination pointer */ const void *vt; /* value template */ size_t nv; /* number of bytes in template */ size_t nt; /* number of templates in block */ Portability @{" UP~}kNIX " Link "Glossary - UNIX"} @EndNode @Node "rewind()" rewind()-Reset level 2 file position to first byte Synopsis #include void rewind(fp); FILE *fp; /* file pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" errno " Link "errno"} , @{" fseek() " Link "fseek()"} , @{" fopen() " Link "fopen()"} , @{" _OSERR " Link "_OSERR"} , @{" lseek() " Link "lseek()"} , @{" tell() " Link "tell()"} @EndNode @Node "rewinddir()" rewinddirQuy()-Restart directory operation Synopsis #include rewinddir(dfd); DIR *dfd; /* dir file descriptor */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" closedir() " Link "closedir()"} , @{" opendir() " Link "opendir()"} , @{" readdir() " Link "readdir()"} , @{" seekdir() " Link "seekdir()"} , @{" telldir() " Link "telldir()"} @EndNode @Node "rlsmem()" rlsmem()-Release a memory block Synopsis #include void rlsmem(p,sbyteR.9s); void *p; /* block pointer */ unsigned int sbytes; /* number of bytes */ Portability OLD See Also @{" free() " Link "free()"} , @{" rlsml() " Link "rlsml()"} @EndNode @Node "rlsml()" rlsml()-Release a memory block Synopsis #include void rlsml(p,lbytes); void *p; /* block pointer */ long lbytes; /* number of bytes */ Portability OLD See Also @{" free() " Link "free()"} , @{" rlsmem() " Link "rlsmem()S "} @EndNode @Node "rmdir()" rmdir()-remove a directory Synopsis #include error = rmdir(path); int error; /* 0 if successful */ const char *path; /* points to directory path string */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " LinkTR "errno"} , @{" mkdir() " Link "mkdir()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "rstmem()" rstmem()-Reset memory pool Synopsis #include void rstmem(void); Portability OLD See Also @{" getmem() " Link "getmem()"} , @{" getml() " Link "getml()"} , @{" rlsmem() " Link "rlsmem()"} , @{" rlsml() " Link "rlsml()"} , @{" sizmem() " Link "sizmem()"} @EndNode @Node "sbrk()" sbrk()-Allocate memory (unsigned) Synopsis #include p = sbUgrrk(sbytes); void *p; /* block pointer */ unsigned int sbytes; /* number of bytes */ Portability OLD Returns If successful, this function returns the address of the block just allocated. If this function fails, it returns value (char *)(-1), which is -1 cast into a character pointer. See Also @{" getmem() " Link "getmem()"} , @{" lsbrk() " Link "lsbrk()"} , @{" malloc() " Link "malloc()"} , @{" lsbrk() " Link "lsbrk()"} @EndNode @Node "scaVzFnf()" scanf()-Formatted input conversions Synopsis #include n = scanf(fmt,arg1,arg2,...); int n; /* number of input items matched, or EOF */ const char *fmt; /* format string */ ---- *arg ; /* pointers to input data areas */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns The function returns the number of assignments that were made. For example, a return value of three indicates that conversion results wereW/X assigned to arg1, arg2, and arg3. See Also @{" fscanf() " Link "fscanf()"} , @{" sscanf() " Link "sscanf()"} , @{" Formatted Input Specifiers " Link "Formatted Input Specifiers"} @EndNode @Node "seed48()" seed48()-Set all 48 bits of internal seed Synopsis #include pseed = seed48(seed); unsigned short seed[3]; /* seed value (high bits in seed[0]) */ unsigned short *pseed; /* pointer to internal seed */ Portability @{" UNIX " Link "Glossary - UNXj}IX"} Returns This function returns a pointer to the internal seed array. See Also @{" lcong48() " Link "lcong48()"} , @{" rand() " Link "rand()"} , @{" srand() " Link "srand()"} , @{" srand48() " Link "srand48()"} @EndNode @Node "seekdir()" seekdir()-Reposition directory operation Synopsis #include void seekdir(dfd, loc); DIR *dfd; /* dir file descriptor */ long loc; /* entry location */ Portability @{" UNIX " Link "GYG=Mlossary - UNIX"} See Also @{" opendir() " Link "opendir()"} , @{" readdir() " Link "readdir()"} , @{" closedir() " Link "closedir()"} , @{" rewinddir() " Link "rewinddir()"} @EndNode @Node "setbuf()" setbuf()-Set buffer mode for a level 2 file Synopsis #include void setbuf(fp,buff); FILE *fp; /* file pointer */ const char *buff; /* buffer pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" fopen() " Link "fopeZNc_n()"} , @{" setnbf() " Link "setnbf()"} , @{" setvbuf() " Link "setvbuf()"} @EndNode @Node "setjmp()" setjmp()-Set long jump parameters Synopsis #include ret = setjmp(save); int ret; /* return code */ jmp_buf save; /* address of save area */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A return code of 0 indicates that this is the initial call to save the stack. A non-zero return code indicates that @{" longjmp() " Link[$1 "longjmp()"} has been executed. See Also @{" longjmp() " Link "longjmp()"} @EndNode @Node "setlocale()" setlocale()-Set locale information for program Synopsis #include ret = setlocale(category, locale); char *ret; /* Pointer to the selected locale portion */ int category; /* Names the portion of the locale to be */ /* selected */ const char *locale; /* Identifies the type\e6 of environment */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If it finds the selected environment, this function returns a pointer to a string associated with the requested category. If it cannot find the environment, it returns a null, and the program's locale is not changed. This string is considered read-only and is valid until the next call to this function. See Also @{" readlocale() " Link "readlocale()"} , @{" localeconv() " Link "l]%{5.ocaleconv()"} @EndNode @Node "setmem()" setmem()-Set a memory block to a value Synopsis #include void setmem(to,n,c); void *to; /* destination pointer */ unsigned n; /* number of bytes */ int c; /* character value */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" memset() " Link "memset()"} , @{" repmem() " Link "repmem()"} @EndNode @Node "setnbf()" setnbf()-Set non-buffer mode for level 2 file Synopsis #include^\\ void setnbf(fp); FILE *fp; /* file pointer */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" fopen() " Link "fopen()"} , @{" setbuf() " Link "setbuf()"} , @{" setvbuf() " Link "setvbuf()"} @EndNode @Node "setvbuf()" setvbuf()-Set variable buffer for level 2 file Synopsis #include error = setvbuf(fp,buff,type,size); int error; /* 0 if successful */ FILE *fp; /* file pointer */ const char_?J *buff; /* buffer pointer */ int type; /* type of buffering */ size_t size; /* buffer size in bytes */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a non-zero error code if type or size is invalid. See Also @{" fopen() " Link "fopen()"} , @{" setbuf() " Link "setbuf()"} , @{" setnbf() " Link "setnbf()"} @EndNode @Node "__sigfunc()" __sigfunc()-signal() function table Synopsis #include `Y extern void (*__sigfunc[NSIG])(int); Description __sigfunc is the array of all signal handles. When the @{" raise() " Link "raise()"} function is called, it looks in the table to see what is installed at the corresponding slot in the __sigfunc array. Each entry is either a pointer to the function to be called when the event occurs or one of two special values: SIG_IGN Ignore the condition. SIG_DFL Take the default action. You aLshould not set elements of this array directly. Use the @{" signal() " Link "signal()"} function instead. Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" raise() " Link "raise()"} , @{" signal() " Link "signal()"} @EndNode @Node "signal()" signal()-Establish event traps Synopsis #include oldfun = signal(sig,newfun); void (*oldfun)(int); /* old trap function */ int sig; /* signal() number */ void (*newfun)(int); /b E* new trap function */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If the trap can be established, the signal() function returns a pointer to the previous handler function. Otherwise, it returns SIG_ERR and places error information in @{" errno " Link "errno"}. @EndNode @Node "sin()" sin()-sine function Synopsis #include r = sin(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"c } See Also @{" cos() " Link "cos()"} , @{" cosh() " Link "cosh()"} , @{" __matherr() " Link "__matherr()"} , @{" sinh() " Link "sinh()"} @EndNode @Node "sinh()" sinh()-Hyperbolic sine function Synopsis #include r = sinh(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" cos() " Link "cos()"} , @{" cosh() " Link "cosh()"} , @{" __matherr() " Link "__matherr()"} , @{" sin() " Link "sid 9&n()"} @EndNode @Node "sizmem()" sizmem()-Get level 2 memory pool size Synopsis #include size = sizmem(void); long size; Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" getmem() " Link "getmem()"} , @{" getml() " Link "getml()"} , @{" rlsmem() " Link "rlsmem()"} , @{" risml " Link "risml"} , @{" rstmem() " Link "rstmem()"} @EndNode @Node "_SLASH" _SLASH-Directory separator character Synopsis extern char _SLASH; Description e vThis external character is used by various functions that construct file names. It specifies the character to be used for separating components of the directory path. For AmigaDOS, the default character is a forward slash (/), while for MSDOS it is a backslash (\). Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strmfn() " Link "strmfn()"} , @{" strmfp() " Link "strmfp()"} @EndNode @Node "sprintf()" sprintf()-Formatted print to a string Synopsis f c% #include length = sprintf(s,fmt,arg1,arg2,...); int length; /* number of characters generated */ char *s; /* pointer to a character string */ const char *fmt; /* format string */ arg /* arguments */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of output characters generated. This number does not include the terminating null byte. See Also @{" fprintf() " LgQBdLink "fprintf()"} , @{" printf() " Link "printf()"} , @{" Formatted Output Specifiers " Link "Formatted Output Specifiers"} @EndNode @Node "sqsort()" sqsort()-Sort an array of short integers Synopsis #include void sqsort(sa,n); short *sa; /* pointer to short int array */ size_t n; /* number of elements in array */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" dqsort() " Link "dqsort()"} , @{" fqsort() " Link "fqsort()"} , @hj{" lqsort() " Link "lqsort()"} , @{" qsort() " Link "qsort()"} , @{" tqsort() " Link "tqsort()"} @EndNode @Node "sqrt()" sqrt()-Square root function Synopsis #include r = sqrt(x); double r, x; Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" __matherr() " Link "__matherr()"} , @{" pow() " Link "pow()"} , @{" pow2() " Link "pow2()"} @EndNode @Node "srand()" srand()-Set seed for rand() function Synopsis #include void sHHWVUTSRQPONMLKJIHGFEDCBA@?>=<;:9876543210/.-,+*)('&%$#"! XiU2rand(seed); unsigned int seed; /* random number seed */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" drand48() " Link "drand48()"} , @{" erand48() " Link "erand48()"} , @{" lrand48() " Link "lrand48()"} , @{" nrand48() " Link "nrand48()"} , @{" jrand48() " Link "jrand48()"} , @{" rand() " Link "rand()"} , @{" srand48() " Link "srand48()"} @EndNode @Node "srand48()" srand48()-Set high 32 bits of internal seed Synopsis #include void sjھhrand48(hseed); long hseed; /* high 32 bits of seed value */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" lcong48() " Link "lcong48()"} , @{" seed48() " Link "seed48()"} , @{" rand() " Link "rand()"} , @{" srand() " Link "srand()"} @EndNode @Node "sscanf()" sscanf()-Formatted input conversions Synopsis #include n = sscanf(ss,fmt,arg1,arg2,...); int n; /* number of input items matched, or EOF */ const char *ss; kwe /* input string (sscanf() only) */ const char *fmt; /* format string */ ---- *arg[]; /* pointers to input data areas */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of assignments that were made. For example, a return value of three indicates that conversion results were assigned to arg1, arg2, and arg3. See Also @{" fscanf() " Link "fscanf()"} , @{" scanf() " Link "scanf()"} , @{" Formatted Input Specifl/Afiers " Link "Formatted Input Specifiers"} @EndNode @Node "__stack" __stack-minimum program stack size Synopsis long __stack = 8192; Description __stack is used by cres.o and catchres.o to determine the minimum stack space necessary to run a program. You must initialize the variable at compile time. Setting this variable after the program has started does not affect the stack size. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" _procname "mHܮ Link "_procname"} , @{" _priority " Link "_priority"} @EndNode @Node "stacksize()" stacksize()-Get the current stack size Synopsis #include size = stacksize(void); size_t size; /* size of current stack */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of bytes available for the entire stack when the program was started. See Also @{" __stack " Link "__stack"} , @{" stackused() " Link "stackusn/Fred()"} @EndNode @Node "stackused()" stackused()-Get the amount of stack in use Synopsis #include size = stackused(void); size_t size; /* amount of current stack in use */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of bytes of stack currently being used. See Also @{" __stack " Link "__stack"} , @{" stacksize() " Link "stacksize()"} @EndNode @Node "stat()" stat()-Get file status Synopsis oj #include rc = stat(file, st); int rc; /* return code */ const char *file; /* file name */ struct stat *st; /* stat info structure */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, the function returns 0. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" chmod() " Link "chmod()"} , @{" errno " Link "errno"} , @{"pB0 fstat() " Link "fstat()"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "stcarg()" stcarg()-Get an argument Synopsis #include length = stcarg(s,b); int length; /* number of bytes in argument */ const char *s; /* text string pointer */ const char *b; /* break string pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function returns a count of the number of characters in s up to but not including the break chq玞aracter or null terminator. See Also @{" stpbrk() " Link "stpbrk()"} , @{" strcspn() " Link "strcspn()"} , @{" strpbrk() " Link "strpbrk()"} @EndNode @Node "stccpy()" stccpy()-Copy one string to another Synopsis #include size = stccpy(to,from,n); int size; /* number of bytes copied */ char *to; /* destination pointer */ const char *from; /* source pointer */ int n; /* maximum source length */ Portability @rL({" UNIX " Link "Glossary - UNIX"} Returns This function returns actual number of bytes placed in the to area, including the null terminator. See Also @{" stcgfn() " Link "stcgfn()"} , @{" stcgfp() " Link "stcgfp()"} , @{" strsfn() " Link "strsfn()"} @EndNode @Node "stcd_i()" stcd_i()-Convert decimal string to integer Synopsis #include length = stcd_i(in,ivalue); int length; /* input length */ const char *in; /* input string pointers% */ int *ivalue; /* integer value pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of input characters converted. This result is 0 if the first character of the input string is not a valid decimal digit, a plus (+), or a minus (-). In that case, conversion result pointed to by the second argument is 0. @EndNode @Node "stcd_l()" stcd_l()-Convert decimal string to long integer Synopsis #include length = stcd_l(in,lvalue); int length; /* input length */ const char *in; /* input string pointer */ long *lvalue; /* long integer value pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of input characters converted. This result is 0 if the first character of the input string is not a valid decimal digit, a plus (+), or a minus (-). In that case, the conversion result pointed to uLby the second argument is also 0. @EndNode @Node "stcgfe()" stcgfe()-Get file name extension Synopsis #include size = stcgfe(ext,name); int size; /* size of result string */ char *ext; /* extension area pointer */ const char *name; /* file name pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The size value is the same as would be returned by the @{" strlen() " Link "strlen()"} function. That is, if sizevу is 0, then the desired portion of the file name could not be found and the result area contains a null string. See Also @{" stcgfn() " Link "stcgfn()"} , @{" stcgfp() " Link "stcgfp()"} , @{" strsfn() " Link "strsfn()"} @EndNode @Node "stcgfn()" stcgfn()-Get file node Synopsis #include size = stcgfn(node,name); int size; /* size of result string */ char *node; /* node area pointer */ const char *name; /* file name pointer */ Pw}+ortability @{" SAS/C " Link "Glossary - SASC"} Returns The size value is the same as would be returned by the @{" strlen() " Link "strlen()"} function. That is, if size is 0, then the desired portion of the file name could not be found and the result area contains a null string. See Also @{" stcgfe() " Link "stcgfe()"} , @{" stcgfp() " Link "stcgfp()"} , @{" strlen() " Link "strlen()"} , @{" strsfn() " Link "strsfn()"} @EndNode @Node "stcgfp()" stcgfp()-Get filex ̢ path Synopsis #include size = stcgfp(path,name); int size; /* size of result string */ char *path; /* path area pointer */ const char *name; /* file name pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The size value is the same as would be returned by the @{" strlen() " Link "strlen()"} function. That is, if size is 0, then the desired portion of the file name could not be found and the result y!area contains a null string. See Also @{" stcgfe() " Link "stcgfe()"} , @{" stcgfn() " Link "stcgfn()"} , @{" strlen() " Link "strlen()"} , @{" strsfn() " Link "strsfn()"} @EndNode @Node "stch_i()" stch_i()-Convert hexadecimal string to integer Synopsis #include length = stch_i(in,ivalue); int length; /* input length */ const char *in; /* input string pointer */ int *ivalue; /* integer value pointer */ Portability @{" SAS/C " Linkz",#h "Glossary - SASC"} Returns This function returns the number of input characters converted. This result is 0 if the first character of the input string is not a valid hexadecimal digit. In that case, conversion result pointed to by the second argument is 0. See Also @{" stci_o() " Link "stci_o()"} , @{" stci_h() " Link "stci_h()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_o() " Link "stcl_o()"} , @{" stcl_h() " Link "stcl_h()"} , @{" stcu_d() " Link "stcu_d{#()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stch_l()" stch_l()-Convert hexadecimal string to long integer Synopsis #include length = stch_l(in,lvalue); int length; /* input length */ const char *in; /* input string pointer */ long *lvalue; /* long integer value pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of input characters converted. This result is 0|$tȇC if the first character of the input string is not a valid hexadecimal digit. In that case, the conversion result pointed to by the second argument is 0. @EndNode @Node "stci_d()" stci_d()-Convert integer to decimal string Synopsis #include length = stci_d(out,ivalue); int length; /* output length */ char *out; /* output buffer pointer */ int ivalue; /* integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The }%z#return value is the number of characters actually placed into the output area, not including the final null byte. See Also @{" stci_o() " Link "stci_o()"} , @{" stci_h() " Link "stci_h()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_o() " Link "stcl_o()"} , @{" stcl_h() " Link "stcl_h()"} , @{" stcu_d() " Link "stcu_d()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stci_h()" stci_h()-Convert integer to hexadecimal string Synopsis #include leng~&_Ќth = stci_h(out,ivalue); int length; /* output length */ char *out; /* output buffer pointer */ int ivalue; /* integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually placed into the output area, not including the final null byte. See Also @{" stci_d() " Link "stci_d()"} , @{" stci_o() " Link "stci_o()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_o() " Link "stcl_o()"} , '| S@{" stcl_h() " Link "stcl_h()"} , @{" stcu_d() " Link "stcu_d()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stci_o()" stci_o()-Convert integer to octal string Synopsis #include length = stci_o(out,ivalue); int length; /* output length */ char *out; /* output buffer pointer */ int ivalue; /* integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually placed into th(TDe output area, not including the final null byte. See Also @{" stci_d() " Link "stci_d()"} , @{" stci_h() " Link "stci_h()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_o() " Link "stcl_o()"} , @{" stcl_h() " Link "stcl_h()"} , @{" stcu_d() " Link "stcu_d()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stcis()" stcis()-Measure span of characters in set Synopsis #include length = stcis(s,b); int length; /* span length in bytes */ c) onst char *s; /* points to string being scanned */ const char *b; /* points to character set string */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of bytes that are in the specified character set. The scan always stops when the null terminator byte is reached. See Also @{" stcisn() " Link "stcisn()"} , @{" strspn() " Link "strspn()"} @EndNode @Node "stcisn()" stcisn()-Measure span of characters not in set S* 3dynopsis #include length = stcisn(s,b); int length; /* span length in bytes */ const char *s; /* points to string being scanned */ const char *b; /* points to character set string */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of bytes that are not in the specified character set. The scan always stops when the null terminator byte is reached. See Also @{" stcis() " Link "stcis()"} +] , @{" strcspn() " Link "strcspn()"} @EndNode @Node "stcl_d()" stcl_d()-Convert long integer to decimal string Synopsis #include length = stcl_d(out,lvalue); int length; /* output length */ char *out; /* output buffer pointer */ long lvalue; /* long integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually placed into the output area, not including the final nul,c#Sl byte. See Also @{" stci_d() " Link "stci_d()"} , @{" stci_o() " Link "stci_o()"} , @{" stci_h() " Link "stci_h()"} , @{" stcl_o() " Link "stcl_o()"} , @{" stcl_h() " Link "stcl_h()"} , @{" stcu_d() " Link "stcu_d()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stcl_h()" stcl_h()-Convert long integer to hexadecimal string Synopsis #include length = stcl_h(out,lvalue); int length; /* output length */ char *out; /* output buffer poi-nter */ long lvalue; /* long integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually placed into the output area, not including the final null byte. See Also @{" stci_d() " Link "stci_d()"} , @{" stci_h() " Link "stci_h()"} , @{" stci_o() " Link "stci_o()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_o() " Link "stcl_o()"} , @{" stcu_d() " Link "stcu_d()"} , @{" stcul_d() " Link "stcul_.N(Kd()"} @EndNode @Node "stcl_o()" stcl_o()-Convert long integer to octal string Synopsis #include length = stcl_o(out,lvalue); int length; /* output length */ char *out; /* output buffer pointer */ long lvalue; /* long integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually placed into the output area, not including the final null byte. See Also @{" stci_d/{() " Link "stci_d()"} , @{" stci_h() " Link "stci_h()"} , @{" stci_o() " Link "stci_o()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_h() " Link "stcl_h()"} , @{" stcu_d() " Link "stcu_d()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stclen()" stclen()-Measure length of a string Synopsis #include length = stclen(s); size_t length; /* number of bytes in s (before null) */ const char *s; Portability OLD Returns The length equals the 0ƃnumber of bytes in string before null byte. See Also @{" strlen() " Link "strlen()"} @EndNode @Node "stco_i()" stco_i()-Convert octal string to integer Synopsis #include length = stco_i(in,ivalue); int length; /* input length */ const char *in; /* input string pointer */ int *ivalue; /* integer value pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of input characters convert1Ƅed. This result will be 0 if the first character of the input string is not a valid octal digit. In that case, conversion result pointed to by the second argument will be 0. See Also @{" stcd_i() " Link "stcd_i()"} , @{" stch_i() " Link "stch_i()"} , @{" stcd_l() " Link "stcd_l()"} , @{" stco_l() " Link "stco_l()"} , @{" stch_l() " Link "stch_l()"} @EndNode @Node "stco_l()" stco_l()-Convert octal string to long integer Synopsis #include length 21:= stco_l(in,lvalue); int length; /* input length */ const char *in; /* input string pointer */ long *lvalue; /* long integer value pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the number of input characters converted. This result will be 0 if the first character of the input string is not a valid octal digit. In that case, conversion result pointed to by the second argument will be 0. See Al3Rߌso @{" stcd_i() " Link "stcd_i()"} , @{" stco_i() " Link "stco_i()"} , @{" stch_i() " Link "stch_i()"} , @{" stcd_l() " Link "stcd_l()"} , @{" stch_l() " Link "stch_l()"} @EndNode @Node "stcpm()" stcpm()-Unanchored pattern match Synopsis #include size = stcpm(string,pattern,match); int size; /* size of matching string */ const char *string; /* string to be scanned */ const char *pattern; /* pattern string */ char **match; 4[ /* returns pointer to matching string */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns the size of the matching string or zero if there was no match. It also returns a pointer to the beginning of the matching string in the parameter match. See Also @{" astcsma() " Link "astcsma()"} , @{" stcpma() " Link "stcpma()"} , @{" stcsma() " Link "stcsma()"} @EndNode @Node "stcpma()" stcpma()-Anchored pattern match Synopsis 5ߏ#include size = stcpma(string,pattern); int size; /* size of matching string */ const char *string; /* string to be scanned */ const char *pattern; /* pattern string */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function returns the size of the matching string or zero if there was no match. See Also @{" astcsma() " Link "astcsma()"} , @{" stcpm() " Link "stcpm()"} , @{" stcsma() " Link "stcsma()"} @EndNo67de @Node "stcsma()" stcsma()-@{" UNIX " Link "Glossary - UNIX"} string pattern match (anchored) Synopsis #include length = stcsma() (s,p); int length; /* length of matching string */ const char *s; /* string being scanned */ const char *p; /* pattern string */ Portability AmigaDOS Returns This function returns the length of the matching string or zero if there was no match. See Also @{" astcsma() " Link "astcsma()"} , @{7rS" stcpm() " Link "stcpm()"} , @{" stcpma() " Link "stcpma()"} @EndNode @Node "stcu_d()" stcu_d()-Convert unsigned integer to decimal string Synopsis #include length = stcu_d(out,uivalue); int length; /* output length */ char *out; /* output buffer pointer */ unsigned uivalue; /* unsigned value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually place8s՜d into the output area, not including the final null byte. See Also @{" stci_d() " Link "stci_d()"} , @{" stci_o() " Link "stci_o()"} , @{" stci_h() " Link "stci_h()"} , @{" stcl_d() " Link "stcl_d()"} , @{" stcl_o() " Link "stcl_o()"} , @{" stcl_h() " Link "stcl_h()"} , @{" stcul_d() " Link "stcul_d()"} @EndNode @Node "stcul_d()" stcul_d()-Convert unsigned long to decimal string Synopsis #include length = stcul_d(out,ulvalue); int length; 9P˭s /* output length */ char *out; /* output buffer pointer */ unsigned long ulvalue; /* unsigned long integer value */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value is the number of characters actually placed into the output area, not including the final null byte. See Also @{" stci_d() " Link "stci_d()"} , @{" stci_o() " Link "stci_o()"} , @{" stci_h() " Link "stci_h()"} , @{" stcl_d() " Link "stcl_d()"} , @{" s:uȗtcl_o() " Link "stcl_o()"} , @{" stcl_h() " Link "stcl_h()"} @EndNode @Node "stpblk()" stpblk()-Skip blanks Synopsis #include q = stpblk(p); char *q; /* updated string pointer */ const char *p; /* string pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function returns a pointer to the next non-blank character. The null terminator byte is not considered to be a blank, and so the function will not go past t;] p = stpbrk(s,b); char *p; /* points to break character in s */ const char *s; /* string to be scanned */ const char *b; /* break characters */ Portability OLD Returns If no character from b is found in s, a null pointer is returned. Otherwis<(2e, p is a pointer to the first break character. See Also @{" strspn() " Link "strspn()"} , @{" strcspn() " Link "strcspn()"} , @{" strpbrk() " Link "strpbrk()"} @EndNode @Node "stpchr()" stpchr()-Find character in string Synopsis #include p = stpchr(s,c); char *p; /* updated string pointer */ const char *s; /* input string pointer */ int c; /* character to be located */ Portability OLD Returns This function returns =ya null pointer if the input string is empty or if the specified character is not found. See Also @{" stpchrn() " Link "stpchrn()"} , @{" strchr() " Link "strchr()"} , @{" strrchr() " Link "strrchr()"} @EndNode @Node "stpchrn()" stpchrn()-Find character not in string Synopsis #include p = stpchrn(s,c); char *p; /* updated string pointer */ const char *s; /* input string pointer */ int c; /* character to be located */ Porta>G&Cbility OLD Returns This function returns a null pointer if the input string is empty or consists entirely of character c. See Also @{" stpchr() " Link "stpchr()"} , @{" strchr() " Link "strchr()"} , @{" strrchr() " Link "strrchr()"} @EndNode @Node "stpcpy()" stpcpy()-Copy one string to another Synopsis #include np = stpcpy(to,from); char *np; /* points to end of destination string */ char *to; /* destination pointer */ ?M(2- const char *from; /* source pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns a pointer to the end of the destination string, which is useful when you are building a string up from several pieces. Note: The @{" ANSI " Link "Glossary - ANSI"} @{" strcpy() " Link "strcpy()"} function returns the to string, but this function returns a pointer to the null byte after the to string. See Also @{" stccpy() " Link "stccpy()"@iLZ} , @{" strcpy() " Link "strcpy()"} , @{" strncpy() " Link "strncpy()"} @EndNode @Node "stpdate()" stpdate()-Convert date array to string Synopsis #include np = stpdate(p,mode,date); char *np; /* updated output string pointer */ char *p; /* output string pointer */ int mode; /* conversion mode */ const char *date; /* date array, as follows */ /* date[0] => year - 198A4A}0 */ /* date[1] => month (1 to 12) */ /* date[2] => day (1 to 31) */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function does not make validity checks on the date array. It returns a pointer to the first byte past the generated output. For modes other than 0, this is a pointer to the null terminator. See Also @{" stptime() " Link "stptime()"} , @{" getclk() " Link "getclk()"} , @{" geB['tft() " Link "getft()"} @EndNode @Node "stpsym()" stpsym()-Get next symbol from a string Synopsis #include p = stpsym(s,sym,symlen); char *p; /* points to next input character */ const char *s; /* input string */ char *sym; /* output string */ int symlen; /* sizeof(sym) */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function returns a pointer to the next character past the symbol. See ACyilso @{" stcarg() " Link "stcarg()"} , @{" stpbrk() " Link "stpbrk()"} , @{" strcspn() " Link "strcspn()"} , @{" strpbrk() " Link "strpbrk()"} @EndNode @Node "stptime()" stptime()-Convert time array to string Synopsis #include np = stptime(p,mode,time); char *np; /* updated output string pointer */ char *p; /* output string pointer */ int mode; /* conversion mode */ const char *time(); /* time array, as follows */ Dd /* time[0] => hour (0 to 23) */ /* time[1] => minute (0 to 59) */ /* time[2] => second (0 to 59) */ /* time[3] => hundredths (0 to 99) */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function does not make validity checks on the time array. It returns a pointer to the first byte past the generated output. For modes other than 0, this is a pointer to the null teE 3*rminator. See Also @{" stpdate() " Link "stpdate()"} , @{" getclk() " Link "getclk()"} , @{" getft() " Link "getft()"} @EndNode @Node "stptok()" stptok()-Get next token from a string Synopsis #include p = stptok(s,tok,toklen,brk); char *p; /* points to next character after token */ const char *s; /* points to input string */ char *tok; /* points to output buffer */ int toklen; /* size of buffer pointed to by F tok */ const char *brk; /* break string */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The function returns a pointer to the next character in the input string. See Also @{" stpblk() " Link "stpblk()"} , @{" strtok() " Link "strtok()"} @EndNode @Node "strbpl()" strbpl()-Build string pointer list Synopsis #include n = strbpl(s,max(),t); int n; /* number of pointers */ char *s[]; /* pointer to stringGڨ pointer list */ int max(); /* maximum number of pointers */ const char *t; /* text pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The return value indicates how many string pointers were placed into array s. If the number of strings plus the final null pointer is greater than max(), a value of -1 is returned. See Also @{" getfnl() " Link "getfnl()"} , @{" strsrt() " Link "strsrt()"} @EndNode @Node "strcat()" strcat()-CHN[ oncatenate strings Synopsis #include p = strcat(to,from); char *p; /* same as destination string pointer */ char *to; /* destination string pointer */ const char *from; /* source string pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer that is the same as the first argument. See Also @{" strncat() " Link "strncat()"} , @{" stpcpy() " Link "stpcpy()"} @EndNode @Node IU1 "strchr()" strchr()-Find character in string Synopsis #include p = strchr(s,c); char *p; /* updated string pointer */ const char *s; /* input string pointer */ int c; /* character to be located */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A null pointer is returned if the input string is empty or if the specified character is not found. Otherwise, this function returns a pointer to the first matching cJIharacter in s. See Also @{" strchr() " Link "strchr()"} , @{" stpchrn() " Link "stpchrn()"} , @{" strrchr() " Link "strrchr()"} @EndNode @Node "strcmp()" strcmp()-Compare strings Synopsis #include x = strcmp(a,b); int x; /* comparison result */ const char *a,*b; /* strings being compared */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns The sign of the return value indicates the relative collating sequence of thKNe strings, as indicated above. See Also @{" strcmpi() " Link "strcmpi()"} , @{" stricmp() " Link "stricmp()"} , @{" strncmp() " Link "strncmp()"} , @{" strnicmp() " Link "strnicmp()"} @EndNode @Node "strcmpi()" strcmpi()-Compare strings, case-insensitive Synopsis #include x = strcmpi(a,b); int x; /* comparison result */ const char *a,*b; /* strings being compared */ Portability OLD Returns The sign of the return value indiLcates the relative colating sequence of the strings, as indicated above. See Also @{" strcmp() " Link "strcmp()"} , @{" stricmp() " Link "stricmp()"} , @{" strncmp() " Link "strncmp()"} , @{" strnicmp() " Link "strnicmp()"} @EndNode @Node "strcoll()" strcoll()-Compare strings based on locale Synopsis #include res = strcoll(s1, s2); int res; /* result of comparison */ const char *s1,*s2; /* strings to compare */ PortabilityM" @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a 0 if both strings are equal. If s1 is logically less than s2, the return value is less than 0. If s1 is logically greater than s2, the return value is greater than 0. See Also @{" setlocale() " Link "setlocale()"} @EndNode @Node "strcpy()" strcpy()-Copy one string to another Synopsis #include p = strcpy(to,from); char *p; /* same as destination pointer */ cN9 length = strcspn(s,b); O>" size_t length; /* span length in bytes */ const char *s; /* points to string being scanned */ const char *b; /* points to character set string */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of bytes that are not in the specified character set. The scan always stops when the null terminator byte is reached. See Also @{" stcis() " Link "stcis()"} , @{" stcisn() " Link "stcisn()"} , @{" strspn()P,0 " Link "strspn()"} @EndNode @Node "strdup()" strdup()-Duplicate a string Synopsis #include p = strdup(s); char *p; /* points to duplicate string */ const char *s; /* points to string being duplicated */ Portability XENIX Returns A null pointer is returned if @{" malloc() " Link "malloc()"} fails. Otherwise, the function returns a pointer to the duplicate string. See Also @{" malloc() " Link "malloc()"} , @{" strcpy() " LinQ!Rk "strcpy()"} @EndNode @Node "strerror()" strerror()-Print text for a given error number Synopsis #include p = strerror(error); char *p; /* Pointer to text string */ int error; /* Error number */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to the text of the corresponding error message. If it could not find the error, it returns a null. The string is valid untiR?Xl the next call to strerror() and must not be modified by the caller. See Also @{" errno " Link "errno"} @EndNode @Node "strftime()" strftime()-Format time string Synopsis #include ret = strftime(s, max()size, format, timeptr); size_t ret; /* number of characters in */ /* formatted string */ char *s; /* string to place characters in */ size_t max()size; /* S {'maximum string size */ const char *format; /* format instructions for string */ const struct tm *timeptr; /* broken-down time() information */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of characters placed into the string pointed to by s, not including the terminating null character. Otherwise, it returns a zero, and the contents of s are indeterminate. See Also @{" asctime() " Link "asctime()T"} , @{" gmtime() " Link "gmtime()"} , @{" localtime() " Link "localtime()"} , @{" setlocale() " Link "setlocale()"} @EndNode @Node "stricmp()" stricmp()-Compare strings, case-insensitive Synopsis #include x = stricmp(a,b); int x; /* comparison result */ const char *a,*b; /* strings being compared */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns The sign of the return value indicates the relative collating sequence UYf` of the strings, as indicated above. See Also @{" strcmp() " Link "strcmp()"} , @{" strncmp() " Link "strncmp()"} , @{" strnicmp() " Link "strnicmp()"} @EndNode @Node "strins()" strins()-Insert a string Synopsis #include void strins(to,from); char *to; /* destination string */ const char *from; /* source string */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strcat() " Link "strcat()"} @EndNode @Node "strlVEEen()" strlen()-Measure length of a string Synopsis #include length = strlen(s); size_t length; /* number of bytes in s (before null) */ const char *s; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of bytes in string before the terminating null byte. See Also @{" stclen() " Link "stclen()"} @EndNode @Node "strlwr()" strlwr()-Convert string to lower case Synopsis #include p = Wأstrlwr(s); char *p; /* return pointer (same as s) */ char *s; /* string pointer */ Portability XENIX Returns This function returns the original string pointer. See Also @{" stricmp() " Link "stricmp()"} , @{" strupr() " Link "strupr()"} , @{" tolower() " Link "tolower()"} , @{" toupper() " Link "toupper()"} @EndNode @Node "strmfe()" strmfe()-Make file name with extension Synopsis #include void strmfe(newname,oldname,ext); char *newYavname; /* new file name */ const char *oldname; /* old file name */ const char *ext; /* extension */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strmfn() " Link "strmfn()"} , @{" strmfp() " Link "strmfp()"} @EndNode @Node "strmfn()" strmfn()-Make file name from components Synopsis #include void strmfn(file,drive,path,node,ext) char *file; /* file name pointer */ const char *drive; /* drive cXH.~}|{zyxwvutsrqponmlkjihgfedcba`_^]\[ZYZ pode pointer */ const char *path; /* directory path pointer */ const char *node; /* node pointer */ const char *ext; /* extension pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strmfe() " Link "strmfe()"} , @{" strmfp() " Link "strmfp()"} , @{" _SLASH " Link "_SLASH"} @EndNode @Node "strmfp()" strmfp()-Make file name from path/node Synopsis #include void strmfp(name,path,node); char *name; /* [яfile name */ const char *path; /* directory path */ const char *node; /* node */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strmfe() " Link "strmfe()"} , @{" strmfn() " Link "strmfn()"} , @{" _SLASH " Link "_SLASH"} @EndNode @Node "strmid()" strmid()-Return a substring from a string Synopsis #include error = strmid(source,dest,pos,len); int error; /* -1 if pos is beyond source, else 0 */ const char *source; \8/* source pointer */ char *dest; /* destination pointer */ int pos; /* starting position of dest in source */ int len; /* length of substring */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strchr() " Link "strchr()"} , @{" strrchr() " Link "strrchr()"} , @{" strstr() " Link "strstr()"} @EndNode @Node "strncat()" strncat()-Concatenate strings, length limited Synopsis #include p = strncat(to,from,],n); char *p; /* same as destination string pointer */ char *to; /* destination string pointer */ const char *from; /* source string pointer */ size_t n; /* maximum source length */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer that is the same as the first argument. See Also @{" stpcpy() " Link "stpcpy()"} , @{" strcat() " Link "strcat()"} @EndNode @Node "strncmp()" strncmp()-Compare st^ .[rings, length-limited Synopsis #include x = strncmp(a,b,n); int x; /* comparison result */ const char *a,*b; /* strings being compared */ size_t n; Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a 0 if both strings are equal. If s1 is logically less than s2, the return value is less than 0. If s1 is logically greater than s2, the return value is greater than 0. See Also @{" strcmp() " _~Link "strcmp()"} , @{" strcmpi() " Link "strcmpi()"} , @{" stricmp() " Link "stricmp()"} , @{" strnicmp() " Link "strnicmp()"} @EndNode @Node "strncpy()" strncpy()-Copy string, length-limited Synopsis #include p = strncpy(to,from,n); char *p; /* same as destination pointer */ char *to; /* destination pointer */ const char *from; /* source pointer */ size_t n; /* maximum source length */ Portability @{" ANSI " Link "G`2lossary - ANSI"} Returns This function returns a pointer that is the same as the destination pointer. See Also @{" stccpy() " Link "stccpy()"} , @{" stpcpy() " Link "stpcpy()"} , @{" strcpy() " Link "strcpy()"} @EndNode @Node "strnicmp()" strnicmp()-Compare strings, case-insensitive, length-limited Synopsis #include x = strnicmp(a,b,n); int x; /* comparison result */ const char *a,*b; /* strings being compared */ size_t inta i n; Portability @{" SAS/C " Link "Glossary - SASC"} Returns The sign of the return value indicates the relative collating sequence of the strings, as noted above. See Also @{" strcmp() " Link "strcmp()"} , @{" strcmpi() " Link "strcmpi()"} , @{" stricmp() " Link "stricmp()"} , @{" strncmp() " Link "strncmp()"} @EndNode @Node "strnset()" strnset()-Set string to value, length-limited Synopsis #include p = strnset(s,c,n); char *p; /* return pobOjinter (same as s) */ char *s; /* string pointer */ int c; /* value */ int n; /* maximum string length */ Portability XENIX Returns This function returns the original string pointer. See Also @{" strset() " Link "strset()"} @EndNode @Node "strpbrk()" strpbrk()-Find break character in string Synopsis #include p = strpbrk(s,b); char *p; /* points to break character in s */ const char *s; /* string to be scanned */ concoDst char *b; /* break characters */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If no character from b is found in s, a null pointer is returned. Otherwise, p is a pointer to the first break character. See Also @{" stpbrk() " Link "stpbrk()"} , @{" strspn() " Link "strspn()"} , @{" strcspn() " Link "strcspn()"} @EndNode @Node "strrchr()" strrchr()-Locate the last occurrence of a character in a string Synopsis #include p = strrchr(s,cdYoh); char *p; /* updated string pointer */ const char *s; /* input string pointer */ int c; /* character to be located */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" stpchr() " Link "stpchr()"} , @{" stpchrn() " Link "stpchrn()"} , @{" strchr() " Link "strchr()"} @EndNode @Node "strrev()" strrev()-Reverse a character string Synopsis #include p = strrev(s); char *p,*s; /* string pointer */ Portability XEe\"фNIX Returns This returns the same pointer that was passed to it. @EndNode @Node "strset()" strset()-Set string to value Synopsis #include p = strset(s,c); char *p; /* return pointer (same as s) */ char *s; /* string pointer */ int c; /* value */ Portability XENIX Returns This function returns the original string pointer. @EndNode @Node "strsfn()" strsfn()-Split the file name Synopsis #include void strsfn(file,drifD}ve,path,node,ext); const char *file; /* file name pointer */ char *drive; /* drive code pointer */ char *path; /* directory path pointer */ char *node; /* node pointer */ char *ext; /* extension pointer */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" strgfn " Link "strgfn"} , @{" strmfe() " Link "strmfe()"} , @{" strmfn() " Link "strmfn()"} @EndNode @Node "strspn()" strspn()-Measure span of characters in setgl Synopsis #include length = strspn(s,b); size_t length; /* span length in bytes */ const char *s; /* points to string being scanned */ const char *b; /* points to character set string */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" stcis() " Link "stcis()"} , @{" stcisn() " Link "stcisn()"} , @{" strcspn() " Link "strcspn()"} @EndNode @Node "strsrt()" strsrt()-Sort string pointer list Synopsis #include void strsrt(s,n); char *s[]; /* string pointer list */ int n; /* number of pointers in list */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" getfnl() " Link "getfnl()"} , @{" strbpl() " Link "strbpl()"} , @{" tqsort() " Link "tqsort()"} @EndNode @Node "strstr()" strstr()-Locate a substring inside of a string Synopsis #include p = strstr(s1, s2); char *p; /* pointer to substring in string.*/ const char *si 1; /* string to search in. */ const char *s2; /* substring to search for. */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to substring s2 within s1. If it cannot find the substring, it returns a null pointer. See Also @{" strrchr() " Link "strrchr()"} , @{" strchr() " Link "strchr()"} , @{" strmid() " Link "strmid()"} @EndNode @Node "strtod()" strtod()-Convert string to double Synopsis #include d = strtod(nptr, endptr); double d; /* converted number */ const char *nptr; /* string to convert */ char **endptr; /* pointer to end of string */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the converted double. If it is unable to perform conversion on the input source string, it returns a value of 0. For values too large or too small to fit in a double, it retk4urns a value than is plus or minus HUGE_VAL and sets @{" errno " Link "errno"} to ERANGE. In the case of an underflow, it returns zero, and @{" errno " Link "errno"} is set to ERANGE. See Also @{" errno " Link "errno"} , @{" scanf() " Link "scanf()"} @EndNode @Node "strtok()" strtok()-Get a token Synopsis #include t = strtok(s,b); char *t; /* token pointer */ char *s; /* input string pointer or NULL */ const char *b; /* break lKHcharacter string pointer */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns A null pointer is returned when there are no more tokens. See Also @{" stptok() " Link "stptok()"} , @{" strcspn() " Link "strcspn()"} , @{" strspn() " Link "strspn()"} @EndNode @Node "strtol()" strtol()-Convert string to long integer Synopsis #include r = strtol(p,np,base); long int r; /* result */ const char *p; /* string pointer */ char m**np; /* returns updated string pointer */ int base; /* conversion base */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the converted value. If it cannot do the conversion, it returns a zero. If the converted value would have been too large or small to fit in a long, it returns LONG_MAX or LONG_MIN and sets @{" errno " Link "errno"} to ERANGE. See Also @{" errno " Link "errno"}, @{" strtoul() " Link "n^/xstrtoul()"} @EndNode @Node "strtoul()" strtoul()-Convert string to unsigned long integer Synopsis #include r = strtoul(p,np,base); unsigned long int r; /* result */ const char *p; /* string pointer */ char **np; /* returns updated string pointer */ int base; /* conversion base */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the converted value. If it cannot do the of@conversion, it returns a zero. If the converted value would have been too large to fit in an unsigned long, it returns ULONG_MAX and sets @{" errno " Link "errno"} to ERANGE. See Also @{" errno " Link "errno"}, @{" strtol() " Link "strtol()"} @EndNode @Node "strupr()" strupr()-Convert string to upper case Synopsis #include p = strupr(s); char *p; /* return pointer (same as s) */ char *s; /* string pointer */ Portability XENIX Returns p. This function returns the original string pointer. See Also @{" strlwr() " Link "strlwr()"} , @{" toupper() " Link "toupper()"} , @{" tolower() " Link "tolower()"} , @{" stricmp() " Link "stricmp()"} @EndNode @Node "strxfrm()" strxfrm()-Transform a string Synopsis #include len = strxfrm(s1, s2, n); size_t len; /* length of transformed string */ char *s1; /* pointer to transformed string */ const char *s2; /* sq;Artring to transform */ size_t n; /* max() characters in transformed string */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the length of the transformed string (excluding the null termination character). If a value is greater than n, then the transformation could not fit in the output array, and the contents of the output array is indeterminate. See Also @{" setlocale() " Link "setlocale()"} , @{" srNdtrcoll() " Link "strcoll()"} @EndNode @Node "stspfp()" stspfp()-Parse file path Synopsis #include error = stspfp(path,nx); int error; /* -1 for error, 0 for success */ const char *path; /* file path string */ int nx[16]; /* node index array */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns A return value of -1 indicates that the path contains more than 15 nodes. See Also @{" stcgfe() " Link "stcgfe()"} , @{" stsb{Xcgfn() " Link "stcgfn()"} , @{" stcgfp() " Link "stcgfp()"} , @{" strsfn() " Link "strsfn()"} @EndNode @Node "_STRICT_ANSI" _STRICT_ANSI-Define to disable non-@{" ANSI " Link "Glossary - ANSI"} features Synopsis #define _STRICT_ANSI Portibility @{" SAS/C " Link "Glossary - SASC"} Description To be completely @{" ANSI " Link "Glossary - ANSI"}-compliant, an implementation must not define any non-@{" ANSI " Link "Glossary - ANSI"} symbols in an @{" ANSI " Link "GlosstQary - ANSI"} header file unless the symbols begin with an underscore followed by a capital letter, or an underscore followed by another underscore. Defining this symbol will prevent the definition of any symbols from the @{" SAS/C " Link "Glossary - SASC"} Development system headers which do not comply with the @{" ANSI " Link "Glossary - ANSI"} standard. @EndNode @Node "_stub()" _stub()-Default routine for undefined routines Synopsis void _stub(void); PortabiluW(jity AmigaDOS @EndNode @Node "swmem()" swmem()-Swap two memory blocks Synopsis #include void swmem(a,b,n); void *a,*b; /* block pointers */ unsigned n; /* number of bytes */ Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "__sys_errlist" __sys_errlist-Errno text strings Synopsis #include extern char *__sys_errlist[]; Description The extevprnal array of strings __sys_errlist provides the text message that corresponds to a given @{" errno " Link "errno"}. The value of @{" errno " Link "errno"} is used as a direct index to this table. You should not access this table directly, but instead use the @{" perror() " Link "perror()"} or @{" strerror() " Link "strerror()"} functions. You may wish to substitute your own table for internationalization of your program. The external integer @{" __sys_nerr " Link "w \ __sys_nerr"} indicates the number of entries in the table. In versions 5.10 and earlier, this variable was named sys_errlist. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" perror() " Link "perror()"} , @{" strerror() " Link "strerror()"} , @{" __sys_nerr " Link "__sys_nerr"} @EndNode @Node "__sys_nerr" __sys_nerr-Number of entries in __sys_errlist Synopsis #include extern int __sys_nerr; Description The external integer __sys_nx%err indicates the number of entries in the @{" __sys_errlist " Link "__sys_errlist"} array. It should be declared at the same time as the @{" __sys_errlist " Link "__sys_errlist"} array to indicate which messages are available for @{" perror() " Link "perror()"} and @{" strerror() " Link "strerror()"}. In versions 5.10 and earlier, this variable was named sys_nerr. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" perror() " Link "perror()"} , @{" syG1Jntrerror() " Link "strerror()"} , @{" __sys_errlist " Link "__sys_errlist"} @EndNode @Node "system()" system()-Call system command processor Synopsis #include error = system(cmd); int error; /* non-zero if error */ const char *cmd; /* command string */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns If the command processor cannot be invoked, a value of -1 is returned, and additional error information can be found in @{" errno "zox Link "errno"} and @{" _OSERR " Link "_OSERR"}. Otherwise, the function returns the value passed back by the command processor. See Also @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} @EndNode @Node "tan()" tan()-tangent function Synopsis #include r = tan(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" __matherr() " Link "__matherr()"} @EndNode @Node "tanh()" tanh(){})G-Hyperbolic tangent function Synopsis #include r = tanh(x); double r; /* result */ double x; /* angle */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" __matherr() " Link "__matherr()"} @EndNode @Node "tell()" tell()-Get level 1 file position Synopsis #include apos = tell(fh); long apos; /* absolute file position */ int fh; /* file handle */ Portability @{" UNIX " Link "Glossary - UNIX"} Retur|B߉ns This function returns -1L if an error occurs, in which case @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"} contain additional error information. See Also @{" errno " Link "errno"} , @{" ftell() " Link "ftell()"} , @{" lseek() " Link "lseek()"} , @{" _OSERR " Link "_OSERR"} , @{" open() " Link "open()"} @EndNode @Node "telldir()" telldir()-Get directory position Synopsis #include loc = telldir(dfd); long loc; /* current read position}v */ DIR *dfd; /* directory file descriptor */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns the location of the next directory entry. See Also @{" opendir() " Link "opendir()"} , @{" readdir() " Link "readdir()"} , @{" seekdir() " Link "seekdir()"} , @{" closedir() " Link "closedir()"} @EndNode @Node "time()" time()-Get system time in seconds Synopsis #include timeval = time(timeptr); time_t timeval; /* time v~A talue */ time_t *timeptr; /* pointer to time value storage */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" asctime() " Link "asctime()"} , @{" ctime() " Link "ctime()"} , @{" gmtime() " Link "gmtime()"} , @{" localtime() " Link "localtime()"} , @{" __tzset() " Link "__tzset()"} @EndNode @Node "__timecvt()" __timecvt()-Convert time_t value to AmigaDOS DateStamp Synopsis #include tp = __timecvt(t); struct DateStamp *tp; /* pointerzs% to converted DateStamp */ time_t t; /* time value to convert */ Portability AmigaDOS Returns This function returns a pointer to a DateStamp array. This array is considered read only and is valid only until the next call to __timecvt(). See Also @{" mktime() " Link "mktime()"} @EndNode @Node "timer()" timer()-Get system clock with microseconds Synopsis #include x = timer(clock); int x; unsigned int clock[2]; Portability ) AmigaDOS Returns If successful, this function returns a 0. Otherwise, it returns a -1. @EndNode @Node "__timezone" __timezone-timezone bias from GMT Synopsis extern long __timezone; Description __timezone contains the number of seconds that must be subtracted from GMT. This variable is initialized by the @{" __tzset() " Link "__tzset()"} function and used by the @{" localtime() " Link "localtime()"} function to adjust from Greenwich Mean Time (GMT) to tRTohe local time. Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" __daylight " Link "__daylight"} , @{" localtime() " Link "localtime()"} , @{" __tzname " Link "__tzname"} , @{" __tzdtn " Link "__tzdtn"} , @{" __tzset() " Link "__tzset()"} , @{" __tzstn " Link "__tzstn"} @EndNode @Node "__tinymain()" __tinymain()-Special version of __main() Synopsis #include void __tinymain(line); char *line; /* ptr to command line that caused execution'7 */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" main() " Link "main()"} , @{" __main() " Link "__main()"} @EndNode @Node "tmpfile()" tmpfile()-open a temporary file stream Synopsis #include fp = tmpfile(void); FILE *fp; /* pointer to temporary file stream */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a file handle for a file that can be read or written. When this file is closed, itF[. is automatically deleted. See Also @{" open() " Link "open()"} , @{" close() " Link "close()"} , @{" tmpnam() " Link "tmpnam()"} @EndNode @Node "tmpnam()" tmpnam()-create a temporary file name Synopsis #include name = tmpnam(b); char *name; /* pointer to temporary file name */ char *b; /* pointer to name buffer or NULL */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns a pointer to a temporary file name. Se*e Also @{" tmpfile() " Link "tmpfile()"} @EndNode @Node "toascii()" toascii()-Convert character to ASCII Synopsis #include cc = toascii(c); int cc; /* converted character */ int c; /* character to convert */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __ctype " Link "__ctype"} , @{" isascii() " Link "isascii()"} @EndNode @Node "tolower()" tolower()-Convert character to lowercase Synopsis #include cc = to2kȧlower(c); int cc; /* converted character */ int c; /* character to convert */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" __ctype " Link "__ctype"} , @{" islower() " Link "islower()"} , @{" strlwr() " Link "strlwr()"} @EndNode @Node "toupper()" toupper()-Convert character to uppercase Synopsis #include cc = toupper(c); int cc; /* converted character */ int c; /* character to convert */ Portability @{" ANSI " Link _"Glossary - ANSI"} See Also @{" __ctype " Link "__ctype"} , @{" isupper() " Link "isupper()"} , @{" strupr() " Link "strupr()"} @EndNode @Node "tqsort()" tqsort()-Sort an array of text pointers Synopsis #include void tqsort(ta,n); char *ta[]; /* pointer to text pointer array */ size_t n; /* number of elements in array */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" dqsort() " Link "dqsort()"} , @{" fqsort() " Lip nk "fqsort()"} , @{" lqsort() " Link "lqsort()"} , @{" qsort() " Link "qsort()"} , @{" sqsort() " Link "sqsort()"} @EndNode @Node "_TZ" _TZ-Default time zone name Synopsis #include extern char *_TZ; Description This variable is the default time zone that is used if there is no environment variable TZ set on the Amiga. If you set it, you must make sure that the memory for it is not freed until you reset it. If _TZ is not set to any value, CST6 is used instead. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __tzset() " Link "__tzset()"} @EndNode @Node "__tzdtn" __tzdtn-Daylight time name Synopsis extern char __tzdtn[4]; Description __tzdtn contains the three-character name for daylight time. This variable is initialized by the @{" __tzset() " Link "__tzset()"} function and used by the @{" localtime() " Link "localtime()"} function to adjust from Greenwich Mean Time (GMT) to the localϿ time. @{" localtime() " Link "localtime()"} Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __daylight " Link "__daylight"} , @{" localtime() " Link "localtime()"} , @{" __timezone " Link "__timezone"} , @{" __tzname " Link "__tzname"} , @{" __tzset() " Link "__tzset()"} , @{" __tzstn " Link "__tzstn"} @EndNode @Node "__tzname" __tzname-timezone names Synopsis extern char *__tzname[2]; Description The two __tzname pointers point to __tzstn and __݌tzdtn, respectively. These strings contain the three-character names for standard time (@{" __tzstn " Link "__tzstn"}) and daylight time (@{" __tzdtn " Link "__tzdtn"}). These variables are initialized by the @{" __tzset() " Link "__tzset()"} function and used by the @{" localtime() " Link "localtime()"} function to adjust from Greenwich Mean Time (GMT) to the local time. Portability @{" UNIX " Link "Glossary - UNIX"} See Also @{" __daylight " Link "__daylight";} , @{" localtime() " Link "localtime()"} , @{" __timezone " Link "__timezone"} , @{" __tzdtn " Link "__tzdtn"} , @{" __tzset() " Link "__tzset()"} , @{" __tzstn " Link "__tzstn"} @EndNode @Node "__tzset()" __tzset()-Set time zone variable Synopsis #include void __tzset(void); If the @{" _STRICT_ANSI " Link "_STRICT_ANSI"} flag has not been defined, these symbols are defined in time.h: extern int __daylight; extern long __timezone; extern char *GO__tzname[2]; extern char __tzstn[4]; extern char __tzdtn[4]; extern char *_TZ; Portability XENIX See Also @{" time.h " Link "time.h"} , @{" localtime() " Link "localtime()"} @EndNode @Node "__tzstn" __tzstn-Standard time name Synopsis extern char __tzstn[4]; Description __tzstn contains the three-character name for standard time. This variable is initialized by the @{" __tzset() " Link "__tzset()"} function and used by the @{" localtime() " Link "5Klocaltime()"} function to adjust from Greenwich Mean Time (GMT) to local time. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" __daylight " Link "__daylight"} , @{" localtime() " Link "localtime()"} , @{" __timezone " Link "__timezone"} , @{" __tzname " Link "__tzname"} , @{" __tzdtn " Link "__tzdtn"} , @{" __tzset() " Link "__tzset()"} @EndNode @Node "__ufbs" __ufbs-Array of open level 1 file handles Synopsis #include extern struct UFBfO *__ufbs; Description The external array __ufbs is used to track all open level 1 file handles. The number returned by @{" open() " Link "open()"} or @{" creat() " Link "creat()"} is an index into this table. The external variable __nufbs indicates the number of elements in the __ufbs array. You should never index this array directly. The @{" chkufb() " Link "chkufb()"} function is provided to translate an index into the appropriate UFB structure. In versOions 5.10 and earlier, this array was named _ufbs. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" chkufb() " Link "chkufb()"} , @{" creat() " Link "creat()"} , @{" __nufbs " Link "__nufbs"} , @{" open() " Link "open()"} @EndNode @Node "ungetc()" ungetc()-Push input character back Synopsis #include r = ungetc(c, fp); int r; /* return character or code */ int c; /* character to be pushed back */ FILE *fp; /* file pointer ׌ */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns Normally, ungetc() returns the character that was pushed back. However, if the end-of-file has been reached or if no characters have been read yet, the value EOF is returned. See Also @{" getc() " Link "getc()"} @EndNode @Node "unlink()" unlink()-remove a file Synopsis #include error = unlink(name); int error; /* non-zero if error */ const char *name; /* file name */ }hDf Portability @{" UNIX " Link "Glossary - UNIX"} Returns If a non-zero value is returned, some type of error occurred, and additional information can be found in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. The most common errors occur when you try to remove a file that doesn't exist, that is marked as read-only, or that is in use. See Also @{" errno " Link "errno"} , @{" _OSERR " Link "_OSERR"} , @{" remove() " Link "remove()"} @EndNode @Node "uJItpack()" utpack()-Pack @{" UNIX " Link "Glossary - UNIX"} time Synopsis #include ut = utpack(x); long ut; /* packed UNIX time */ const char *x; /* unpacked UNIX time */ Portability @{" SAS/C " Link "Glossary - SASC"} Returns This function returns a packed long, as described above. See Also @{" ctime() " Link "ctime()"} , @{" getclk() " Link "getclk()"} , @{" gmtime() " Link "gmtime()"} , @{" localtime() " Link "localtime()"} , @{" 1 Istpdate() " Link "stpdate()"} , @{" time() " Link "time()"} , @{" utunpk() " Link "utunpk()"} @EndNode @Node "utunpk()" utunpk()-Unpack @{" UNIX " Link "Glossary - UNIX"} time Synopsis #include void utunpk(ut,x); long ut; /* packed UNIX time */ char *x; /* unpacked UNIX time */ Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" ctime() " Link "ctime()"} , @{" getclk() " Link "getclk()"} , @{" gmtime() " Link "gmtime()"} , @{" localtime(|) " Link "localtime()"} , @{" stpdate() " Link "stpdate()"} , @{" time() " Link "time()"} , @{" utpack() " Link "utpack()"} @EndNode @Node "va_arg()" va_arg()-access an argument from a varying-length argument list Synopsis #include (arg_type) va_arg(va_list ap, arg_type); Portability @{" ANSI " Link "Glossary - ANSI"} Returns This macro returns the value of the next argument in the list. The type is always the same as the second argument to va_arÛT8g(). See Also @{" va_start() " Link "va_start()"} , @{" va_end() " Link "va_end()"} @EndNode @Node "va_end()" va_end()-End varying-length argument list processing Synopsis #include void va_end(va_list ap); Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" va_start() " Link "va_start()"} , @{" va_arg() " Link "va_arg()"} @EndNode @Node "va_start()" va_start()-Begin varying-length argument list processing Synopsis #include H void va_start(va_list ap, arg_name); Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" va_arg() " Link "va_arg()"} , @{" va_end() " Link "va_end()"} @EndNode @Node "vfprintf()" vfprintf()-Varargs formatted write to a file Synopsis #include #include n = vfprintf(fp, ctl, args); int n; /* number of characters written */ /* or -1 for error */ FILE *fp; /*zt file to be written to */ const char *ctl; /* control string specifying formatting */ va_list args; /* items to be formatted */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of characters written or, in the case of an error, a -1. See Also @{" fprintf() " Link "fprintf()"} , @{" printf() " Link "printf()"} , @{" sprintf() " Link "sprintf()"} , @{" Formatted Output Specifiers " Link "FMormatted Output Specifiers"} @EndNode @Node "vprintf()" vprintf()-Varargs formatted write to standard output Synopsis #include #include x = vprintf(ctl, args); int x; /* number of characters written */ /* or -1 for error */ const char *ctl; /* control string specifying formatting */ va_list args; /* items to be formatted */ Portability @{" ANSI " Link "GloWȀssary - ANSI"} Returns This function returns the number of characters written or, in the case of an error, a -1. See Also @{" fprintf() " Link "fprintf()"} , @{" printf() " Link "printf()"} , @{" sprintf() " Link "sprintf()"} , @{" Formatted Output Specifiers " Link "Formatted Output Specifiers"} @EndNode @Node "vsprintf()" vsprintf()-Varargs formatted write to string Synopsis #include #include x = vsprintf(buf, ctl, args); int x; QF( /* number of characters placed in the */ /* output buffer */ char *buf; /* String for resulting image */ const char *ctl; /* control string specifying formatting */ va_list args; /* items to be formatted */ Portability @{" ANSI " Link "Glossary - ANSI"} Returns This function returns the number of characters placed in the output buffer (excluding the terminating null byte)w. See Also @{" fprintf() " Link "fprintf()"} , @{" printf() " Link "printf()"} , @{" sprintf() " Link "sprintf()"} , @{" Formatted Output Specifiers " Link "Formatted Output Specifiers"} @EndNode @Node "wait()" wait()-wait for single child process to complete Synopsis #include cc = wait(procid); int cc; /* child's completion code */ struct ProcID *procid; /* pointer to process ID structure */ Portability @{" UNIX " Link  "Glossary - UNIX"} Returns This function returns the integer completion code of the child process. Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" exit() " Link "exit()"} , @{" forkl() " Link "forkl()"} , @{" forkv() " Link "forkv()"} , AmigaDOS functions @{" LoadSeg() " Link "exec/LoadSeg()"} and @{" CreateProc() " Link "dos/CreateProc()"} @EndNode @Node "waitm()" waitm()-wait for multiple child processes to complete Synopsis #include  complist = waitm(proclist); struct ProcID *complist; /* pointer to linked list of */ /* completed process IDs */ struct ProcID **proclist; /* address of pointer to linked */ /* list of process IDs */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns This function returns a pointer to a linked list of completed processes. Portability @{" SAS/C " Link "Glossary - SA$(VSC"} See Also @{" exit() " Link "exit()"} , @{" forkl() " Link "forkl()"} , @{" forkv() " Link "forkv()"} , AmigaDOS functions @{" LoadSeg() " Link "exec/LoadSeg()"} and @{" CreateProc() " Link "dos/CreateProc()"} @EndNode @Node "wcstombs()" wcstombs()-Convert a wide-character string to a multibyte string Synopsis #include length = wcstombs(s, pwcs, n); size_t length; /* length or state information */ char *s; /* pointer toJ characters */ const wchar_t *pwcs; /* pointer to wide-character string */ size_t n; /* maximum number of characters to look at */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" wctomb() " Link "wctomb()"} , @{" mblen() " Link "mblen()"} @EndNode @Node "wctomb()" wctomb()-Map wide character to multibyte character Synopsis #include length = wctomb(s, wc); int length; /* length or state information */ char *s; /* pointer to characters or NULL */ wchar_t wc; /* wide character */ Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" wcstombs() " Link "wcstombs()"} , @{" mblen() " Link "mblen()"} @EndNode @Node "write()" write()-write to level 1 file Synopsis #include count = write(fh,buffer,length); int count; /* actual bytes read or written */ int fh; /* file handle */ void *buffer; /* data buffer */W8 unsigned int length; /* number of bytes to read or write */ Portability @{" UNIX " Link "Glossary - UNIX"} Returns If the operation is successful, this function returns the actual number of bytes transferred. Otherwise, it returns -1 and places error information in @{" errno " Link "errno"} and @{" _OSERR " Link "_OSERR"}. See Also @{" errno " Link "errno"} , @{" fwrite() " Link "fwrite(),"} , @{" _OSERR " Link "_OSERR"} , @{" open() " Link "open()"} , @݀r{" read() " Link "read()"} @EndNode @Node "_XCEXIT()" _XCEXIT()-Terminate program and close files Synopsis #include void _XCEXIT(lcode); long lcode; Portability @{" SAS/C " Link "Glossary - SASC"} See Also @{" exit() " Link "exit()"} @EndNode @Node "C Operator Precedence" Operator Precedence and Associativity All operators in a block (between two lines of dashes) are of equal precedence. The blocks are arranged in descending order (in otherM6 words, '!' will be evaluated before '*'). Associativity is the order in which the parameters of that operator are evaluated. Operator Description Associativity ------------------------------------------------------------------ () function call left-to-right [] array index . structure or union member -> pointer to structure or union member --------------w=---------------------------------------------------- ! logical NOT right-to-left ~ one's complement - unary negation ++ increment -- decrement & address of * indirection (type) type cast sizeof size in bytes ------------------------------------------------------------------ * multiply left-to-righYt / divide % modulus ------------------------------------------------------------------ + add left-to-right - subtract ------------------------------------------------------------------ << left shift left-to-right >> right shift ------------------------------------------------------------------ < less than Po! left-to-right <= less than or equal > greater than >= greater than or equal ------------------------------------------------------------------ == equal left-to-right != not equal ------------------------------------------------------------------ & bitwise AND left-to-right -------------------------------------------Fw----------------------- ^ bitwise XOR left-to-right ------------------------------------------------------------------ | bitwise OR left-to-right ------------------------------------------------------------------ && logical AND left-to-right ------------------------------------------------------------------ || logical OR 2π left-to-right ------------------------------------------------------------------ ?: conditional right-to-left ------------------------------------------------------------------ = assignment operators right-to-left *= /= %= += -= <<= >>= &= ^= |= ------------------------------------------------------------------ , comma left-to-Iright ------------------------------------------------------------------ @EndNode @Node "Formatted Input Specifiers" '%' specifiers for formatted input, according to the @{" ANSI " Link "Glossary - ANSI"} standard. Specifier Meaning --------- ------- d,i signed integer o octal unsigned integer u unsigned integer x hexadecimal unsigned integer e,f,g floating point s atlny string of non-whitespace characters [ any non-empty sequence of characters from specified set; can optionally include leading ^ to specify NOT in set c any character p pointer value n number of characters read from input % exact match for percent (%) character NOTE: Input whitespace characters are skipped, unless the specification contains a [, c, or n specifier. See쑭 Also @{" fscanf() " Link "fscanf()"} , @{" scanf() " Link "scanf()"} , @{" sscanf() " Link "sscanf()"} @EndNode @Node "Formatted Output Specifiers" '%' specifiers for formatted output, according to the @{" ANSI " Link "Glossary - ANSI"} standard. Specifier Meaning --------- ------- d,i 'int' argument is converted to a signed decimal string o 'unsigned int' argument is converted to octal string u 'unsigned int' l\oargument is converted to decimal string x 'unsigned int' argument is converted to lowercase hexadecimal string X 'unsigned int' argument is converted to uppercase hexadecimal string f 'double' argument is converted to a decimal string e,E,g,G 'double' argument is converted to a decimal string using scientific notation c 'int' argument is converted to@ an unsigned char s argument is a pointer to a NULL terminated array of character type (C-style string) p argument is printed as a pointer, using lowercase hexadecimal characters P argument is printed as a pointer, using uppercase hexadecimal characters n argument is a pointer to an integer into which will be written the number of characters output so far % a percent sign (%) will be written See Also @{" fprintf() " Link "fprintf()"} , @{" printf() " Link "printf()"} , @{" sprintf() " Link "sprintf()"} , @{" vfprintf() " Link "vfprintf()"} @{" vprintf() " Link "vprintf()"} , @{" vsprintf() " Link "vsprintf()"} @EndNode @Node "Glossary" @{" ANSI " Link "Glossary - ANSI"} @{" SAS/C " Link "Glossary - SASC"} @{" UNIX " Link "Glossary - UNIX"} @{" XENIX " Link "Glossary - XENIX"} @EndNode @Node "ȿ:}Glossary - ANSI" American National Standards Institute. Functions with this portability level comply with the ANSI standard for the C language, document number X3J11/90-013. @EndNode @Node "Glossary - SASC" @Title "Glossary - SAS/C" Functions with this portability level are only guaranteed to work with the SAS/C Development System environment. They may or may not exist in other C compiler implementations, and if they do, they may take different parameters, return different values,5ȸ etc. @EndNode @Node "Glossary - UNIX" Functions with this portability level are based on common usage under the UNIX operating system. They may or may not function the same as any particular UNIX compiler implementation. Compare the docs between the UNIX system the code came from, and our documentation to make sure they match. @EndNode @Node "Glossary - XENIX" Functions with this portability level are based on common usage under a variant of the UNIX operating system called XENI!:9X. They may or may not function the same as any particular XENIX compiler implementation. Compare the docs between the XENIX system the code came from, and our documentation to make sure they match. @EndNode @node HELP "HELP" You have reached this Help window by either clicking on the Help button or by hitting the Help key within the SAS/C Help utility. Unlike other help topics present in the SAS/C Help utility, the Help help topic opens its own window. You must close this window b  y clicking on the close gadget or hitting escape before returning to the SAS/C help utility. You cannot hit the Retrace button to return. To quit the SAS/C Help utility, select Quit from the Project menu or click on the close gadget. You may also hit escape. Most help screens will display one or more buttons as part of the text. Clicking on these buttons will provide further information on the topic listed on the button. You can also reach these help topics through the main Cont Gents screen or one of its sub-screens. In addition, double-clicking in the help window will bring up a help screen for the word under the mouse cursor, if such a help screen exists. While in the SAS/C Help utility, you may retrace your steps through the help screens you have selected by clicking on the Retrace button. The Browse buttons will move you forward and backwards between help screens. The help screens are usually arranged alphabetically by command or topic. @endnode ContHc~" cpr.guide@database "cpr.guide" Copyright (c) 1992 SAS Institute, Inc, Cary, NC All Rights Reserved @master "cpr.guide" @node Main "CPR Help" CPR Commands and Builtin-Functions @{" Activate " link Activate} @{" DETach " link DETach} @{" HUnks " link HUnks} @{" Register " link Register} @{" STRLEN " link STRLEN} @{" WDisable " link WDisable} @{" ALias " link ALias} @{" Display " link Display} @{" Jump " link Jump} @{" REStart " link REStart} @{" SYMBol " link SYMBZol} @{" WEnable " link WEnable} @{" ARgs " link ARgs} @{" DUmp " link DUmp} @{" List " link List} @{" RETurn " link RETurn} @{" SYMload " link SYMload} @{" WHAtis " link WHAtis} @{" BClear " link BClear} @{" DZero " link DZero} @{" LOg " link LOg} @{" RFlag " link RFlag} @{" TAsks " link TAsks} @{" WHEre " link WHEre} @{" BDisable " link BDisable} @{" ECho " link ECho} @{" MEMCMP " link MEMCMP} @{" SEArch " link SEArch} @{" Trace|} " link Trace} @{" WIndow " link WIndow} @{" BEnable " link BEnable} @{" ENV " link ENV} @{" MEMCPY " link MEMCPY} @{" SEt " link SEt} @{" TS " link TS} @{" WList " link WList} @{" BList " link BList} @{" EXecute " link EXecute} @{" MEMMOVE " link MEMMOVE} @{" SLEep " link SLEep} @{" UNAlias " link UNAlias} @{" WMSG " link WMSG} @{" Break " link Break} @{" EXPAND " link EXPAND} @{" MEMSET " link MEMSET} @{" SOurce " link SOOSurce} @{" Unassemble " link Unassemble} @{" Call " link Call} @{" FINish " link FINish} @{" OPt " link OPt} @{" STArt " link STArt} @{" UNDefine " link UNDefine} @{" CAtch " link CAtch} @{" FRegister " link FRegister} @{" Proceed " link Proceed} @{" STRCAT " link STRCAT} @{" Watch " link Watch} @{" DEActivate " link DEActivate} @{" Go " link Go} @{" PS " link PS} @{" STRCMP " link STRCMP} @{" WBreak " link WBreak} @{" DEFine " link }aDEFine} @{" Help " link "Help Command"} @{" Quit " link Quit} @{" STRCPY " link STRCPY} @{" WClear " link WClear} @{" Parameter Types " link "Parameter Types"} @{" Common Problems " link sc:help/sc_prob.guide/cpr} @{" Changes to the Documentation " link sc:help/sc_change.guide/cpr} @endnode @node "Parameter Types" @{" Address " link Address} @{" Expression " link Expression} @{" Line " link Line} @{" String " link String} @{" Argument-List (" link Argument-List} @{" Filename " link Filename} @{" Location " link Location} @{" Subrange " link subrange} @{" Array-Slice " link Array-Slice} @{" Format " link Format} @{" Module " link Module} @{" Task-Address " link Task-Address} @{" Cmd-List " link Cmd-List} @{" Function " link Function} @{" Name " link Name} @{" Task-Name " link Task-Name} @{" Command " link Command} @{" Hex-Address " link Hex-Address} @{" Number " link Number} @{" Text " link Text} @{" Command-Line " link Command-Line} @{" Image " link Image} @{" Parm " link Parm} @{" Type " link Type} @{" Definition " link Definition} @{" Integer " link Integer} @{" Range " link Range} @{" Variable " link Variable} @{" Directory " link Directory} @{" Itemsize " link Itemsize} @{" Register " link Register} @{" Builtin Function ParameterȲ>s " link "Builtin Function Parameters"} @endnode @node ADDRESS "ADDRESS" ADDRESS is any valid expression that denotes an address. This may be a hexadecimal constant, a C pointer variable, a @{" register " link register}, the result of prefixing & to a C identifier of the proper type, or the result of arithmetic calculations on other addresses. Note that the address operator & may not be applied to the identifier of a bitfield or a register. The following are examples of values of  Texpressions that denote an address where p is a pointer, and i and x are integers: &i (&i + 8) &array[3] &mystruct - x p 0x00C85400 a0 (a0 + 0x22) There are some cases where a register name may be ambiguous. For example, you may have defined a variable sp in your program. In the following command it is not clear whether you mean to dump data beginning at the variable sp, or at the address contained in the register SP: db sp In such cases the debugger  will assume that you mean to refer to the variable sp. However, you can prefix the register name with a dollar sign ($) or use the register command to examine the value of the sp register even if you have declared a variable named SP. In certain commands, it is necessary to specify the type of an object to be modified or displayed. If the object is referred to by means of an address constant or register, the value is assumed to be a character pointer (char *). @endnode @node ARGUM QMXENT-LIST "ARGUMENT-LIST " ARGUMENT-LIST provides the arguments for the program being debugged. These arguments are delimited by white space, just as would appear on the command line when invoking the program. The program will use these arguments as if it were invoked from the command line with them. @endnode @node ARRAY-SLICE "ARRAY-SLICE " ARRAY-SLICE is a contiguous section of a unidimensional array of scalar variables, an ordered selection of elements from a multidimensional arra y2y, or an ordered selection of members from an array of complex types. ARRAY-SLICE is specified using the following form: @{" variable " link variable} [[n..m] | [*]] Note: The inner brackets in this syntax diagram are not optional and do not denote optional parameters. The advantage of using an array-slice parameter over a @{" range " link range} parameter is that the array-slice can be used to select isolated subcomponents, such as a particular structure membe ›`4r from an array of structures. The array-slice parameter also can be nested for multidimensional arrays or structure members that are arrays themselves. The @{" subrange " link subrange} parameter is described elsewhere in this document. If a subrange is chosen as the index of an array-slice, those elements within the subrange are selected. The asterisk (*) index specifies that all elements of the array are to be contained in the array-slice. The following are examples of the ar~4ray-slice parameter: a[3..7] matrix[i..j][1..3] b[*] a[3..6]->b @endnode @node CMD-LIST "CMD-LIST" CMD-LIST can be replaced by one or more valid commands, separated by semi-colons (;). A backslash may be used to continue the line. @endnode @node COMMAND "COMMAND" COMMAND can be replaced with any CPR command or other help topic. @endnode @node COMMAND-LINE "COMMAND-LINE" COMMAND-LINE can be any valid comY? mand-line that can be typed in at the prompt in the Dialog window. @endnode @node DEFINITION "DEFINITION" DEFINITION can be replaced with any valid string which defines the @{" name " link name} specified in the command. @endnode @node DIRECTORY "DIRECTORY" DIRECTORY can be any valid existing AmigaDOS directory name. @endnode @node EXPRESSION "EXPRESSION" An EXPRESSION can be any C expression, except those that use one or more of the following operators: ++ or -- i <<= , (comma) += ?: -= = *= &= /= |= %= >>= ^= @endnode @node FILENAME "FILENAME" FILENAME can be replaced by any valid AmigaDOS filename. @endnode @node FORMAT "FORMAT" FORMAT should be replaced by differnt values, depending whether you are entering a @{" DUMP*w " link DUMP} command or a @{" DISPLAY " link DISPLAY} command. For the @{" DISPLAY " link DISPLAY} command, a default FORMAT specifier is defined. The default is determined by what type of variable you are displaying. To override the default format, replace FORMAT with a printf() style format specifier, such a "1.3%f" No error checking is done on the format specifier, so strange results are possible. For the @{" DUMP " link DUMP} command, the default form.@Sat is hex. All values dumped will be displayed with as a hex value, regardless of their type. The format of the output of the @{" DUMP " link DUMP} command can be controlled by specifying any of the following for FORMAT: a[scii] FFP[float] IEEE[float] b[inary] f[loat] o[ctal] d[ecimal] h[ex] u[nsigned] @endnode @node FUNCTION "FUNCTION" FUNCTION is the name of a function in the application. You can put spaces y\between the value specified for @{" image " link IMAGE} and its colon postfix and the value specified for @{" module " link MODULE} and its backslash postfix, but they are not necessary. You must put a space before the @{" line " link line} parameter. @endnode @node HEX-ADDRESS "HEX-ADDRESS" HEX-ADDRESS can be replaced by any valid hexadecimal constant. Care should be taken that the HEX-ADDRESS specified is within the valid address space allcoated for your program. @endnode @node IBMAGE "IMAGE" IMAGE is the name of the executable image (the program, library, or device) containing the location. It is usually specified in lowercase. If omitted, the current image is the default. In a program with only one image, it is never necessary to specify a value for IMAGE: Note the required colon (:). @endnode @node INTEGER "INTEGER" INTEGER can be replaced be any valid integer value, 0 to 32768. All of these numbers may not be valid within the context of a particular cneSommand. For instance, substituting 4567 where a line number is required would be meaningless for a module with 120 lines. @endnode @node ITEMSIZE "ITEMSIZE" ITEMSIZE is an optional parameter that controls the length of each item dumped by the @{" DUMP " link DUMP} command. ITEMSIZE can have a value of 1, 2, 4, or 8. ITEMSIZE is concatenated onto the end of the @{" format " link format} parameter (for example, b4 for a binary format of length 4). If you do not specify ITEMSIZE, C˳!HodeProbe uses a default. As shown in the following table, the allowable size and default values depend on the format specified. ITEMSIZE has the following default values and allowable sizes: Format Default Allowed Sizes ------ ------- ------------- ascii 1 1 binary 1 1, 2, 4 decimal 4 1, 2, 4 FFPfloat 4 f 4 float 8 4, 8 hex 4 1, 2, 4 IEEEfloat 8 4, 8 octal 4 1, 2, 4 unsigned 4 1, 2, 4 @endnode @node LINE "LINE" The LINE parameter can specify any of the following points in the source code: @{" integer " link integer} a line number, relative to the start of the C source file containing the function $ the28X current location e[ntry] the entry to the function (prolog) r[eturn] the return from the function (epilog). If the function name is not specified with the LINE parameter, the debugger defaults to the current function. If a function is specified without a line, the debugger defaults to the first execution line. @endnode @node LOCATION "LOCATION" LOCATION specifies a place in the code at which a breakpoint is to be set, code is to be unassembled, or a similar action is to be pR$ tasks all Address Type Pri State SigWait StackPtr Debu&<~(g Name 003D2498 13 0 Running 00000100 003D1D4E Cpr 002BED58 13 0 Waiting 80001000 002BFC66 iprefs 37.8 (31.5.91) 0035E9E0 13 0 Waiting C0003000 00371B66 Background CLI 00287790 1 5 Waiting F0000000 00287736 console.device 00295498 13 10 Waiting 40000100 00295E5A DF2 0029DA98 13 10 Waiting 40000100 0029E45A Work @endnode @node TASK-NAME "TASK-NAME" TASK-NAME is the name of a task. TASK-NAME can be determined from the output of the @{" TA'?@GSKS " link TASKS} command. The following example is a partial listing of output from the "tasks all" command. Note that TASK-NAME is listed on the far right. > tasks all Address Type Pri State SigWait StackPtr Debug Name 003D2498 13 0 Running 00000100 003D1D4E Cpr 002BED58 13 0 Waiting 80001000 002BFC66 iprefs 37.8 (31.5.91) 0035E9E0 13 0 Waiting C0003000 00371B66 Background CLI 00287790 1 5 Waiting F0000000 00287736 console.device 00295498 13 ( 10 Waiting 40000100 00295E5A DF2 0029DA98 13 10 Waiting 40000100 0029E45A Work @endnode @node TEXT "TEXT" TEXT can be replace by any ASCII string. If TEXT contains semicolons, they must be escaped with a backslash (\;). Defines or aliases are not expanded. @endnode @node TYPE "TYPE" TYPE can be any of the data types provided by the C language including any of the following: char unsigned long unsigned char unsigned sho) prt float unsigned short double int struct @{" name " link name} unsigned int union @{" name " link name} long enum @{" name " link name} A type also can be any of the C types previously listed followed by some number of asterisks indicating that the type is a pointer to the base object. In addition, the type parameter can take any identifier defined by means of a typedef stateme*߃2nt if the debugging information for the @{" module " link module} supplies typedef information. @endnode @node VARIABLE "VARIABLE" VARIABLE is an expression in your program that designates an object. It can be either a simple identifier or an expression referring to an array element, structure member, or object pointed to by a pointer. In addition, it can begin with a specification of the following form: [[@{" image " link IMAGE}:][\@{" module " link MODULE}\]@{" fu+ jqInction " link function}] See the other parameter descriptions in this document for a description of @{" image " link IMAGE}, @{" module " link MODULE}, and @{" function " link function}. The following are objects which fit the definition of the variable parameter: i max array[3] array io:readfile\length mystruct->name[2] mystruct *cptr ,k main.c\opnf\count opnf\i mylib.library:LIBmyfunc\myvar @endnode @node "Builtin Function Parameters" The parameters to CodeProbe's built-in functions are a little more flexible than the parameters to the C versions: formal type actual parameter types allowed ----------- ------------------------------- void * constant, register, any pointer scalar, array, fun-ction, address, string constant char * constant, register, character pointer, unsigned character pointer, character array, string constant int constant, register, any integral scalar, bitfield, enumerated constant Floating-point constants and registers are not allowed, and string constants can only be specified as the source operand. @endnode @node "Common Pr.oblems" Some common problems you might encounter include: The display command will not work correctly. .... @endnode @node Activate "Activate" Activate -- Activates a task under debugger control SYNOPSIS a[ctivate] [@{" task-name " link task-name} | @{" task-address " link task-address} | @{" filename " link filename}] DESCRIPTION The activate command activates a task that has been deactivated by the deactivate command. The task is activated when the next go or proceed command/䓛 is executed. The @{" task-name " link task-name} and @{" task-address " link task-address} are the name of the task and the address of the task as specified by the tasks command. The @{" filename " link filename} parameter can be used to specify the name of the executable associated with the task you want to catch. Only one of these parameters can be specified. EXAMPLES activate Child /* activates the task named Child under debugger control */ ac0~tivate 0xC08540 /* activates the task with a task block starting at address 0xC08540 */ activate myprog /* activates the task executing the program myprog */ SEE ALSO @{" CAtch " link CAtch}, @{" DEActivate " link DEActivate}, @{" DETach " link DETach}, @{" TAsks " link TAsks } @endnode @node ALias "ALias" ALias -- Define an alias for a debugger command SYNOPSIS al[ias] [@{" name " link name} [@{" definition " link definiti1e3on}]] DESCRIPTION When entered with no arguments, the alias command displays the list of all currently defined aliases. If a value for @{" name " link name} is provided as the only argument, the definition for that alias will be displayed. Any text following the @{" name " link name} parameter is treated as a definition and is used to define the alias. Alias names are expanded only when they occur at the beginning of a Dialog window command line. An alias definition can be a sim2sple textual substitution or it can contain positional parameters to be expanded at execution time. Positional parameters are specified as $1, $2, $3, and so on. $0 represents the alias name itself. $* represents command line parameters $1 through $n. If no positional parameter is specified in a definition, all parameters are placed after the expanded definition text. The alias command will parse a @{" definition " link definition} until it encounters a command delimiter characte3SB6r (;) or the end of the line. To define an alias that expands into more than one command, enclose the definition in either double quotes or curly braces. If the command string must contain double quotes, curly braces can be used or the quotes can be escaped. As in C and all other debugger commands, a backslash may be used to continue the line. EXAMPLES alias /* displays a list of all alias definitions */ alias foo /* displays a definition of foo */4W alias next proceed /* defines next to be an alias for proceed */ alias pr display foo, bar, $* /* defines pr to be an alias that executes the display command printing the value of foo, bar, and any variables entered after the pr */ alias doit {go $1; d foo} /* defines doit to execute the go command using the first parameter, and displays the variable named foo */ alias doit {go $1;\ d foo} 5qk /* uses the backslash command to split a command across two lines */ alias doit "go $1; d $2 " /* uses positional parameters with multiple commands. The first parameter, $1, is passed to the go command, and the second parameter, $2, is passed to the display command */ SEE ALSO @{" DEFine " link DEFine}, @{" UNALias " link UNALias}, @{" UNDefine " link UNDefine} @endnode @node ARgs "ARgs" ARgs -- Displays the argum6~ents to a function SYNOPSIS ar[gs] [@{" function " link function}] DESCRIPTION The args command displays all of the argument names and values to the current function or the function specified by the @{" function " link function} parameter. If a @{" function " link function} parameter is specified it must be in the calling sequence, as displayed by the where command. EXAMPLES args /* displays the arguments to the current function */ args sort /* displays the argument7Ojs to the sort function */ SEE ALSO @{" Display " link Display}, @{" ENV " link ENV}, @{" WHEre " link WHEre} @endnode @node BClear "BClear" BClear -- Clears one or more breakpoints SYNOPSIS bc[lear] @{" integer " link integer} [@{" integer " link integer}...] bc[lear] * | l[ast] bc[lear] @{" integer " link integer}..@{" integer " link integer} DESCRIPTION The bclear command clears one or more breakpoints. When a breakpoint is cleared, it ceases to exist and can be reinstate8d only by issuing the break command again. You should use the bdisable command to disable breakpoints temporarily. The @{" integer " link integer} parameter specifies the breakpoint number as displayed by the blist command. Any number of values can be specified as @{" integer " link integer} parameters. An asterisk specifies that all breakpoints should be cleared and last causes the most recently set breakpoint to be cleared. A range of breakpoints can be specified by @{" integer9 " link integer}..@{" integer " link integer}. EXAMPLES bclear 2 5 6 /* clears the breakpoints numbered 2, 5, and 6 */ bclear last /* clears the last breakpoint set */ bclear * /* clears all breakpoints */ bclear 4 .. 7 /* clears breakpoints 4, 5, 6, and 7 */ SEE ALSO @{" BDisable " link BDisable}, @{" BEnable " link BEnable}, @{" BList " link BList}, @{" Break " link Break}, @{" WClear " link WClear} @endnode @node BDisable "BDisable" BDisable -- Disable on:e or more breakpoints SYNOPSIS bd[isable] @{" integer " link integer} [@{" integer " link integer} ...] bd[isable] * | l[ast] bd[isable] @{" integer " link integer}..@{" integer " link integer} DESCRIPTION The bdisable command disables the recognition of one or more breakpoints. When a breakpoint is disabled, it is not recognized by CodeProbe, but it does remain on the list of current breakpoints. A disabled breakpoint can be re-enabled by the benable command. The @{" inte;6rger " link integer} parameter specifies the breakpoint number as displayed by the blist command. Any number of values can be specified as @{" integer " link integer} parameters. An asterisk specifies that all breakpoints should be disabled and last causes the most recently set breakpoint to be disabled. A range of breakpoints can be specified by @{" integer " link integer}..@{" integer " link integer}. EXAMPLES bdisable 2 5 6 /* disables the breakpoints numbered 2, 5, and 6<es the most recently set breakpoint to be enabled. A range of breakpoints can be specified by @{" integer " link integer}..@{" integer " link integer}. EXAMPLES benable 2 5 6 /* enables the breakpoints numbered 2, 5, and 6 */ benable last /* enables the last breakpoint set */ benable * /* enables all breakpoints */ benable 4 .. 7 /* enables breakpoints 4, 5, 6, and 7 */ SEE ALSO @{" BClear " link BClear}, @{" BDisable " link BDisable}, @{" BList " link ?cUBList}, @{" Break " link Break}, @{" WEnable " link WEnable} @endnode @node BList "BList" BList -- Lists all breakpoints SYNOPSIS bl[ist] DESCRIPTION The blist command displays a list of all breakpoints. Each entry has a form similar to the following example: 5 0x40054 loop:\loop.c\main 8 (2 hits) after(4) when(i == 3) quiet {echo Hi} The number 5 in this example is the number used to refer to this breakpoint in bclear, bdisable, and benable commands. If an asterisk@9 appears next to the number, that breakpoint has been disabled and will not be triggered. Following the breakpoint number is the hexadecimal address at which the breakpoint resides. If sufficient debug information is available, the address is followed by the location that it represents. The hit count, which represents a running count of the number of times the breakpoint has been triggered, is displayed after the location of the breakpoint. A breakpoint is triggered when all of tA(he following conditions are true: - execution has reached the address shown - the when and after conditions are true, if specified - the breakpoint is enabled. Breakpoints are triggered when the user steps to the address provided the last two conditions are met. The second line of output displayed by the blist command shows the options given when the break command was issued. SEE ALSO @{" BClear " link BClear}, @{" BDisable " link BDisable}, @{" BBEnable " link BEnable}, @{" Break " link Break}, @{" WList " link WList} @endnode @node Break "Break" Break -- Sets a breakpoint SYNOPSIS b[reak] @{" location " link location} [after(@{" integer " link integer})] [when(@{" expression " link expression})] [tr[ace]] [q[uiet]] [te[mp]] [{@{" cmd-list " link cmd-list}}] DESCRIPTION The break command is used to set a breakpoint at a location specified by the @{" location " link location} parameter. You can use a dollar sigC?0n to specify the current location. The after option specifies the minimum number of times the specified line must be executed before the breakpoint is triggered. This is also known as specifying a pass count. For break commands that do not contain an after clause, the pass count is set to 1. Each time the breakpoint is hit, the pass count is tested. If the pass count equals 1, the breakpoint is triggered and execution stops. If the pass count is greater than 1, the pass count iDuхs decremented by 1, and execution continues. The blist command shows the current pass count for each breakpoint. If the when option is present, the breakpoint is triggered only if the specified @{" expression " link expression} evaluates to true (nonzero). The after and when options can be specified in any order. If both options are specified, the pass count is tested and decremented only when the when condition is true. The trace option continues execution automatically after tEj[~he breakpoint is triggered, unless you reach the breakpoint by single-stepping, then the the trace option has no effect. The quiet option suppresses the default message showing the location when the breakpoint is triggered. The temp option causes the breakpoint to be deleted after it has been triggered. If the @{" cmd-list " link cmd-list} parameter is present, the commands listed are performed each time the breakpoint is triggered. As in C commands and all other debugger commandFTs, a backslash may be used to continue the line. Note: To avoid confusion, the break command does not use the default radix setting. You must specify Ox for an address; otherwise, you will be specifying a line number. For example, even if the radix is set to hex, the following command specifies a break command for line 20 and not address 0x20: b 20 EXAMPLES break $ /* sets a breakpoint at the current line */ b 14 /* sets a breakpoint at line 14 G;>of the current @{" module " link module} */ b sort /* sets a breakpoint at the first line of the sort function */ break sort return /* sets a breakpoint at the return from the sort function */ break \myfile.c\sort 14 /* sets a breakpoint at line 14 of sort in the @{" module " link module} named myfile.c */ break mylib.library:myfunc /* sets a breakpoint at the first line of theH= myfunc function in the shared library mylib.library */ b $ after(5) /* breaks the fifth time the current line is executed */ break 0x804A /* sets a breakpoint at the absolute address 0x804A */ break 14 when (i > 5) {di p L 16; b sort 26 when (i == 8); bl; go} /* sets a breakpoint on line 14 that performs the commands given inside the curly braces if i > 5 H`HEDCBA@?>=<;:9876543210/.-,+*)('&%$#"!      FI)# evaluates true */ b 8 trace quiet {d "i = ", i} /* prints a message of the form "i = value " every time line 8 is executed */ break 100 temp {d foo} /* stops at line 100, prints foo, and deletes this breakpoint */ SEE ALSO @{" BClear " link BClear}, @{" BDisable " link BDisable}, @{" BEnable " link BEnable}, @{" BList " link BList}, @{" Go " link Go} @endnode @node Call "Call" Call -- Evaluates an expression and disJH*cards the result SYNOPSIS c[all] @{" expression " link expression} DESCRIPTION The call command is used to evaluate an expression when you do not care about the value returned. It is equivalent to the following statement in C language: @{" expression " link expression}; The most common use of the call command is to call a function in the application program, though function calls also may appear in arbitrary expressions in other commands. If you want to see KwT|the value returned by the expression, use the display command. The debugger looks at the types of the parameters specified and not at the definition of the function or any prototype. Thus, the debugger does not flag an error if the wrong number of parameters are specified, nor does it perform automatic casting of types or allow passing of char, short, or float types. For example, the following command passes two parameters, an int and a double, regardless of how the function is deL>clared: call f(2, 1.5) CodeProbe supports standard C syntax for function calls. Either a function name or an expression evaluating to a function type may be specified before the opening parenthesis. Thus, the call command can be used only to call functions or evaluate expressions that point to a function. For example, if pf is a function pointer, and func is a function, the following commands are allowed: call func() call (*M ypf)() However, the following commands are not allowed: call pf() call 0x134() call register() You cannot use the call command to execute a function after a program has ended. If a breakpoint is hit, a signal is caught, or the program terminates in the middle of a function call, the debugger aborts the expression and leaves you at that location. A warning is printed if any parameters are not cleaned off the stack. This may caNTHmuse a return to an invalid location later if execution is allowed to continue. EXAMPLES call status() /* calls the status function */ call print("Test ", 300) /* calls the print function passing in a string and an @{" integer " link integer} parameter */ call (*fp)(&arr[5], j+10, 3.0) /* arbitrary expressions */ SEE ALSO @{" Display " link Display}, @{" ENV " link ENV}, @{" WHEre " link WHEre} @endnode @node CAtch "CAtch" CAOE9>tch -- Catches a task not currently under debugger control SYNOPSIS ca[tch] [@{" task-name " link task-name} | @{" address " link address} | @{" filename " link filename}] DESCRIPTION The catch command enables the debugger to gain control of tasks that were not started under the control of CPR. The @{" task-name " link task-name} and @{" address " link address} parameters can be found by issuing a tasks all command. The @{" filename " link filename} parameter can be used to speP;&Gcify the name of the executable associated with the task you want to catch. EXAMPLES catch Child /* catches the task named Child */ ca 0xC08540 /* catches the task with a task block starting address 0xC08540 */ catch myprog /* catches the task running the program myprog */ SEE ALSO @{" Activate " link Activate}, @{" DEActivate " link DEActivate}, @{" DETach " link DETach}, @{" SYMload " link SYMload}, @{" TAsks " link TAsks} @endnode @node DEAcQtivate "DEActivate" DEActivate -- Deactivate a task under debugger control SYNOPSIS dea[ctivate] [@{" task-name " link task-name} | @{" address " link address} | @{" filename " link filename} ] DESCRIPTION Normally all tasks under CPR's control are started when a go or proceed command is issued. The deactivate command can be used to deactivate a task. A task that is deactivated by this command is not started when the debugger allows the application to run unless it is the curreROnt task. The task can be reactivated with the activate command. The @{" task-name " link task-name} and @{" address " link address} parameters can be found by issuing a tasks command. The @{" filename " link filename} parameter can be used to specify the name of the executable associated with the task you want to catch. EXAMPLES dea Child /* deactivates the task named Child under CPR */ deactivate 0xC08540 /* deactivates the task with a task block S t|, starting at address 0xC08540 */ deactivate myprog /* deactivates the task running the program named myprog */ SEE ALSO @{" Activate " link Activate}, @{" CAtch " link CAtch}, @{" DETach " link DETach}, @{" TAsks " link TAsks} @endnode @node DEFine "DEFine" DEFine -- Defines a macro SYNOPSIS [#]def[ine] @{" name " link name} [@{" definition " link definition}] [#]def[ine] @{" name " link name}(@{" parm " link parm} [, @{" parm "T v=k link parm} ... ]) [@{" definition " link definition}] DESCRIPTION The define command provides a general macro substitution facility that is nearly identical to the mechanism provided in C syntax. Macros defined in the debugger are expanded anywhere within a line of text except inside quotes or filenames. The debugger also will not expand macro definitions that are prefixed with a backtick character (`). The ANSI # and ## operators are not supported. EXAMPLES define /U ֶ* displays all the macro definitions */ define foo /* defines foo as a null definition */ def foo bar /* defines foo to be bar */ define func(a,b) (a+b) /* defines func with parameters */ SEE ALSO @{" ALias " link ALias}, @{" UNALias " link UNALias}, @{" UNDefine " link UNDefine} @endnode @node DETach "DETach" DETach -- Detaches a task from debugger control SYNOPSIS det[ach] [@{" task-name " link task-name} | @{" address " link address} | @{" filename " link filV oename} ] DESCRIPTION The detach command detaches a task from debugger control. The task can be brought under CodeProbe's control with the catch command. The @{" task-name " link task-name} and @{" address " link address} parameters can be found by issuing a tasks command. The @{" filename " link filename}> parameter can be used to specify the name of the executable associated with the task you want to catch. When using the detach command make sure that no breakpoints are placed W ?inside code that is executable from a detached task. Also, do not specify the detach command to the original program if any of its child processes continue to run in the same code segment. EXAMPLES detach Child /* detaches the task named Child from debugger control */ det 0xC08540 /* detaches the task with a task block starting at address 0xC08540 */ det myprog /* detaches the task executing the program myprog */ SEE ALSOX= @{" Activate " link Activate}, @{" CAtch " link CAtch}, @{" DEActivate " link DEActivate}, @{" TAsks " link TAsks} @endnode @node Display "Display" Display -- Displays the value of an expression SYNOPSIS d[isplay] (@{" expression " link expression} ["@{" format " link format} "] | @{" string " link string}) [, ...] DESCRIPTION The display command evaluates the value of the @{" expression " link expression} parameter and displays the result. The @{" expression " link expression}Y'Y parameter can be any C expression containing constants, variables, and function calls from the program being debugged. Any number of expressions and strings can be specified, separated by commas. All expressions are displayed on the same line. The display command chooses the default format based on the type of the expression. Values of type char are displayed as characters as well as in decimal and hexadecimal format. If the character is unprintable it is displayed as an escapeZAP sequence, for example, \n or \xAC. Values of type int and long are displayed in decimal and hexadecimal format, and floats and doubles are displayed in floating point best format. To override the default format, a printf style format can be specified optionally after each expression. No error checking is done on the @{" format " link format} parameter, so strange results are possible. It may contain up to two conversion operators for short and long types but only one for all oth[{}er types. All members of structures, unions, and arrays are displayed using the default formats. Partial arrays may be displayed using two integers to indicate the first and last elements to display. For example, the following command displays array elements 3, 4, and 5: display a[3..5] An asterisk may be used instead to indicate that all elements should be displayed. The @{" string " link string} parameter can be any standard C string in double quotes as desc\ ;ribed elsewhere in this document in the Parameters Types section. To display a null-terminated string, use the dzero command. Use the dump command to dump an area of memory. EXAMPLES display i /* displays the variable i */ d a "a=%10.5e" /* displays a using a printf style format specifier */ d p->d[5] + f(3) /* displays the value of an expression containing a function call */ display "X is", x, "J is", j ]q /* displays the value of several arguments including strings */ d x "X is %d", j "J is %d" /* displays the value of several arguments using printf style format specifiers */ d a[3] /* displays the value of an element of an array */ display a[3..5] /* displays the value of elements 3 through 5 in an array named a */ d a[*] /* displays the value of every element of an array */ SEE ALSO @{" Call " link ^5~Call}, @{" DUmp " link DUmp}, @{" DZero " link DZero} @endnode @node DUmp "DUmp" DUmp -- Dumps memory contents SYNOPSIS du[mp] [@{" variable " link variable} | @{" address " link address} | @{" range " link range}] [$] [@{" format " link format} [@{" itemsize " link itemsize}] | text] DESCRIPTION The dump command is used to examine an area of memory. You select the format of the dump, the length of each item being dumped, and whether or not you want text to appear on th_-^e right side of the dump. A dump command with no parameters continues where the previous dump command ended using the same dump specifications. The @{" variable " link variable}, @{" address " link address}, or @{" range " link range} parameter specifies the location to be dumped. The $ parameter can be used to specify the last dump address when the @{" format " link format} or text parameters are used. The $ is ignored if a @{" variable " link variable}, @{" address " link addre`3wss}, or @{" range " link range} parameter has already been specified making it useful for aliases where the dump address may be omitted. The @{" format " link format} parameter controls the format of the dump and its value can be any of the following: a[scii] FFP[float] IEEE[float] b[inary] f[loat] o[ctal] d[ecimal] h[ex] u[nsigned] The default format is hex. If you specify a @{" format " link format} parametea5r, you also can specify an @{" itemsize " link itemsize} parameter to control the length of each item dumped. The @{" itemsize " link itemsize} parameter can have a value of 1, 2, 4, or 8. The @{" itemsize " link itemsize} parameter is concatenated onto the end of the @{" format " link format} parameter (for example, b4 for a binary format of length 4). If you do not specify @{" itemsize " link itemsize}, CodeProbe uses a default. As shown in the following table, the allowable sibJze and default values depend on the format specified. The text parameter is used to specify that an ASCII representation of the memory dump should be displayed. The @{" itemsize " link itemsize} parameter has the following default values and allowable sizes: Format Default Allowed Sizes ------ ------- ------------- ascii 1 1 binary 1 1, 2, 4 decimal 4 1, 2, 4 FFPfloat 4 c=i 4 float 8 4, 8 hex 4 1, 2, 4 IEEEfloat 8 4, 8 octal 4 1, 2, 4 unsigned 4 1, 2, 4 Compatibility Aliases --------------------- To provide backward compatibility with previous releases of CodeProbe, the following aliases for the dump command are supported: da dumps a range of memory as ASCII characters db dumps a range of memory in both hexadecimal and ASCII format dd|c dumps a range of memory in decimal format dd dumps a range of memory as 8-byte floating-point numbers in IEEE format df dumps a range of memory as 4-byte floating-point numbers in IEEE format dffp dumps a range of memory as 4-byte floating-point numbers in FFP format di or dl dumps a range of memory in integer format using decimal representations of the integers dw dumps a range of memory in short integer (16-bit) format using hexadecimal representations of the intege[Iers dp dumps a range of memory in 4-byte hexadecimal format ds dumps a range of memory in short integer (16-bit) format, using decimal representations of the integers. EXAMPLES dump var /* dumps memory contents of variable var */ dump var L 13 hex1 /* dumps memory contents for 13 bytes using 1-byte hexadecimal format */ dump var1 .. var2 ascii /* dumps memory contents between var1..var2 in ASCII forfBDbmat */ dump 0xAF8100 L 8 /* dumps memory contents for 8 longs (32 bytes) starting at absolute address 0xAF8100 */ SEE ALSO @{" Display " link Display}, @{" DZero " link DZero} @endnode @node DZero "DZero" DZero -- Display memory as a null-terminated ASCII string SYNOPSIS dz[ero] @{" variable " link variable} | @{" address " link address} | @{" array-slice " link array-slice} DESCRIPTION The dzero command displays theg@ contents of memory as a null terminated (\0) string. If the location is the name of a nonpointer variable in the program being debugged, dzero displays the memory contents starting at the address of the variable and continuing until the null character is found. If the location is the name of a pointer variable, dzero uses the contents of the pointer and displays bytes starting at that address until a null character is encountered. If the @{" address " link address} parameter is uhTTsed to specify an absolute address, dzero displays the contents of that address until a null character is encountered. If the location is an array slice, the address of each element in the array slice will be displayed until the null character is found. EXAMPLES dzero string /* displays characters until the null character is reached */ dzero ptr /* displays data pointed to by ptr as a string */ dzero ptr[3 .. 7] /* displays each elei'UNment in the array slice ptr[3..7] until the null character is reached */ SEE ALSO @{" Display " link Display}, @{" DUmp " link DUmp} @endnode @node ECho "ECho" ECho -- Displays a string SYNOPSIS ec[ho] [@{" text " link text}] DESCRIPTION The echo command writes the value specified for the @{" text " link text} parameter in the Dialog window. This is useful for documenting the actions being taken in a debugger command file, the cj >prinit file, or AREXX macros. If the @{" text " link text} parameter contains semicolons, they must be escaped with a backslash (\;). Defines or aliases are not expanded. EXAMPLES echo Starting program\; loading defines. /* displays the message following the echo command in the Display window */ SEE ALSO @{" Display " link Display}, @{" EXecute " link EXecute} @endnode @node ENV "ENV" ENV -- Sets the environment SYNOPSIS env [@{" function " link function} k!e| @{" integer " link integer}] env [-c[aller] | -s[ubroutine] | -u[p] | -d[own] | -@{" integer " link integer} | +@{" integer " link integer}] DESCRIPTION The env command changes the environment for subsequent debugger commands. Environmentis the state of the machine at a particular point in the calling sequence (that is, the contents of the stack and the contents of variables). Setting the environment to a previous point in the calling sequence, such as the point where thl"儺e current function was called, returns the machine to the state it was in at that time. However, only the information that can be retrieved from the stack will have been restored. Scratch registers and other components, such as the values of externs, that are not dependent on the stack remain relative to the current execution point in the application and will not be changed. Nonscratch registers are restored to the correct values for the new environment. The environment can be setm#X to an absolute or relative position in the call chain. To set it to an absolute position, specify the function name using the @{" function " link function} parameter, or a level number using the @{" integer " link integer} parameter. The where command or Calls window can be used to display the level number. The other forms to the env command set the environment relative to the current function. To move the environment up one level to the caller of the current function, use the -n$d7gcaller, -up, or -1 flags. To move in the opposite direction, use the -subroutine, -down, or +1 flags. Use the +@{" integer " link integer} or -@{" integer " link integer} forms to move more than one level at a time. Level 1 is defined to be the function in which you are currently stopped. The caller's level is 2, its caller is level 3, and so on. These level number designations change as the program steps into and returns from functions. If you attempt to move the environment upo% or down more levels than there are in the call frame, a warning is displayed and the environment is moved as far as possible. After using the env command, commands that refer to line numbers and variables act as if the function specified by the @{" function " link function} parameter is the current function. Any command that causes the program being debugged to resume execution, such as the go or trace commands, automatically resets the user environment to the last point of executp&2D`jion. Issuing the env command is the same as double-clicking on a function call entry in the Calls window. EXAMPLES env /* sets the user environment to the last point of execution */ env main; d i /* sets the user environment to main and display i */ env -subroutine /* sets the environment to the called function (down 1 level) */ env -caller /* sets the environment to the caller function (up 1 level) */ env +5 /* moq'nves the environment down 5 levels */ env 7 /* moves the environment to the level 7 */ SEE ALSO @{" WHEre " link WHEre} @endnode @node EXecute "EXecute" EXecute -- Executes a debugger command file SYNOPSIS ex[ecute] @{" filename " link filename} DESCRIPTION The execute command reads and executes CodeProbe commands from the file specified by the @{" filename " link filename} parameter. If the file cannot be found, CodeProbe appends a .cpr extension to it and tries again. Thusr(4], you can place a set of debugger commands in a file with a .cpr extension and simply use the root filename, minus the extension, in the execute command. CodeProbe searches for the specified file in your normal Shell path as defined with the AmigaDOS PATH command. If the file cmds.cpr consists of the commands break sort blist trace trace then the execute command applied to this file would yield the following s)display: > execute cmds.cpr executing commands from cmds.cpr 1 0xC32D3E sort:\sort.c\sort 22 sort:\sort.c\init 5 sort:\sort.c\init 9 The debugger commands themselves are not echoed as part of the display unless echo mode is turned on. If you are debugging a program frequently and want to set a number of breakpoints at the same places, you can place all of your breakpoint commands in a file and then use the execute command on this file. This way you can avoid re-ent*޹tering the same commands each time you want to use the debugger. If the execute command is used in a command list, it must be the last command in the list. EXAMPLES execute setvars /* executes the file named setvars or setvars.cpr */ execute test/cmds.cpr /* executes the file named cmds.cpr located in the test directory */ @endnode @node EXPAND "EXPAND" EXPAND -- Expands and displays a command line SYNOPSIS expand [alias] @{" command-lineu+ " link command-line} DESCRIPTION The expand command displays its arguments with all aliases or defines expanded. The @{" command-line " link command-line} parameter specifies any valid command-line entry that includes aliases or defines. This command can be useful in trying to create more complex aliases and defines. If the alias keyword is not specified, aliases are not expanded, but defines will be expanded. EXAMPLES expand alias dp /* expands the alias for named dp tv,o display the following: dump $ hex4 */ expand ISEQUAL(1,5) /* expands the macro ISEQUAL using the arguments 1 and 5. For example, if ISEQUAL has been defined as (a == b), then it would be expanded to (1 ==5) */ SEE ALSO @{" ALias " link ALias}, @{" DEFine " link DEFine} @endnode @node FINish "FINish" FINish -- Terminates CPRK and CPRX SYNOPSIS fin[ish] DESCRIPTION The finish command is used in cross-developmenw-t?t mode to terminate the session. The cross debugger (CPRX) on the host machine instructs the kernel (CPRK) on the target machine to terminate after cleaning up and closing the communications link. The finish command must be entered on the host machine. The host machine is the one that is being used to display the CodeProbe user interface. The finish command does not work from the native version of CodeProbe. EXAMPLE finish /* causes CPRK to terminate after disconnecting frox.&m CPRX */ SEE ALSO @{" Quit " link Quit} @endnode @node FRegister "FRegister" FRegister -- Displayes or modifies floating-point registers SYNOPSIS fr[egister] [@{" register " link register} [[=] @{" expression " link expression}]] DESCRIPTION On machines that have a math coprocessor chip installed, the fregister command displays or modifies the contents of the floating-point registers. If no parameters are specified, the fregister command displays the current contents of all thy/!%ne machine's floating-point registers in hexadecimal and as floating-point numbers. If only a register name is supplied, the contents of the register are displayed; otherwise, the value of the @{" expression " link expression} parameter is stored in the register specified. The display and set commands also can be used to display and modify the registers. EXAMPLES fr /* displays all floating-point registers and flags */ fregister fp0 30.14 /* sets floating-point register fz0Xp0 to 30.14 */ fr fp2 = sales /* sets floating-point register fp2 equal to the value of sales */ fregister fp1 /* displays the value of floating point register fp1 */ SEE ALSO @{" Display " link Display}, @{" Register " link Register}, @{" RFlag " link RFlag}, @{" SEt " link SEt} @endnode @node Go "Go" Go -- Continues execution until a breakpoint is encountered or the program exits SYNOPSIS g[o] [@{" location " li{1Bзnk location} [after(@{" integer " link integer})] [when(@{" expression " link expression})]] DESCRIPTION The go command begins execution of the program at the current location, which is identified by the address stored in the program counter (pc) register. Execution continues until a breakpoint is reached or until the program terminates, either normally or with an error. The @{" location " link location} parameter specifies an optional location for a temporary breakpoint. The bre|2akpoint specified in the go command exists only for the duration of the go command. The next time program execution stops, the breakpoint is cleared, even if the temporary breakpoint was not reached. The after option specifies the minimum number of times the specified location must be reached before the temporary breakpoint is triggered. This is also known as specifying a pass count. For go commands that do not contain an after clause, the pass count is set to 1. Each time the te}3amporary breakpoint is hit, the pass count is tested. If the pass count equals 1, the temporary breakpoint is triggered and execution stops. If the pass count is greater than 1, the pass count is decremented by 1 and execution continues. If the when option is present, the breakpoint is triggered only if the specified @{" expression " link expression} evaluates to true (nonzero). The after and when options can be specified in any order. If both are used, the pass count is only tes~4OEted and decremented when the condition is true. Note: To avoid confusion, the go command does not use the default radix setting. You must specify 0x for an address; otherwise, you will be specifying a line number. For example, even if the radix is set to hex, the following command specifies a go command for line 20 and not address 0x20: g 20 EXAMPLES go /* continues program execution to the next breakpoint or the end of the program */ go 55<14 /* continues program execution to line 14 of the current @{" module " link module}. Note that line numbers are relative to a @{" module " link module } and not a function. This example assumes that code was generated at line 14. You cannot use the go command to go to a line with no code generated. */ go sort /* continues program execution to the first line of the sort function */ go \myfile.c\sort 14 /* c6-6ontinues program execution to line 14 of the sort function in @{" module " link module } myfile.c. This example also assumes that code was generated at line 14 */ go mylib.library:myfunc /* continues program execution to the myfunc function in the shared library mylib.library */ go $ after(5) /* continues program execution until the fifth time the current line is executed */ go 0x804A /* continues program execution un7til absolute address 0x804A is reached */ SEE ALSO @{" Break " link Break}, @{" Proceed " link Proceed}, @{" PS " link PS}, @{" Trace " link Trace}, @{" TS " link TS} @endnode @node "Help Command" "HELP" Help -- Displays help information SYNOPSIS h[elp] [@{" command " link command}] ? [@{" command " link command}] DESCRIPTION The help command displays information about commands and operands. If the @{" command " link command} parameter is omitted, the Help window op8%Gens and a list of commands and topics is displayed. Entering one of the items on this list as the value for the @{" command " link command} parameter displays information about that item. An alternate method of selecting an item is to double-click on the command or topic in the Help window. This method of selection can also be used from the help screens themselves. For example, at the bottom of the screen for the dump command there is a section that directs you to the display and91 dzero commands for additional information. You can access the help screen for either of these commands by double-clicking on the name of the command. EXAMPLES help /* displays a list of commands and topics */ h break /* displays information about the break command */ ? break /* displays information about the break command */ @endnode @node HUnks "HUnks" HUnks -- Lists the addresses and sizes of all hunks SYNOPSIS hu[nks] DESCRIPTION The hunks command displays:[!7 the list of loaded hunks, their addresses, and their sizes for the current executable file. The following example shows the output from the hunks command: >hunks Hunk Address Size 0 00C32AE8 0xB54 (2900) 1 00C28570 0x27C (636) The size is displayed first in hexadecimal format followed by decimal format in parentheses. EXAMPLE hunks /* lists all hunks for the current executable file */ @endnode @node Jump "Jump" Jump -- Changes the current execut;~/)ion point SYNOPSIS j[ump] @{" location " link location} DESCRIPTION The jump command updates the program counter to point to a new location. The effect of using this command is that the code between the previous execution point and the new location is not executed. Any value for the @{" location " link location} parameter that is valid for the break or go commands can be used. It is important to note that the stack is not modified in any way. You should be very careful when us<-I4ing the jump command because certain registers may not be set up the way the code that is jumped to expects. Using the jump command is more likely to be safe if you always jump from one C source file line to another in the same function (not from assembly lines), and you have compiled with the debug=symbolflush or debug=fullflush options to make sure that registers are flushed to memory at C source line boundaries. If the jump command is used on optimized code, the registers are not= likely to be set correctly. Note: To avoid confusion, the jump command does not use the default radix setting. You must specify 0x for an address; otherwise, you will be specifying a line number. For example, even if the radix is set to hex, the following command specifies a jump command for line 20 and not address 0x20: j 20 EXAMPLES jump 12 /* jumps to line 12 in the current function */ jump 0x804E /* jumps to the address 0x804E */ SEE AL>SO @{" ENV " link ENV}, @{" Go " link Go}, @{" RETurn " link RETurn} @endnode @node List "List" List -- Lists the lines in a source file SYNOPSIS l[ist] l[ist] $ l[ist] + | - @{" integer " link integer} [L length] l[ist] l[ist] [@{" image " link IMAGE}:] \@{" module " link MODULE} [] l[ist] [[@{" image " link IMAGE}:]\@{" module " link MODULE}\@{" function " link function} [] DESCRIPTION The list command is used when debugging in li?ne mode to list the lines in a source file. The current list line is set to the source line at which the program being debugged is stopped each time the user regains control. The list command with no arguments displays lines starting with the current list line. The number of lines displayed is controlled by the opt list command. The $ parameter is used to list a number of lines above and below the current line at which the program is stopped. The number of lines above and below @is controlled by the opt context command. The @{" module " link MODULE} parameter specifies the name of a module in the program. A range of lines is specified with the parameter, which can have either of the following forms: line-1 [[..] line-2 line-1 L length In the first form the parameter specifies a range of lines starting at line-1 and ending at line-2. In the second form a range of lines is specified as starting at lA֫ine-1 and extending for length number of lines. and are both @{" integer " link integer} values If the list command is given an environment (@{" module " link module} or function), then the source file for that environment is opened, if possible, and the desired line range is displayed. If no line range is given, and no function is given, the listing begins at line 1. If a function name is given and no line range is given, lines are listed beginning with thBbae function declaration. Each time the list command is used, the current list line is set to the line immediately following the last listed line. Remember that the current list line is also updated each time the client program is allowed to execute. EXAMPLES list /* lists the next group of lines. The number of lines listed is set by the opt list command. */ list $ /* lists lines around the line pointed to by the current program counter */ C`^list @{" module " link module} /* lists first lines of the specified @{" module " link module} */ list \@{" module " link module} 20 40 /* lists lines 20 through 40 of the specified @{" module " link module} */ list \@{" module " link module} 20 l 10 /* lists 10 lines of the specified @{" module " link module} starting at line 20 */ list +20 /* starts listing lines 20 lines down from the current liD2,ne */ list -20 /* starts listing lines 20 lines up from the current line */ list -20 L 10 /* lists 10 lines, staring 20 lines up from the current line */ list foo /* starts listing at the declaration of the function named foo */ list foo 10 20 /* lists lines 10 through 20 of the function named foo */ SEE ALSO @{" OPt " link OPt}, @{" SOurce " link SOurce}, @{" Unassemble " linkET Unassemble} @endnode @node LOg "LOg" LOg -- Logs debugger commands to a file SYNOPSIS lo[g] [] DESCRIPTION The log command is used to save to a file a record of all activity in the Dialog window including commands and results. Menu selections are not saved by the log command. This information is stored in a log file. The name of the file is set with the log file command. The default filename is cpr.log. When issued without the parameter, the log coG%qmmand can be used to display the current log state, either on or off, and the filename of the log file. The parameter can be any of the following: append appends log information to the end of the log file file @{" filename " link filename} specifies the filename of the log file off closes the log file on opens a new log file snap snapshots contents of the Dialog window to the log file. If a command that enables the logging of your session, such as log oFHK.~}|{zyxwvutsrqponmlkjihgfedcba`_^]\[ZYXWVUTSRQPONMLKJIHGH}n, log append, or log snap, is issued when logging is already enabled, the results of the command are added to the current log file. If the log filename is changed while logging is enabled, the current log file is closed, and a new one is opened. The log file is automatically closed when you exit CodeProbe. EXAMPLES log snap /* saves the dialog for the current session into the log file named cpr.log */ log file foo.log /* sets the log file to the fileI[2name foo.log */ log on /* enables the log file */ log off /* disables the log file */ log append /* enables the log file and append new log information to the end of the log file */ @endnode @node OPt "OPt" OPt -- Show option values or change the value of a debugger option SYNOPSIS op[t] op[t] au[toswap] [on | off] op[t] ar[rdim] @{" integer " link integer} op[t] b[adchar] @{" integer " link integer} op[t] ca[se] [on | off] op[t] cat[Ja|Wch] [on | off] op[t] co[ntext] @{" integer " link integer} op[t] dev[ices] [on | off] op[t] e[cho] [on | off] op[t] ib[ytes] [on | off] op[t] ig[norepath] [on | off] op[t] l[ist] @{" integer " link integer} op[t] rad[ix] [d[ecimal] | h[ex]] op[t] ran[gelen] @{" integer " link integer} op[t] re[slib] [on | off] op[t] se[arch] [+ | -] @{" directory " link directory} [, @{" directory " link directory} [...]] op[t] so[urce] c | a[sm] | m[ixed] | n[ext] op[t] st[rlKœen] @{" integer " link integer} op[t] t[ask] [@{" task-name " link task-name} | @{" task-address " link task-address}] op[t] u[nassemble] @{" integer " link integer} DESCRIPTION The opt command is used to show the value of debugger options or to change them. The opt command by itself shows the current settings of all options. The following are the options and their possible values: autoswap if set to on, pushes the screen containing the applications output to the front eachL{[j time control is given to the application. If set to off, the application screen is not pushed to the front. The default is off. arrdim controls the maximum number of array elements that are displayed at one time with the display command. The default is 20. badchar controls the number of non-ASCII characters that a dzero or display command will accept when displaying a string referenced by a character pointer. The default is 3. case if set to on, causes the search commanM+fd to perform case-sensitive string searches. The default is off. catch if set to on, catches any new task generated by a task under debugger control. The default is off. context controls the number of lines displayed in the Source window preceding the current line. The default is 2. devices if set to on, attaches to, or catches, any new device process or task generated by a task under debugger control. The default is off. echo if set to on, causes the debugger to echoN9 all commands to the Dialog window. This is particularly useful when using the execute command to execute a file of debugger commands. The default is off. ibytes if set to on, causes the debugger to display the instruction bytes being disassembled. This affects the output of the unassemble command. In windowing mode, it also affects the Source window in mixed and asm source modes. The default is off. ignorepath if set to on, the ignorepath option causes the debugger to ignOFore the pathname for the source file provided by the compiler. The default is off. list controls the default number of lines displayed by the list command in line mode. The default is 6. search defines a set of directories to search for the source code. If no + or - is specified, the list of directories replaces the current list. Specifying a + at the beginning of the list appends the new list to the end of the current list. Specifying a - at the beginning of the list removPK~es the specified directories from the current list. source controls the display in the Source window in windowing mode. Repeatedly choosing the next values cycles through the possible display types in the order C, asm, and mixed. The source option controls the output when you execute a step or go. The default is C. strlen controls the maximum number of bytes that are displayed when a character string is displayed with the dzero command. The default is 128. task changes tQ!he current task to the task identified by the @{" task-name " link task-name} or the @{" task-address " link task-address} parameter. radix sets the default input type for constants. It is used to avoid having to type the initial 0x on hexadecimal constants. The default is decimal. rangelen controls the default size of ranges when no range size information is available. The default is 64. reslib if set to on, steps into resident libraries while tracing or running an appliRpcation with watch breaks. The default is off. unassemble controls the default number of instructions that are disassembled by the unassemble command in line mode. It has no effect in C mode or windowing mode. The default is 4. EXAMPLES opt /* displays the settings of all options */ opt unassemble 10 /* sets unassemble count to 10 */ opt search /src,/test /* sets search directories */ opt search +test2 /* appends a new search diSrrectory */ SEE ALSO @{" Display " link Display}, @{" DZero " link DZero}, @{" List " link List}, @{" Unassemble " link Unassemble} @endnode @node Proceed "Proceed" Proceed -- Single-steps over function calls SYNOPSIS p[roceed] [@{" integer " link integer}] DESCRIPTION In C mode, the proceed command causes the debugger to step through the number of source statements specified by the @{" integer " link integer} parameter. In Mixed or Asm modes, it steps through @{" integer " linkT integer} number of machine instructions. If a function call is encountered, the function is executed as if it were a single statement. If the @{" integer " link integer} parameter is omitted, it defaults to 1. A proceed command is performed when you press the Return key without entering any commands in the Dialog window. The F6 key can also be used to enter the proceed command. EXAMPLES proceed /* steps 1 source statement in C mode or 1 machine instructU uion if in Mixed or Asm modes */ proceed 5 /* steps 5 source statements in C mode or 5 machine instructions if in Mixed or Asm modes */ SEE ALSO @{" Go " link Go}, @{" PS " link PS}, @{" Trace " link Trace}, @{" TS " link TS} @endnode @node PS "PS" PS -- Single-steps over function calls by source line SYNOPSIS ps [@{" integer " link integer}] DESCRIPTION The ps command causes the debugger to single-step through the number of C source statements specified byVE the @{" integer " link integer} parameter even if mode is set to Mixed or Asm. If a function call is encountered during stepping, the function is executed as if it were a single statement. If the @{" integer " link integer} parameter is omitted, it defaults to 1. EXAMPLE ps 2 /* steps through two source lines regardless of the debugger mode */ SEE ALSO @{" Go " link Go}, @{" Proceed " link Proceed}, @{" Trace " link Trace}, @{" TS " link TS} @endnode @node Quit "W*Quit" Quit -- Terminates the debugger SYNOPSIS q[uit] DESCRIPTION The quit command terminates the debugging session and returns to the operating system prompt. When running in cross-development mode, the quit command only terminates the cross debugger (CPRX) on the host machine, leaving the kernel (CPRK) waiting for a new debug session. Normally, CodeProbe forces the application being debugged to call the exit function before terminating the application. The debugger then exitX"s. If CodeProbe was started with the -startup option, the debugger exits without forcing the application to call exit. EXAMPLE quit /* terminates the debugging session */ @endnode @node Register "Register" Register -- Displays or modifies registers SYNOPSIS r[egister] [@{" register " link register} [[=] @{" expression " link expression}]] DESCRIPTION If no arguments are given, the register command displays the current contents of all the machine integer registers. If a regY ister name is specified by the @{" register " link register} parameter, the contents of that register are displayed. If an @{" expression " link expression} parameter is specified in addition to the @{" register " link register} parameter, the value of the expression is stored in the register. The display and set commands can also be used to display and modify the contents of the registers. EXAMPLES register /* displays all registers and flags */ register d5 = 30 /* Z Vwset register D5 to 30 */ r d3 = index /* sets register D3 to the value of index */ register a0 &x /* sets register A0 to the value pointed to by x */ r a1 /* displays the value stored in register A1 */ SEE ALSO @{" Display " link Display}, @{" FRegister " link FRegister}, @{" RFlag " link RFlag}, @{" SEt " link SEt} @endnode @node REStart "REStart" REStart -- Restarts the program being debugged SYNOPSIS res[tart] [@{" argument-list " link argument-list}[] DESCRIPTION The restart command causes the program you are debugging to be reloaded and executed up to the entry point of main, just as when the debugger was first invoked. (If the -startup option was specified when you invoked the debugger, execution will stop before the startup code is executed and not at the first line of the main function.) Because the program is reloaded, all static data is reinitialized. All breakpoints will be retained and watch breaks on static and exter\bnal variables will be retained and disabled. The @{" argument-list " link argument-list} parameter provides the arguments for the program being debugged. These arguments are delimited by white space, just as would appear on the command line when invoking the program. The program will use these arguments as if it were invoked from the command line with them. The restart command cannot be used with the -command CPR command-line option or as one of a sequence of commands separated b]9y semicolons. When used, the restart command must occur at the end of a command line. The restart command potentially can cause your machine to crash if used improperly. When you enter the restart command, your application is immediately reloaded and re-executed with no cleanup of your currently running program other than calling the exit function to close files. This can leave the machine in an unacceptable state that can cause problems later. To avoid this problem, be sure to al^r|klow your application to run to completion if possible and do any necessary cleanup before issuing the restart command. The start and restart commands are the same if the same arguments are provided by the @{" argument-list " link argument-list} parameter. The significant difference between the two commands is their behavior when they are specified with no arguments. The start command restarts the program without any arguments; however, the restart command with no arguments restart_KQls the program with the original arguments used when the debugger was invoked. EXAMPLES restart /* restarts the program using the same arguments with which it was initially invoked with */ restart myfile.txt 5 /* restarts the program passing it two arguments: myfile.txt and 5 */ restart "sample string " /* restarts the program passing in a string as an argument */ SEE ALSO @{" STArt " l`;ink STArt} @endnode @node RETurn "RETurn" RETurn -- Returns immediately from the current function SYNOPSIS ret[urn] [@{" expression " link expression}] DESCRIPTION The return command causes the current function to return to its caller without executing the rest of the function. The value of the @{" expression " link expression} parameter is used as the return value from the function. The value is converted to the appropriate type if necessary; however, it must be a scalar quantaq'ity (not a structure or union). An attempt to return a value from a function declared void is treated as an error, and a suitable message is displayed. Similarly, an error message is displayed if you use a simple return command (without a parameter) from within a function declared as having a return value. In all other cases, the return value is cast (if necessary) to the correct type and returned to the calling function. When a return command is given, the current function is rebOturned immediately to the calling function. The return value, if any, is returned to the calling function, and execution is suspended as though a breakpoint were triggered in the calling function after the call was made. For instance, note the following code fragment: i = 5; j = func(i); if (j < 2) j++; Assume that the return command is issued during the execution of func in the form ret 7. Execution stocBnps inside the line that did the call, just before the assignment to j. You can then single-step to the next statement. EXAMPLES return stringptr /* returns the value of stringptr */ ret 5 /* returns an integer value of 5 */ return /* returns from a void function */ @endnode @node RFlag "RFlag" RFlag -- Displays or modifies flags SYNOPSIS rf[lag] [ ...] DESCRIPTION The rflag command can be used to display or modify the settings of thedX machine flags. If no parameters are specified, the current settings of the flags are displayed. With one or more arguments, the indicated flags are set or cleared according to the values given. The flag names are specific to the target machine. A flag setting can be one of the terms in the following table. The Set column comprises the terms used to set flags, while the Clear column comprises the terms used to clear flags. Flag Name Set Cleare= ----------------------- --------- --------- Overflow (yes/no) OV NV Sign (negative/positive) NG PL Zero (yes/no) ZR NZ Auxiliary Carry (yes/no) AC NA Carry (yes/no) CY NC EXAMPLES rflag /* displays all registers and flags */ rflag cy /* sets the carry flag to 1 */ SEE ALSO @{" FRegister " link FRegister}, @{" Registf9(er " link Register} @endnode @node SEArch "SEArch" SEArch -- Searches for a string in the current source file SYNOPSIS sea[rch] [@{" string " link string}] DESCRIPTION The search command searches the current source file for the specified string. In windowing mode, the search begins from the top line of the current Source window. In line mode, the search begins at the first line that would be displayed if a list command is entered with no arguments. In windowing mode, the cursogMr is positioned at the beginning of the matching string. The Source window is also repositioned so that the line containing the match is the number of lines specified by the context option from the top of the window. The context were set by the opt command. In line mode, the line containing the match is displayed. The search command with no arguments causes the debugger to search for the string specified in the last search argument, starting from the new current line. If no matchhes are found, a message is printed. If the user then enters search again, the search is resumed beginning at the top of the file. The case-sensitivity option, opt case, determines whether the search is case sensitive or not. EXAMPLES search foo /* finds the string "foo " */ search foo; /* finds the string "foo". The semicolon used in this command is a command delimiter and is not considered part of the search string */ ihsearch foo\; /* finds the string "foo;". The escape character (\) causes the semicolon to be part of the search string */ search /* repeats the last search */ SEE ALSO @{" OPt " link OPt}, @{" List " link List} @endnode @node SEt "SEt" SEt -- Modifies the values of variables or memory locations SYNOPSIS se[t] (@{" variable " link variable} | @{" register " link register}) = @{" expression " link expression} se[t] @{" aj}6ddress " link address} [=] @{" string " link string} DESCRIPTION The set command is used to modify the values of variables, registers, or memory locations in the program being debugged. You are most likely to use the first form of the set command in debugging C programs. It allows you to change the value of a variable in your program by referring to that variable by name. In this context, variable has a rather broad sense that includes references to array elements, structure membkSNers, and indirect references. The @{" variable " link variable} parameter cannot refer to an aggregate such as a structure, union, or array. The @{" register " link register} parameter can be any valid register name, D0 through D7 and A0 through A7, and if a co-processor is present, FP0 through FP7. A $ prefix optionally may be used to distinguish the register from a variable of the same name. The @{" expression " link expression} parameter is the same as used in the C assignmentl statement. If necessary, the value for @{" variable " link variable} will be converted to the proper type in accordance with the normal C conversion rules; it is then entered into memory at the address of the first variable operand. This is similar to a C assignment statement for a scalar variable. The second form shown in the synopsis is used to store a string into memory. The null terminator is not copied unless it is explicitly present in the string. The equal sign is optionm5al. Support for this form of set command may be removed in future releases. The built-in strcpy and memcpy functions are preferred. EXAMPLES set i = 5 /* sets the variable i equal to the integer value 5 */ set a = 3.1415 /* sets the variable a equal to the floating-point value 3.1415 */ set $d0 = 300 /* sets register D0 equal to 300. The $ is optional */ set time->date = newtime /* sets the date member of the timen*F structure equal to the value of the variable newtime */ set stringptr "this string has no null byte " /* stores a string that is not null-terminated to the memory location pointed to by stringptr */ set stringptr "this string has a null byte\0" /* stores a null-terminated string to the memory location pointed to by stringptr */ set stringptr "string one\0string two\0" o| /* stores two null-terminated strings to the memory location pointed to by stringptr */ SEE ALSO @{" FRegister " link FRegister}, @{" MEMCPY " link MEMCPY}, @{" STRCPY " link STRCPY}, @{" Register " link Register} @endnode @node SLEep "SLEep" SLEep -- Pauses for the time specified SYNOPSIS sle[ep] @{" number " link number} DESCRIPTION The sleep command pauses for the number of seconds specified by the @{" number " link number} parameter. EXAMPLE sleep 10 /* p˪pauses for 10 seconds */ @endnode @node SOurce "SOurce" SOurce -- Displays source file SYNOPSIS so[urce] [@{" filename " link filename}] DESCRIPTION The source command overrides the C source file associated with the current @{" module " link module}. The specified value for @{" filename " link filename} replaces the filename associated with the @{" module " link module} for the rest of the current debugging session. The new file is displayed in the Source window immediately, anqEd its name is echoed in the Dialog window. If no @{" filename " link filename} parameter is specified, the name of the current source file is echoed in the Dialog window but the current source file is not changed. If the filename you want to change to is the same as the default filename but the path is different, you can use the opt search command to change the locations that CodeProbe looks for source files. EXAMPLES source /* displays the current filename */ r source test/test1.c /* changes the filename for the current @{" module " link module} to test1.c in the test directory */ SEE ALSO @{" OPt " link OPt} @endnode @node STArt "STArt" STArt -- Restarts the program being debugged SYNOPSIS sta[rt] [@{" argument-list " link argument-list}] DESCRIPTION The start command causes the program you are debugging to be reloaded and executed up to the entry point of main, just as when the debugger was first invsFpIoked. (If the -startup option was specified when you invoked the debugger, execution will stop before the startup code is executed and not at the first line of the main function.) Because the program is reloaded, all static data are reinitialized. All breakpoints are retained and watch breaks on static and external variables are retained and disabled. The @{" argument-list " link argument-list} parameter provides the arguments for the program being debugged. These arguments are dtDelimited by white space, just as would appear on the command line when invoking the program. The program will use these arguments as if it were invoked from the command line with them. The start command cannot be used with the -command CPR command-line option or as one of a sequence of commands separated by semicolons. When used, the start command must occur at the end of a command line. The start command potentially can cause your machine to crash if used improperly. When you enuxxxter the start command, your application is immediately reloaded and re-executed, with no cleanup of your currently running program other than calling the exit function to close files. This can leave the machine in an unacceptable state that can cause problems later. To avoid this problem, be sure to allow your application to run to completion and do any necessary cleanup before issuing the start command. The start and restart commands are the same if the same arguments are providedv by the @{" argument-list " link argument-list} parameter. The significant difference between the two commands is their behavior when they are specified with no arguments. The start command restarts the program without any arguments; however, the restart command with no arguments restarts the program with the original arguments used when the debugger was invoked. EXAMPLES start /* restarts the program without passing it any arguments */ start myfile.txt 5 /* restarts thew+2 program passing in an the argument list */ SEE ALSO @{" REStart " link REStart} @endnode @node SYMBol "SYMBol" SYMBol -- Finds the symbol nearest to the specified address SYNOPSIS symb[ol] @{" address " link address} DESCRIPTION The symbol command causes the debugger to search the symbol information and display the name of the symbol whose location is closest to the address specified by the @{" address " link address} parameter. EXAMPLE symbol 0x80xG40 /* displays the symbol whose address is nearest to 0x8040 */ SEE ALSO @{" SYMload " link SYMload} @endnode @node SYMload "SYMload" SYMload -- Reads symbol information from an executable file SYNOPSIS sym[load] @{" filename " link filename} sym[load] proc @{" task-name " link task-name} | @{" task-address " link task-address} sym[load] seg @{" address " link address} @{" filename " link filename} DESCRIPTION The symload command associates an executabyPle file and any debugging information found in that file with a loaded @{" image " link IMAGE}. If given the @{" filename " link filename } an executable file, the symload command associates that file with the current hunk list. The file specified must be an executable file. If the proc keyword is used, followed by the name of a task that is identified by the @{" task-name " link task-name} parameter, or the address of the task identified by the @{" task-address " link task-addrz/(ess} parameter, the symload command attempts to map the segment list for the task with its executable file. If the seg keyword is specified along with an address and the filename of an executable file, the symload command treats the address as a pointer to a BCPL segment list and it maps the list to the executable file. EXAMPLES symload myapp /* reads the current segment list and symbols from the file named myapp */ sym proc myapp /* reads the segm{%ent list and executable file for process myapp */ symload proc 0xC85428 myapp /* reads the segment list and executable file for the process located at 0xc85428 */ symload seg 0xC84200 myapp /* uses the segment list at address 0xC84200 */ SEE ALSO @{" HUnks " link HUnks} @endnode @node TAsks "TAsks" TAsks -- Displays system tasks SYNOPSIS ta[sks] [a[ll]] DESCRIPTION The tasks command displays information about tasks. By de|>/fault, it displays the tasks currently under debugger control. If the all option is specified, all system tasks are displayed. The opt task command can be used to change to a new task. EXAMPLES tasks /* displays a listing of all tasks under debugger control */ ta all /* displays a listing of all tasks in the system */ SEE ALSO @{" Activate " link Activate}, @{" CAtch " link CAtch}, @{" DEActivate " link DEActivate}, @{" DETach " link DETach}, @{" OPt " link OPt} @endnode}  @node Trace "Trace" Trace -- Single-steps into function calls SYNOPSIS t[race] [@{" integer " link integer}] DESCRIPTION In C mode, the trace command steps the number of source statements specified by the @{" integer " link integer} parameter. In Mixed or Asm modes, it steps the number of machine instructions specified by the @{" integer " link integer} parameter. If a function call is encountered, stepping continues into that function. If the @{" integer " link integer} param~۫deter is omitted, trace will step one line. EXAMPLES trace /* steps one source statement if in C mode, or one machine instruction if in Mixed or Asm mode */ t 5 /* steps five source statements or machine instructions */ SEE ALSO @{" Go " link Go}, @{" Proceed " link Proceed}, @{" PS " link PS}, @{" TS " link TS} @endnode @node TS "TS" TS -- Single-steps by source line into function calls SYNOPSIS ts [@{" integer " link integer}] DESCRIPTION The ts comma{zl_nd is similar to the trace command in that it will step into functions encountered during execution. It is different in that ts will only step by C source line, even if the source mode is set to Asm or Mixed. The @{" integer " link integer} parameter specifies the number of C source lines to step. If no parameter is specified, ts will step one line at a time. EXAMPLES ts /* steps one source line regardless of the mode the debugger is in */ ts 2 /* steps two Isource lines */ SEE ALSO @{" Proceed " link Proceed}, @{" PS " link PS}, @{" Trace " link Trace} @endnode @node UNAlias "UNAlias" UNAlias -- Deletes an alias SYNOPSIS una[lias] @{" name " link name} una[lias] * DESCRIPTION The unalias command removes entries from the debugger's list of aliases. The @{" name " link name} parameter refers to any alias name. You can use the * parameter as a wildcard character to remove all aliases. EXAMPLES unalias foo /* deletes the aliafps for foo */ una * /* deletes all aliases */ SEE ALSO @{" ALias " link ALias}, @{" DEFine " link DEFine}, @{" UNDefine " link UNDefine} @endnode @node Unassemble "Unassemble" Unassemble -- Displays memory as assembler instructions SYNOPSIS u[nassemble] [@{" location-1 " link location} [@{" location-2 " link location-2}]] DESCRIPTION The unassemble command displays the range of memory from @{" location-1 " link location} to @{" location-2 " link location} in assembler= format. By default, the command begins disassembling at the current program counter. If subsequent unassemble commands are performed before the application is given control by a trace, proceed, or go command, it will continue disassembling from the point at which it finished the last invocation. If source line number information is available for the range of memory being disassembled, unassemble will display the C source line before displaying the corresponding instructions. It I_will display the number of assembler instructions generated for one C source line. If no source information is available for the range of memory being displayed, unassemble will display the default number of instructions as specified by the unassemble default item in the Options menu. By default this number is 4 instructions. The output of the unassemble command is equivalent in format to assembler mode output displayed in the Source Window. It will consist of three or four columq&σns depending on the setting of the instruction bytes option, which is controlled by the opt ibytes command. (See Chapter 4, "Setting Up the Debugging Environment, " in the Volume II of the User's Guide for more information about setting instruction bytes.) The following is an example of unassemble output with instruction bytes on and source unavailable: > unassemble 0x25F950 48E70130 MOVEM.L D7/A2-A3,-(A7) 0x25F954 BFEC0004 CMPA.L 0004(A4),A7 0x2d25F958 65001BD6 BCS 00261530 The first field contains the hexadecimal address of the instruction being disassembled. The second field is a hexadecimal dump of the actual bytes composing the instruction. The third field consists of the M680X0 mnemonic for the given opcode. The fourth field consists of the operands to the instruction. If the instruction bytes option is turned off, the second field is not displayed. EXAMPLES unassemble \mod1\func1 10 /* unassemb/Rles line 10 of func1 in mod1 */ unassemble 13 14 /* unassembles lines 13 to 14 */ unassemble func1 /* unassembles the first line of func1 */ unassemble func1 func2 /* unassembles from &func1 to &func2 */ unassemble /* continues unassembling at the last location */ SEE ALSO @{" OPt " link OPt}, @{" List " link List} @endnode @node UNDefine "UNDefine" UNDefine -- Deletes a macro definition SYNOPSIS [#]u`Snd[efine] @{" name " link name} [#]und[efine] * DESCRIPTION The undefine command removes entries from the debugger's list of macro definitions. The @{" name " link name} parameter specifies the name of the macro to removed. You can use the * as a wildcard character to remove all macro definitions. The # sign can be inserted before the undefine command so that C header files (.h files) can be read by CodeProbe. EXAMPLES #undef foo /* deletes the macro named foo */ unde fine * /* deletes all macros */ SEE ALSO @{" ALias " link ALias}, @{" DEFine " link DEFine}, @{" EXecute " link EXecute}, @{" UNAlias " link UNAlias} @endnode @node Watch "Watch" Watch -- Sets a watch on a variable or memory SYNOPSIS w[atch] @{" expression " link expression} | @{" range " link range} [s[tatic] | d[ynamic]] DESCRIPTION The watch command is used to set a watch for the variable or memory range specified. Whenever control is returned to the user, for example b|jy stepping or stopping at a breakpoint, the new value of the watched object is displayed in the Watch window. The Watch window can be opened with the View menu, the window command, or by pressing F1. In line mode, the object is not automatically displayed. You must use the wlist command to display it. The watch command does not cause the debugger to stop execution when the value being watched changes; it just displays the changed value. Use the wbreak command to cause the debuggR1Cer to stop when a value is changed. By default, watches are dynamic; that is, the expression being watched is re-evaluated whenever control returns to the debugger. The static option causes the watch expression to be evaluated once, when the watch is set. The result is treated as an address whose contents are displayed. EXAMPLES watch text->len /* sets a watch for the symbolic scalar text->len */ w \mod\f1\a[0] L 20 /* sets a watch for a length o)-f 20 bytes starting at the symbolic range specified by \mod\f1\a[0] */ w &a[0] .. &a[5] /* sets a watch for the range from &a[0] to &a[5] */ watch tmp[i] static /* if i = 3, watches tmp[3] regardless of changes to i */ SEE ALSO @{" WBreak " link WBreak}, @{" WClear " link WClear}, @{" WDisable " link WDisable}, @{" WEnable " link WEnable}, @{" WList " link WLi.st} @endnode @node WBreak "WBreak" WBreak -- Sets a watch break SYNOPSIS wb[reak] @{" expression " link expression} | @{" range " link range} [s[tatic] | d[ynamic]] DESCRIPTION The wbreak command sets a watch break for the expression or memory range specified. Whenever any byte in a specified range is modified, control is returned to you. By default, watch breaks are static; that is, the expression is evaluated once when the watch break is set. The address result of the expression is then monitored by the watch break. The dynamic option indicates that the watch break @{" expression " link expression} or @{" range " link range} should be re-evaluated whenever control returns to the debugger. EXAMPLES wbreak text->len /* sets a watch break for the symbolic scalar text->len */ wb \mod\f1\a[0] L 20 /* sets a watch break for a length of 20 bytes starting at the symbolic range specified by \mod\f1\a[0] */ wbreak &a[0]..&a[5] 80 /* sets a watch break for the range from &a[0] to &a[5] */ wb p->q dynamic /* sets a watch break for different locations depending on the value of p */ SEE ALSO @{" Watch " link Watch}, @{" WClear " link WClear}, @{" WDisable " link WDisable}, @{" WEnable " link WEnable}, @{" WList " link WList} @endnode @node WClear "WClear" WClear -- Clears one or more watches SYNOPSIS wc[lear] @{" integer " link integer} [@{" integer " link integer} ...] wc[lear]p† * | l[ast] wc[lear] @{" integer " link integer}..@{" integer " link integer} DESCRIPTION The wclear command is used to clear one or more watches or watch breaks. When a watch is cleared it ceases to exist and can be reinstated only by issuing the watch or wbreak command again. You can use the wdisable command to temporarily disable a watch. The @{" integer " link integer} parameter specifies the number of a watch as displayed by the wlist command. Any number of integer values 0|#0can be specified as parameters to the wclear command. The * parameter specifies that all watches and watch breaks should be cleared. You can specify that all watches and watch breaks between two watch numbers be cleared by using the form @{" integer " link integer}..@{" integer " link integer}. The last parameter can be specified to clear the last watch or watch break that was set. EXAMPLES wclear 2 5 6 /* clears watches or watch breaks numbered 2, 5, anܖd 6 */ wclear last /* clears the last watch or watch break set */ wc * /* clears all watches or watch breaks */ wc4..7 /* clears watches 4, 5, 6, and 7 */ SEE ALSO @{" Watch " link Watch}, @{" WBreak " link WBreak}, @{" WClear " link WClear}, @{" WDisable " link WDisable}, @{" WList " link WList} @endnode @node WDisable "WDisable" WDisable -- Disables one or more watches SYNOPSIS wd[isable] @{" integer " link integer} [@{" integer " link integer} ... ] wd[isable] * | l[ast] wd[isable] @{" integer " link integer}..@{" integer " link integer} DESCRIPTION The wdisable command is used to disable the recognition of one or more watches or watch breaks. When a watch or watch break is disabled, it is no longer recognized, but it remains on the current list of watches. A wenable command can be used to re-enable a watch or watch break that has been disabled with the wdisable command. The @{" integer " link integer} parameter specif?ies the number of a watch, as displayed by the wlist command. Any number of integer values can be specified as parameters to the wdisable command. The * parameter specifies that all watches and watch breaks should be disabled. You can specify that all watches and watch breaks between two watch numbers be disabled by using the form @{" integer " link integer}..@{" integer " link integer}. The last parameter can be specified to disable the last watch or watch break that was set. E/kXAMPLES wdisable 2 5 6 /* disables watches or watch breaks numbered 2, 5, and 6 */ wdisable last /* disables the last watch or watch break set */ wdisable * /* disables all watches or watch breaks */ wdisable 4..7 /* disables watches 4, 5, 6, and 7 */ SEE ALSO @{" Watch " link Watch}, @{" WBreak " link WBreak}, @{" WClear " link WClear}, @{" WEnable " link WEnable}, @{" WList " link WList} @endnode @node WEnable "WEnable" WEnable -- Enables one or more watches SYNOPSIS we[nable] @{" integer " link integer} ... we[nable] [*] | l[ast] we[nable] @{" integer " link integer}..@{" integer " link integer} DESCRIPTION The wenable command is used to enable the recognition of one or more watches or watch breaks that have been disabled by the wdisable command. The @{" integer " link integer} parameter specifies the number of a watch, as displayed by the wlist command. Any number of integer values can be specified =as parameters to the wenable command. The * parameter specifies that all watches and watch breaks should be enabled. You can specify that all watches and watch breaks between two watch numbers be enabled by using the form @{" integer " link integer}..@{" integer " link integer}. The last parameter can be specified to enable the last watch or watch break that was set. EXAMPLES we 2 5 6 /* enables watches or watch breaks numbered 2, 5, and 6 */ we last  T޹ /* enables the last watch or watch break set */ wenable * /* enables all watches or watch breaks */ we 4..7 /* enables watches 4, 5, 6, and 7 */ SEE ALSO @{" Watch " link Watch}, @{" WBreak " link WBreak}, @{" WClear " link WClear}, @{" WDisable " link WDisable}, @{" WList " link WList} @endnode @node WHAtis "WHAtis" WHAtis -- Determines the type of an object SYNOPSIS wha[tis] @{" expression " link expression} wha[tis] (@{" type " link type}) DESCRIPTION The whatf6Bis command displays the type, location, and storage class of an object, or gives additional information about a data type. If an @{" expression " link expression} is given, whatis displays the C data type of the expression. If the result of the expression is a simple variable or a member of an array, whatis displays the address of the object and identifies it as either static, extern, or automatic. If the result of the expression is a function, whatis displays the address of the f̊unction, its return type, and its location. If a parenthesized @{" type " link type} is given, including types that are defined by a typedef statement, whatis displays the full definition for the type. For struct, union, and enum types this means all members of the aggregate are displayed; for a type that has been defined by a typedef statement, this means the base type of the typedef is displayed. Using the whatis command on basic C data types such as int or long is allowed, but i tt is not very useful. EXAMPLES whatis i /* determines the type of a variable named i */ wha main /* determines the type, address, and defining @{" module " link module} for the main function */ wha 3.5 /* determines the type of a constant */ whatis Red /* determines the type of an enumeration constant */ wha *p->c[3] /* determines the type of the expression *p->c[3] */ whatis (int) (1*3.4) /* determines the type of an expression /Pwith a type cast */ whatis (node) /* determines the type of a typedef */ whatis (struct X) /* displays the members of struct X */ @endnode @node WHEre "WHEre" WHEre-Shows the calling sequence SYNOPSIS whe[re] [a[rgs]] [@{" integer " link integer}] DESCRIPTION The where command displays a backtrace of the function calls in the call sequence. Calls are listed in reverse order beginning with the most deeply nested function. The argsrU, option causes the where command to display the arguments to each function in a manner similar to the args command. The @{" integer " link integer} parameter specifies the number of calls to be displayed. By default, only the 20 most recent calls are printed. Here is an example of the output from the where command: > 1 In routine fpreg.o:\fpreg.c\five 48 > 2* Called from fpreg.o:\fpreg.c\six 68 (+0xE) > 3 Called from fpreg.o:\fpreg.c\seven 82 > 4 Called from fpreg.oν:\fpreg.c\main 92 > ... The numbers on the left indicate a level number that can be passed to the env command. Level 1 is defined to be the function in which you are currently stopped or the run environment. The caller's level is 2, its caller is 3, and so on. These level number designations change over time as the program steps into and returns from functions. The asterisk indicates the current user environment as set by the env command. The Calls window also displays this Z=information. EXAMPLES whe /* displays a list of the last 20 function calls */ where 5 /* displays a list of the last 5 function calls */ where a /* displays the arguments to each function */ SEE ALSO @{" ARgs " link ARgs}, @{" ENV " link ENV} @endnode @node WIndow "WIndow" WIndow -- Opens or close a window SYNOPSIS wi[ndow] [on | off] DESCRIPTION The window command is used to open and close a specified window. Any of the following values can bej specified as the parameter: c[alls] mo[dules] w[atch] he[lp] ms[g] s[ource] me[mory] r[egister] If the window command is invoked with only a parameter, the command acts as a toggle for the specified window; thus, if the window is currently opened, the window command will close it, and if it is currently closed it will be opened. If on or off is specified, the window is forced into that state, regardless of its current state. If a window that is already open is set to on, it will pop to the top of the window hierarchy. The window command is ignored in line mode. EXAMPLES wi register /* toggles the Register window */ window help on /* opens the Help window or pops it to the top */ @endnode @node WList "WList" WList -- Lists all watches SYNOPSIS wl[ist] DESCRIPTION The wlist command lists all watches and watch breaks. Disabled watches are max^rked with an asterisk. Watch breaks are distinguished from regular watches by an exclamation mark. The value associated with the watch is displayed if available. EXAMPLES wlist /* lists all watches */ SEE ALSO @{" Watch " link Watch}, @{" WBreak " link WBreak}, @{" WClear " link WClear}, @{" WDisable " link WDisable}, @{" WEnable " link WEnable} @endnode @node WMSG "WMSG" WMSG -- Writes a message to the Message window SYNOPSIS wmsg @{" integer " link integer} @{" text " link text} DESCRIPTION The wmsg command is used to write the text specified by the parameter in the Message window. The @{" integer " link integer} parameter specifies the location in the window for the text. Line 0 is the top line. This command is primarily used with debugger or AREXX scripts. EXAMPLES wmsg 0 --- This is the Message window. --- /* displays the string " --- This is the Message window. --- " on the top line of the Message window */ wmsg 12 This goes on line 12. /* displays the string This goes on line 12. on line 12 of the Message window */ @endnode @node MEMCMP "MEMCMP" MEMCMP -- Compares two memory blocks SYNOPSIS i = memcmp(a, b, n); int i; /* comparison results */ void *a, *b; /* blocks being compared */ int n; /* block size in bytes */ DESCRIPTION The memcmp function compares two memory blocks and returns a value whose sign indicates the collatinr|g sequence of the blocks, as follows: Return Meaning -------- ----------------------- Negative First block below the second Zero Blocks are equal Positive First block above the second CodeProbe has a built-in #define that causes all references to memcmp to be referenced to __builtin_memcmp, which is the actual name of the CodeProbe function. If you want to step into or call an actual funcmtion called memcmp in your code, you should use the undefine command to clear the define or use the backtick character to escape the function's name. EXAMPLES display memcmp(ptr1, ptr2, n) /* displays the result of comparing ptr1 and ptr2 for n bytes */ b 27 when(memcmp(ptr1, ptr2, 10) < 0) /* breaks at line 27 when the 10 bytes pointed to by ptr1 evaluates to a value less than the value of the 10 bytes pointed to by ptr2 */ SEE ALSO @{" M )EMCPY " link MEMCPY}, @{" MEMMOVE " link MEMMOVE}, @{" MEMSET " link MEMSET} @endnode @node MEMCPY "MEMCPY" MEMCPY -- Copies a memory block (non-overlapping) SYNOPSIS to = memcpy(to, from, n); void *to; /* destination pointer */ void *from; /* source pointer */ int n; /* block size in bytes */ DESCRIPTION The memcpy function copies data from one memory block to another. The destination pointer is returned. The memcpy function cannot be used to copy overɳlapping memory blocks. You should use the memmove function when copying overlapping blocks. Also note that you can crash your machine if there is not enough memory to hold the data at the destination memory location. CodeProbe has a built-in #define that causes all references to memcpy to be referenced to __builtin_memcpy, which is the actual name of the CodeProbe function. If you want to step into or call an actual function called memcpy in your code, you should use the undefine cښ[ommand to clear the define or use the backtick character to escape the function's name. EXAMPLES call memcpy(ptr1, &j, 10) /* copies 10 bytes from ptr2 to ptr1 */ call memcpy(0x804a, myptr, 50) /* copies 50 bytes from myptr to location 0x804a */ b 27 {memcpy(a0, a1, 15)} /* sets a breakpoint at line 27 with an action to copy 15 bytes from the memory pointed to by register A1 to the memory pointed to_@- by register A0 */ SEE ALSO @{" MEMCMP " link MEMCMP}, @{" MEMMOVE " link MEMMOVE}, @{" MEMSET " link MEMSET} @endnode @node MEMMOVE "MEMMOVE" MEMMOVE -- Copies a memory block (possibly overlapping) SYNOPSIS to = memmove(to, from, n); void *to; /* destination pointer */ void *from; /* source pointer */ int n; /* block size in bytes */ DESCRIPTION The memmove function copies data from one memory block to another. Overlapping blocks are handled correctly. 5\ The destination pointer is returned. Note that you can crash your machine if there is not enough memory to hold the data at the destination memory location. CodeProbe has a built-in #define that causes all references to memmove to be referenced to __builtin_memmove, which is the actual name of the CodeProbe function. If you want to step into or call an actual function called memmove in your code, you should use the undefine command to clear the define or use the backtick charactetr to escape the function's name. EXAMPLES call memmove(ptr1, &j, 10) /* copies 10 bytes from ptr2 to ptr1 */ call memmove(0x804a, myptr, 50) /* copies 50 bytes from myptr to location 0x804a */ b 27 {memmove(a0, a1, 15)} /* sets a breakpoint at line 27 with an action to copy 15 bytes from the memory pointed to by register A1 to the memory pointed to by register A0 */ SEE ALSO @{" MEMCPY " link MEMCPY}, @{"z# MEMCMP " link MEMCMP}, @{" MEMSET " link MEMSET} @endnode @node MEMSET "MEMSET" MEMSET -- Sets memory to a specified value SYNOPSIS to = memset(to, c, n); void *to /* base of memory to be initialized */ int c; /* initialization value */ int n; /* number of bytes to be initialized */ DESCRIPTION The memset function sets the specified number of bytes of memory to the specified value. Note that you can crash your machine if there is not enough mem7R!ory to hold the data at the destination memory location. CodeProbe has a built-in #define that causes all references to memset to be referenced to __builtin_memset, which is the actual name of the CodeProbe function. If you want to step into or call an actual function called memset in your code, you should use the undefine command to clear the define or use the backtick character to escape the function's name. EXAMPLES call memset(ptr, 0, 100) /* sets 100 bytes to 0 starting єat the address pointed to by ptr */ call memset(a0, 'X', 50) /* sets 50 bytes to the ASCII character X starting at the address pointed to by register A0 */ SEE ALSO @{" MEMCPY " link MEMCPY}, @{" MEMCMP " link MEMCMP}, @{" MEMMOVE " link MEMMOVE} @endnode @node STRCAT "STRCAT" STRCAT -- Concatenates two strings SYNOPSIS to = strcat(to, from); char *to; /* destination po.inter */ char *from; /* source pointer */ DESCRIPTION The strcat function copies data from one string to the end of another string until a null character is found. Overlapping strings are not handled by the strcat function. Note that you can crash your machine if there is not enough memory to hold the string at the destination memory location. CodeProbe has a built-in #define that causes all references to strcat to be referenced to __builtin_strcat, which is the actual 1Utqname of the CodeProbe function. If you want to step into or call an actual function called strcat in your code, you should use the undefine command to clear the define or use the backtick character to escape the function's name. EXAMPLES call strcat(myptr, "foo ") /* concatenates the string "foo" after the string pointed to by the variable myptr */ SEE ALSO @{" STRLEN " link STRLEN}, @{" STRCMP " link STRCMP}, @{" STRCPY " link STRCPY} @endnode @node STRCMP Ԝ"STRCMP" STRCMP -- Compares two strings SYNOPSIS i = strcmp(a, b); int i; /* comparison result */ char *a, *b; /* strings being compared */ DESCRIPTION The strcmp function compares two strings and returns a value whose signs indicate the collating sequence of the blocks as follows: Return Meaning -------- ----------------------- Negative First string below the second Zero Strings arxoe equal Positive First string above the second CodeProbe has a built-in #define that causes all references to strcmp to be referenced to __builtin_strcmp, which is the actual name of the CodeProbe function. If you want to step into or call an actual function called strcmp in your code, you should use the undefine command to clear the define or use the backtick character to escape the function's name. EXAMPLES display strcmp("abc ", "def") /* tests the stri1ngs "abc" and "def" and displays the return value. The value indicates whether the strings are equal or which string is higher */ break myfunc when(strcmp(arg, "foobar") == 0) /* breaks at the function myfunc when the variable arg points to the string "foobar" */ SEE ALSO @{" STRLEN " link STRLEN}, @{" STRCPY " link STRCPY}, @{" STRCAT " link STRCAT} @endnode @node STRCPY "STRCPY" STRCPY -- Copies a string SYNOPSIS to = strcpy(to, from); V char *to; /* destination pointer */ char *from; /* source pointer */ DESCRIPTION The strcpy function copies data from one string to another until a null character is found. Overlapping strings are not handled by the strcpy function. Note that you can crash your machine if there is not enough memory to hold the string at the destination memory location. CodeProbe has a built-in #define that causes all references to strcpy to be referenced to __builtin_strcpy, whvlich is the actual name of the CodeProbe function. If you want to step into or call an actual function called strcpy in your code, you should use the undefine command to clear the define or use the backtick character to escape the function's name. EXAMPLE call strcpy(a, b) /* copies the string pointed to by b to the memory location pointed to by a */ SEE ALSO @{" STRLEN " link STRLEN}, @{" STRCMP " link STRCMP}, @{" STRCAT " link STRCAT} @endnode @nodX9e STRLEN "STRLEN" STRLEN -- Returns the length of a string SYNOPSIS len = strlen(s); int len; /* length of string s */ char *s; /* string to scan for length */ DESCRIPTION The strlen function returns the length of a string, as determined by the index of the first null character found. CodeProbe has a built-in #define that causes all references to strlen to be referenced to __builtin_strlen, which is the actual name of the CodeProbe function. If you want toU step into or call an actual function called strlen in your code, you should use the undefine command to clear the define or use the backtick character to escape the function's name. EXAMPLES display strlen("hello ") /* displays the length of the string "hello", which is 5 */ display strlen(0x804a) /* displays the length of the string starting at address 0x804a */ SEE ALSO @{" STRCMP " link STRCMP}, @{" sSTRCPY " link STRCPY}, @{" STRCAT " link STRCAT} @endnode @node HELP "HELP" @{" Getting Around " link "Getting Around"} @{" Organization " link organization} @endnode @node "GETTING AROUND" You have reached this Help window by either clicking on the Help button or by hitting the Help key within the SAS/C Help utility. Unlike other help topics present in the SAS/C Help utility, the Help help topic opens its own window. You must close this window by clicking on the cAlose gadget or hitting escape before returning to the SAS/C help utility. You cannot hit the Retrace button to return. To quit the SAS/C Help utility, select Quit from the Project menu or click on the close gadget. You may also hit escape. Most help screens will display one or more buttons as part of the text. Clicking on these buttons will provide further information on the topic listed on the button. You can also reach these help topics through the main Contents screen or one r6Gof its sub-screens. In addition, double-clicking in the help window will bring up a help screen for the word under the mouse cursor, if such a help screen exists. While in the SAS/C Help utility, you may retrace your steps through the help screens you have selected by clicking on the Retrace button. The Browse buttons will move you forward and backwards between help screens. The help screens are usually arranged alphabetically by command or topic. @endnode @node ORGANIZATION "ORGD9ANIZATION" The CPR Amigaguide Help Utility is organized into three sections. The sections are: - Commands and Builtin Functions - Parameter Types - Common Problems The first screen (the screen displayed when you select the "Contents" button) displays an alphabetized list of all commands and builtin functions that you can use in CPR. Selecting one of these buttons will display a window with sections titled "SYNOPSIS", "DESCRIPTG&7ION", "EXAMPLES", and "SEE ALSO". The "SYNOPSIS" section describes the syntax of the command, including any parameters that it may take. A parameter is the part of the command that is specific to each situation in which you use it. For example, the command "display my_variable" displays the contents of a variable called my_variable. The name of the variable can vary, so this is represented in the "SYNOPSIS" section by placing the word "variable" on a button in its proper place in0 the syntax. Clicking on this button will pop up a description of what can replace "variable" in the syntax for the command. The "DESCRIPTION" section describes what the command does. If present, the "EXAMPLES" section gives some common examples that will help explain the use of the command. The "SEE ALSO" section lists other related commands that either have a similar function or that can be used in conjuction with the command. The commands listed in the "SEE ALSO" section are ٿOequipped with links to allow you to quickly reference them. The first screen also displays two buttons that will lead you to the Parameter Types and Common Problems windows. In the Parameter Types window, buttons are displayed for all of the different types of parameters that the CodeProbe commands and builtin functions may take. Selecting one of these buttons will pop up the same description for each that is displayed from the parameter buttons in the "SYNOPSIS" section of each cobNImmand. The Common Problems section described some problems that you might run into while running CPR for which there is a simple solution. If you have questions that aren't answered in this question, please contact Technical Support. Please read the section titled "Contacting Technical Support" in the User's Guide volume 1 before doing so. @endnode se buttons will pop up the same description for each that is displayed from the parameter buttons in the "SYNOPSIS" section of each coyD se.guide.infoW[6+#|6p  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=T.DyEXT|ASCII|AMIGAGUIDE+#|6p  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=T{sc_prob.guide.infokQ6+8)@6q  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=TkNCEXT|ASCII|AMIGAGUIDE+8)@6q  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=T -sc_change.guide.info9 s6rэ6s@  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=TAEXT|ASCII|AMIGAGUIDErэ6s@  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=TO?sc_lib.guide.info˅6؛PёqH6t  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=T^@FEXT|ASCII|AMIGAGUIDE؛PёqH6t  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=TiTcpr.guide.infoVX 6أxѝȍx6v  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=T>EXT|ASCII|AMIGAGUIDEأxѝȍx6v  0 ( $ ꪪ ?  UUUUUPUUUUUPPPUPP_UU]PPUUUUWPPUUUWPPUUUUWPP_U}WPPPPUUUUUPUUUUUPSC:C/AmigaGuideFILETYPE=Tw\rexxman.se</* bring up library help on a function */ options results 'GW' options address 'COMMAND' 'run >nil: amigaguide sc:help/sc_lib.guide doc ' || result || '()' man.se/ 4man.cpr7 /* display help for library functions Usage: man where is a function in the SAS/C library */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg expr if (expr = '?') then do do i = 2 to 4 'd "' strip(sourceline(i),'T', "0a"x) '"' end exit(0) end address 'COMMAND' 'run >nil: amigaguide sc:help/sc_lib.guide screen SC_C̬kPR.1 doc ' || expr || '()' functions Usage: man where is a function in the SAS/C library */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg expr if (expr = '?') then do do i = 2 to 4 'd "' strip(sourceline(i),'T', "0a"x) '"' end exit(0) end address 'COMMAND' 'run >nil: amigaguide sc:help/sc_lib.guide screen SC_Ct help.infoq 9ΘM22d@Z(9m $ $ $ $$$ ?03777*77?76?9m5UUUUU\@@@ @ @ @@ ,V?0"UUUUUP????*????m $ $ $ $$$ ?03777*77?76?9m5UUUUU\@@@ @ @ @@H sorwsqErSASC_6.0_Disk_6iErE ?:(h:(0,cc@° ˠˠPX#° X̨XX#;`° `rCTrashcanpstvut Trashcan.infopsuߝ3ßXu0=(22d@Z(3`?8Usv֮UT}B7??"%?"$=*DJu3P~UjT s$}-UU~UT}B7??"%?"$=*DJu?8UwHxN~}|{zyxamigaguide.librarypwy)U6@F6pNuJ " :Pamigaguide 34.4 (20.7.92) amigaguide.libraryNq`V(R0 TXTdf>=;5D(L-N.( :"NqpNuY"Oav _NuH6*y~pVrHA,xN:&@Jg^A 9g"@Nb 9g"@Nb 9g"@Nb 9w}hg"@Nb 9g"@Nbp0-" t4-v6ւ"A N. L`NuNN8NlpaH6*H/I ,xN&@/@" fp`$m0 f@,<h -g @"JfS,i/</N7PO$@Jf pg'@p`8%mA*NB%m %mHjN+\XOB -gXAh%H m"jfJg< </Hz/*NuO %@g/NrXO` p%@rl%AJfN*, U"mNr&@/@$g%K// / / /9afOJ@gp"mN%@BBN6PO%@gXr @(p%@+KgpxЀ yrf Rjw~+9 yN"JN yR`,p%@rl%A`p%@rh%A`r%A o%h N*&o gV~Jg< y hN.Jg, @!j&!|+!j$!j("@ j"N~`~JGgb/ / N62PO`VJfPGj o$(Kg J$g&m$B/-(Hx/ HzD/ Ng0OJgB/ N5POp%@ o!@ o!j LlNuguideMaindiskfont.librarytopaz.fontENV:AmigaGuide/PensH"o o L(`H60/"*oA"ofAE $4E$4BG K,yN$@Jg 0*mg(Cfp,xN*@Jg K,MN$@"M,xNb gwԐ0* o1@1@ LlNuH36&o<*o8$o@Jf-g: j ,yN'@g`d,yN'@gRB `F,yN.'@g6,y$n/.*o( g m g:p /@B "h,h(/I/ C $n@ /N$_- JfK-KglAP"hg &P`JGf+5f/ a$XO&J$S fJGg<"M,xN -Dg ",yNBD"y ifB/ N/XO LlNuQOH/@ N#n. y\"hg,*P`" yJf MNj` Hx/ aPO*K&U f N#.L(PONu0H6*H/IA(CpL,PONu op !@NpNuH6*o&yx o$h,N. K"JNJgT yr"@)w /)//)/)HzHhN=XOp*"y IJfS  I,yN`p*p +@ NpLlNu op BpNuNNdNfpaYOH86*o$- g"o(&i$k2 i"y)gp`p0(?@ K"Mp,yND 2/t4?@ "J,yNC0H2H4H6-HւS4- H8-H؂S$&"JN0/r2/  K"Mr,yЕNJ$_/ M"KpNP _p`pLlXONuMainhelp.guidehelpSearchStringMAINHelpbookmark.deviceLINK "%s/%s" %ldbookmark.0H6*o- fF o&h K"Mp,yw cND r2  K"Mr,yNJ M"KpNPp`pLlNu H6*o$$m J~"j/H)5f BHz/ NO f @J"g~JGg / Hja` / HjaFPO/ HjBa:PO j g h@CN(Jf / Hjna`,HxHz/ NFO Jg / Hjna` / HjnaPO~A""hg,Pg~JGg/ HjaPO`/ HjaPO%HB%H>B J$h&hP g@g< j&/Hf2*j`*m g mgf g mf m /H*o&o+KFg K"j N'Jg / Hma` / Hma POB$m&mP g@g: j*/Hf0*Rw^`*U g mgf g mf m /H&o*o'MJg M"j N'Jg / Hkab` / HkaPOpLl NuH*o &m g"Jbg m"hb/ N`/ NYXOpL(Nu o1|pNu o h g/N%XOpNu oHxHx/(NnO pNu H!*o m gp&h gh~`^ kRfP m ("m@Шl8 "2(Ht4-/A"/@NЯHx////NAOR^mpL( Nu H!*o m gp&h gh~`^ kRgP m ("m@Шl8 "2(Ht4-/A"/@NNЯwPHx////N@OR^mpL( Nu o h ("R!@"1|NpNu o h ("ШS!@"1|NpNu/ *o mJFg*Hxp///(FHz/ NVNOJg mp*_Nu/ *o mJJg*Hxp///(JHz/ NVOJg mp*_Nu/ *o m"hP ICN Jg*Hxp//HzHz/ NUOJg mp*_NuH4*o m&hE~ k g$h` +"g$@ J"kN$Jg.Hxp/// Hz$/ NUXOJg m1|NpL,NuH*o HxBHxA/// NUOJg m1|w N` m,yNpL`NuH *o m"h )^rc& mt4("N"<N!@"` m!A"pL NuH *o m"h )b6rc& mt4("N"<N!@:` m!A:pL NuH6>/"$o|BBN"PO*@Jg/ NbXO&@JgAp "Kr,xNDJfz 7@r2UgDSg p fN| p '@,'|$B(`4B, JJfS R'@$'J(`B,'|$A'H("K,xN8+"KN>/ NXO/ N!XOLlNuH76*o( m"h~G$i/("/)/*@Hz:/ N3O y(g8w\ZHx/ aPO^f$Hx / aPOJf^Hx/ aPOJfN~`J~`F"-,yN,A"$<N*g KJfS&"$ N."N"NRf*p+@pn+@*mNr0|"@$H m,yNpLlNuH72&o$~ y(gHx/ aPOJfF~`B"+,yN,A@"$<N*gA$"vFN."N"N Rf,p'@po'@&kNr>0|"@$H k,yN`Jo B/ NmPOpLLNuNNNNNfNHpa"o iFnNuH&o*o.+n|Rn +nJl/ / aPOr f'Gn|`/ / aPOr}fp`JgwAL^ L(NuH&o*o.+n|Snm8/ / a~POr g(/ / anPOr{fSn/ / aZPOr@fp` 'Gn|Jg L(NuH./&o*o|`Rn +J"+nm S'@np`Jkzg(/ / aPOr"f/ / aPOJfRnBkz`\/ / aPOr@fL kFnp{(fPOr"f/ / aPOJfSnBkz`@/ / aPOr}f0/ / ajPOJf"z/ / aPOr"fRRnpmUnRm~pL(NuH&o*o,+nw՜w7Hx/ / axO .f/ / aPOr fp`JgJg'Fn L(NuH&o*o,+nHx/ / aO .f"/ / aVPOr fHx/ / aO `JgJg'Fn L(NuYOH*o/// aPO@ -fe(-gb"~*mb`/ fp`RG&Mp0JfpL(XONuYOH./ &o*o|Hx/ / aHO Jf/ / a<Hx/ / a`O// / aRO JFg/ / aVPOJ@gr`r// / ?AaO 0/L(XONuH/4$o,&o(*o$|~z(+n/ / aPOJfX`>/ / a POr"fr\g ER$( ER"Hx/ / aO ,/ / aPOr gJgw B2X'DnpL,NuH*o~|*-n` mFp 0xfRRnJm L NuH'*oAR"HJfS+IVBmZ g|&M'mVZ'F ZRX mJm\g(|`܆zGAp0X'@ ZRRX mJm`gJbf+|b|fB-g~`V mbp0"H-fdr` p0p"Af mbp0"H-gcr` p0p"AgRG mbp0J0fJm^g&|aG + ZHHNHH'@ ZRX m|`Fp"R5H"-V Z 5SZ+p?"R5fRmZRVm -VVg*|&M -V"+Zo$Z+(RX mwVv4L(Nu o!hrj!hvnpNuH'&o *o.-Vfp`,// / avO Jg/M/K L(`S/ / aPOrH Z"5p$R5(H Z 5gt?f2JfJm`g// / anO J@gp`vHx/ / aO `pHZ*5 o"// / aO Jg2/M/K L(`// / aO Jg/M/K L(`,`(L(NuH6./*o ,xN&@$y\N Z,B J"MN @$@JgRL`r MJfS rxFЁ/</NnPO$@JgFAM@, M"Vf%^ Jg",yN%@,B J"MN $&@JgRL`:/ /aPO&@Jg*/ axXOJg J"KN yR` / NXO N LlNuH*H~ g0N , -LgSL.-LfKHx/ NTPO N L Nu H?6*oL,xN&@$m@ J~|/H, -/B@/BD`~z`2Xr gJf /@Ї+@zB2XRb Jp@fP// a|PO,gB&mv- Jf g oDg|0/>2-h@ct4`r2$;BhBo>/KD`Vpbf8//,HzHoHN'HoL/ aO,&mv g& -z'@>5` gp>f'mz>Ro>.R XRlJf߯@"-D$/@v,yN~*/0g|Jg"-D$ &,yN(n-Kf+o4zHz/ apPO/ NXO,/8Jg"Jg^",yN`Ppd'@`pe'@~"-D,yNBD`pe'@Jg ",yN -v,yN"+:$+F&+JNְJf / / afPO. LhNuTH6*H/I~ g m`&HJg4 g.JFf o%hD:"jf gMwdPVA(p Q gJg kXM ,,/|D g m`/HH/|L gA`/HP gJg <`pGT&A &Bp/@(/j0/j2@AD/H, i,i(/H/ IC,$n@ /N$_Jg(/Cg~` /8g%@F%o<J/ / a2PO.%o4:`/ / aZPO.`~Jo o!JvR6RL LlTNup+@~ K /g @&H"HJfS X/</NPO%@g K"@fAP"J,xN LlNuH4*o~Ho// NPO,rc oCNN:JfpbfK.` oC2NJfpc //NXO`p;@f` oCNJf&pc //NXO`p;@hg\ J`R oCNJff -z'@> -z>'@J-Kg"M$Kaz.`~Bv` oCDNJfR*mv gpc/-N o JfS X./N PO+@g` o"@f~`P oCN Jfj&mv g6pc.AP"oN.Jg @5'@` o JfS R/</N TPO'@"g o"@f~` oCvN 4JfH*mv gpc o JfS R/</N PO+@&g o"@f~`| oC$N JfB*mv gdpc^ o JfS R/</wN PO+@*g8 o"@f~`*p oCN0Jf&mv gp>f'mz>~ L,NuNNӊN(NR oX"o"B#INuT:AmigaGuide%ldtimer.device/ oC ,yN,_NuH*o~|r+fR` r-f|R`p"҇ҁҀ.p0r0er9cJg w$sD` L NuYOH4.&H*@|zx$K`BRe`Rr gr gr gr gr,gg"RHABAHA$Kr"f`?|xfxR$`<r\f|`JoRJfr"fRWrJgBo`Rpo|JgJofJf.`<$`Rgr gr gr g r gr,fJgBe2 B L,XONuH o"o r@L(`H6"/4&o0*o,AVCp"Q2 gp`&?m?m m/PA"K,yNLlNuH6&I*H,xN $U`> j "k N Jo, M,xNf M"KN`/ M"K$jN$_$K`$RfLlwW!NuH! o"t,yN.g@/<HxNPO&@Jg$"$ NJg +o "N `/NhXO"NpLHNuH&o*o~ f -f -f~0L(NuH6*o&mB gd$m: g\pjfH*g@ K"Jp,yND r2/ "J  Kr,yЕNJ _/"KpNP$_Bm8B:BBLlNuH6&o4 o0*h,"o,$i:0<hfPHxHo/aO BJ@g /HHNjH&o,?Ak8fJ:f&/ aXO&m>` +(2/@f$K`&S f&o, f p of$k> g* f o0( gJ:fzp0*SgWfl/ J"M,ywz?ЕN2`V M"Jp,yND*gj `*g r2/ "J  Mr,yЕNJ _/"MpNP$_7o8'MB'J:`" o0(g gp0*&&//,aXO gp`pLlNuH/*o$~|Nxf*xG R/Hz/ NfO " t,yNJg"N`" $<N,fB-~JGf Nx: LhNuH./*og ",yN g " ,yNL`NuH./BBNrPO&@Jg/ NVXOL`NuYOH6,BK`4/<HxN4PO&@Jg"$F"*,yN'@ **K,f /Ll@XONuH,/./fJfp`@Jg:Jg6*G&F g* g& m f -f -fp`p`pL(NuH&6,/@(,xN/@$pArHAN:/@ g&o(`/<HxN\PO$@Jgh" t,yN%@g^*o "$ ,yNJgH -oB* w!v _Jg, *@ g"/*/-a POJg M *@ f `,` pg o$!@X*S fp"o pA,xN. LldNuH,` E,"(,yN/N~XO*fL@`NuH.,/((/ *o$,xN&@z gR" $,yN*fHJf2 y((`&&D"+,yN(g" $N*"N(gJg`'| LhtNu  A///apO NuH.,/((/ *o$,xN&@z gb" $,yN*fXJf y(( g2`&&D"+,yN(g" $N*"N(gJg`ps'@`'| LhtNu  A///a`O Nu/ oC ,yNw"-՘,_NuH0"o y h'eBHx/</ aO`,H ICp"tvNL@ NuH0 o g"Jg hCHp rtv,yNL@ NuH*o g:Jg4/-alXO- fA,yNvA"mN L`NuH*o g6Jg0- gA"m,yN m,yNL`NuN NNװNNpNִNϴNӄ op`ЀgpF/NnXONu %ldH?6B~|BzBp?|NBoLBoJ?| R&oBkp'@ k"g r(t`$/+/B6N:XOBX/@.w# Y"+&g(v A(p码BHx*//+"/@hNCOHxNvXO*@/@*g `HoxHoNPO/mtp ot(rᡃ/Ap` 2$k g/j g*g0*NH// NbPO g$0*PgH// a p0*P./ N>O ` +,xN* Xg5|N/ a6XOz .g5|N/ aXOz pg ot,xNJgJoLg//|//|/ NRO *o g - g*f0-&H// a jPOJoLfB`\ gV*gLJgD*jBoD0- jr`H"p0+4*HH&/@: /A6"/:N"?@BHЪ"(0*H"/6lHx/ a POp?jw$Zv@?@B`p0/BHm4Hx/ a PO *"USt4+?AB"N!2*HҀ?A@`0 o^d&//*NrXOBoL 0+2/Bj?@@0/BHЪ""o*iRxJoNgfp?@D`g p?@DJoDg0/BH2/@HHx/// N O f 2g ` MCp "Q"M,xN o$hx5oR5oT*j/M*f'Jp?@H?@F0*2/@mt4+HH "N ?@H0*2/@mt4+HH "N h?@F /Ug]g4Qg@rgr gggRgX<g&g:g&8gw%ɷg`` HoxHoN"` / NXO` ~/ a`XO *^g/ @NXO g bJg Z/ j"m,yЕN$_` >/ a XO` 2/ aHo/ a O ` / a*o/M0-&H./ a LPO0-&rAgrAgr AgrAf/MB//////2NO ?|L`BoP*oAff*sgp5@P?@P`BjP`Af*gp5@P?@P`BjP`*g*jBo>p0+2*H4- H”/@6 "/6N?@(HЪ"(0- jm0/(Hm. o^d$//////2NO p ?@L`*o^d*mRxJoNgfw&%Ap?@>`g p?@>Jo>g0/(H2*Ht4+6/(H/@6 /A:"NЯ:Hx///>/ NO`vJRgp0/HH2/FH/// NO *@Rf&* f jRHxHh/ N BO  `(Rg"* g jRBHh/ N O  0/PgH// aPO`*f gJg/ j"m,yЕN$_0/ @grhAfN&j2/FHҪ"(rhAf@ "$/&/,yNJ@g0/Fk 0/Hk |~` ./,/*g, of$//*N\BoP .NxXO`*g0/FkHl*mRw'Q-.g BoN` ?|N o^dD0/FH2*Ht o4(6/FH/@6 /A:"NЯ:Hx///>/ NO `$0/HH2/FH/// N0O Jg5|N of6Jg.Jg//*N^XOBoL` o0(&H// aPPOBBjPBjNBoJ` j < G{,yNj j"h2/ ,y*QNP*_ j"h2/ *QNJ _/ N,pHx/ N &O j < Gz,yNjBjN`'J/ NjXO`rHoTHo/ NxO J@g /TrcPH// aPO`@/gBjPBjNBoJ`/ f/ aXO?|J y(g*0/r=Aer?Abr ow(+qR`rAe rAbr op0/rgSgSgrgSgSgrgxSgSgrgSgSgSg&Sg:Wg`BjPBjNBoJ/ NBXO`BjPBjNBoJ/ NjXO`BjPBjNBoJ/ Ng~XO`BjPBjNBoJHx/ adPO`|A]`|T]`|D]`pog |Z]`?| J`||C]`tBjPBjNBoJHx/ aPO`Z|B]`R|S]`J|?]`B|8]`:|9]`2AC\""""HxHo`HoNO J@o p/\?@J0/JHQgSgYg rg[grgUgrgr gr*fp/]5@Nw)ӐHr8gBSgr]gUgSgSgSg.rg`Sgf]fB/ N`Hx/ N.PO*k m( f,yN> mN`0/RH// aPO?@R`p/ NψXO`dp0ogHx/ a`LpogHx/ a`6Hx/ a|PO`(p0ogHx/ ad`pogHx/ aN`Hx/ a@PO`p0ogHx/ a(`pogHx/ a`Hx/ aPO`p0ogHx/ a`pogHx / a`Hx / aPO`tHx/ a`fHx/ aPO`Z/ NHXO`PHx/ a`BHx/ N`6/ NCXOJg,5|N`$Hx/ aw*[Tj`Hx/ a^` Hx/ aRPO&o k,xN*@JfNzJf J&f7|*o*Jkg g/ NXOLlNuH4>/*o&m$m ;@NHSg@SgDSgPSgRSgTSg`]glSgxSgSg[gPWgjSg]g`B"` -"R+@"`tS"`nR"`h -"ЭS+@"`X+k^"`P/ Nz`F -:6R+@:`8S:`2B:`,R:`& -:Э6S+@:` +b6+@:`/ N͌XO0-NL,NuH>/*o&m<-NBmP ;@NHQgXSg^Sgtr gr ggSgUgSgggSgSg`w+9/ `p ;@N< m,yN`p ;@N< m,yN`/ N`XO<-N`/ N̪XO<-N`t/ Nb XO<-N`f/ NXO<-N`X/ NʘXO<-N`J/ NXO<-N`(w,ݝ_| oBhPBhN`.p0 m,yNp$@"@ i"/ NXOJg>* `|JFg GfJg o0(NLlNuN\paQOH'>/2&o,*o(pxЀ yrf m<(:(JGg<(:(p"m,yN0H2+kt4""mN0kr20+kt4 ""mN 0kr20+H/@ "m"/ N p"mN0H2+H"mN 0H2+kt4""mN LhPONuMain/ o0"hg*P`-gp`*UJfp*_NuH#4*o.-:ޭ6S,-"ܭS&mA0"hg` -""*mTnP$*:mFw-DnB*g Ng *"%@& mr2(N2-HҀ%A*`*g+HN'Hp J$PJfz-f>A0"hg2$P`$ *"mnp +JN'J$RJfJfL,NuH6,/(./$*o &o K"M,xN$@Jg *f *g&J` LlNuH6&o*o M"K,xN $U`H +"*nf6 *m, M,xNf M"KN`/ M"K$jN$_$K`$RfLlNuH4,/$./ &o*o/// / a2O$@JfL KJfS r4Ё/</NzNPO$@Jg(A2%H"jf%j %G%F/ / a PO L,Nuw.e44$H?6./T*oP&m|zJk +^rl ` -$+^&-"o+B" -"jr+A" -6$+b&-:o+B: -:jr+A:Jk -&"-"g$tf &-(+^mvf(-&+^l|$->&-:g$x f (-6$+bmtf(-6$+blzJgJf:,&*>pf"Jj D$-l~`4Jo0l*~`&pf Jj D$-6l~ ` Jo6l~+m"&+m:> mp0("m,yN/ a2XOJ@g/ aTXOJRg mRBHh/ aO BRBoH0-"-?@F?ADtgvf m6- @h?CJfUoJ$D?BD`(Yf$$w/BHv6( N~J2-HҀ?AF?BHp0("N~.HE2$hRBv64SBx8Zht4r2/J/A8/"/B,$&"mp(/,,y*/`.0/@H2/>HHx/// aVORo@ m0(o>0/@oDlH^m-g kB/(*/(&/ aO-sf -"+^o$-"o,l H@B@"N|l?@B`m?|B`t?BBAfp0/B"-$HBBB/@0 "+^N|./("m -r$/4&<,yzN,*-f -6"+bo$-:o,l H@B@"N{?@B`m?|B`t?BBApw0?{0/B"-6$HBBB/@0 "+bN{6/&"m -"/4t(<,yzN,*/ NXOpLl$NuH/4*o8&mB0"/<ҭ" kN,0*x +J/@"``܇B0 kFp0XJgHr gSg.Wg4r3g`&+5f kFp{(fBo.?|,Bo*Bo(B/',.T*+J`$kFr"f.r\/'g&Jo(gBo(`t?B(Ro. o.o t?B(`Jo(g:l r\gRR0*@'p}fSo,` p{fRo,Jo,f?|*RlJo*gv*:mz2ګJ`N,RB0`DRR`>RR`8 rNyR,.`RRl6m,:nR` z2ګw1!J`RRR./0"l:m o@ L,Nu,H?6*oX./\ -"Ї&m m2(4(6(AC2(A62(A52("kR/@8A4BBC71g4(0(@CBB,/`JofgVp/C"m,yN m0-"hRAt4"Sm hv6p0(/C<&րU "m$//N*oH$oD g&m fp`D y h$eC, I,yN,Rgx FC8p,yN& mw6<T0/8H2/H,R0(Hl0(H` 2-H;@` m0( ;@2-4(A;B m0(HDlp2HҀ: m0( HDlp2-HҀ;A m0( o0( m&j0+frPAdrP`r20+htBct4`t@Ԃ m(%HH($HH8*؃؀p؀0-H?B,m0-H((#"h(2)6*:*(&;DHHx8M.,t4z:,x8v6HHЃЄЅЂО"/.Ё\r20/,4*ԁ0-Hm0-H$;B$m0* 2-@lH`H";A$m0*4-@lH`H$;B0-&2-@oH`Hw7Y~>";A0-(2-@oH`H";ApLlNu_ %s/%s%s/MainMAINMainlH6,/./*o&ozBo& g gC(,yN:BmBU K,yN&@JgC( KN0+X@;@C(Atp,yN(?@"`@ N*8$@ @JfS C( J,yNʐo"2/&@oH`H"RER?A&oC(Ap,yN2/&@;A"K,yN0LllNu8H;6,/t>/nBo?B(SBf p?@>?@@?|FHoHHxHxHja"0/^r2./ / a~ j"h(p0)(#HHҀp<Ҁ;A('H'H~0/dr20/ft40/@v6.//NV>O Jgb @K<'@~ y(g j"hp0)`p0*H"M,yN0/>w99UH2/@H//HxHxHoX/ NW&O0/(rAo2/Lt42/Nv6r2///NUO $@JgfK<'J y(g"o` i"hp0) `pH"M,yN0/@H2/>H//HxHxHoX/ NVO?|F?|BBoD0/DH"偒偒 KK y(gA"Mr "Q`A"Mr "QrAoV0/BHRoBN&;oL;oN ;oF +k~+k o`M 2(H///Hh/ N^Or+A(*0/DoH"偒偒$'(RoD o Dm(*o` y(gh0-2-4-?@.?A,6/(xDfv`v6;C6/(Dfw:XUp`p0-;@SCfp`p0-;@BHx HxHx/ NX2O'@g'@ BHx HxHx/ NXO'@g'@LBHx HxHx/ NWO'@g'@BHx HxHx/ NWO'@g'@ o(ohGBHx HxHx/ NWO'@g'@$BHx HxHx/ NWhO'@g'@'k$P'k*o`0/.;@0/,;@;B m"h(p0)(#HHҀT($HHT?|D?@B?A$0/DH"偒偒$7$(4/B&78&s8TBRoD?BB o Dm*o00+k@;@&2-@oH`H";A2/$k VA7Aw; lDAA 7Ap y(fRklTkpKA^"Mp"Q2p'@EAH"Jp"Q2p'@ y(f8At"Mp"Q2p'@A"Jp"Q2p'@UklXkp'M'J A'HxA'H*o0A+H$o`J4gN"o4 i:;h(7HH2(HҀ;A(7HH2( H;Am(l*;h;h ` jH0"M$j&hNFL *@;|.+j/*NXO M,yN4'@g*f @,yN>/ N^K U!Kx ]"h2* j,yN"kpNp0*"kN'J'oX%KRA0.NÂA".NxA"K,xN w<,.NXO k!jV k < Gz,yNj`0p%@ph%@/ N_TXO`p%@pd%@` &j'oT gJgJo/.*o &yx0H/////4//4/ ajO$@ Yf f K"o(Na:&@Jgp+ dJ@0;N******/+/+HzHmNaTO`/+HzHmNa>O BB0H//+/w=mHm//4/ aO$@ g mp!@&1|N` m,yNp+@pi+@ LlNuH6*o,xN| mV&h` k,f"K,xN"KN&J$S fBV Mp,yNj,xNvJg M,yN M,yNLlNuH o0"hg*P`"M,xN/ N\XO*K&U fLhNuYOH4*o m/H g>Jg6/ N.a.NBzp mCN`XOJfNEV&m0+jf0+ jf0+jf0+Rg "o i/ "K$o$j&hND~L/ N.aXOB&o -g/ $@ K"mN$_B~H 倐倐 MHhNXxXORGp w>#N5@m/-~NM|B~.NMpB.NVB.NV~B.NVrB.NVfB.NVZB.NVNXOBBSL,XONuYOH6,/0./,*o$/m&m$o(z fEN/ N|./ / N:O $@Jg/ K"jNh$_*o-fBB/ / N?PO/ aXOBNB mg/ $H K"mN$_+J/ aXO+G"B:p+@>+@& J$h+fT o,yN>`DJf k/hpfNN$@`,Jj( m$h` k/hpfN,$@p'@pf'@0|/ "J$H o ,yN _/ N"XO LlXONu H?6*oL&m m$mp0*M6HHw?!mUҀT;A0- Ht4*HHւրZ;C0*"AHHH+6HH?C(6+HÖY;C 0*2+ @4/(B+9HHHU;A ~/H8"y)fUmXm Tm ~0*A2$@6*?B64CX@SA0-m CS@?@0?A4"mp,yN0/42*@UA6/0?B24jƔGv6Rp0?A*?B(/C,l(0/2v6p0r2/AD"$"m /,&/DNp0/0,R0/(r2l$2/6t42/*v6r2 $&"m"Np0*"mN y(gp0/6r2/2t4/4"m&Np0*"mNp0/6,Up0/2*U"m "Np0(T"m w@hdI"N p0*"mNp0/2*W"m "N"m "N `p0/6r2/2t4/4v6/0"mN+6H+7H?@*HH+6HH6+HÖVp0*?A("mN0/*H2/(H?C,H4/2YBH/B@$"m&/@Np+c"mNp0/6Ur2/2,U"m"N0/,T@r2T "m"N A/ "Kp,yЕNP$_p0*2- H/@, "/,N[+@2*t46- H/@, ?A0"N[S+@62/0t4"N\R;@ /,T@;@ $o8"*^,ohAf$&-" H@B@ЂN[r2 -$HBBB /A("*^N[jr2H ("K -r$/4&<,yЕwAzN,L0`,AfH "K -r$&<(,yЕzN,L0 -6"*bH(ofA -:$HBBBԁ "/(NZr2 -6$HBBB /A("*bNZr2H &"K -"/4t(<zN,L0`A"K -r$(zN,Ll NuH6*o gPG kg/.&o(*o$| g gAp$5|NA %H r,yN.g"N%@R",yNN%@V,yN%@Z y h$e*o Jg"-,yN%@f y h%e,xN& "*n$*N(*J,yNvJg"'J k/H$ @"o$,xN ` / NNXO/+"NUXOB"/ NNpXOpLlwEUmNuAmigaGuide (amigaguide.library V34)QUITLINK %sH6B ,xN&@ @K\ MN MN @*h,"hBB/@$/INU.PO$@Jg/ Hx*/ / aOJ@g JN JN/@ @J$fd*o"-R,yN.Jfg +g"N"-fN'@MV'^'^'^ mB/ /-FNPOBB",yN y h"oN8&o k0/H ,xN`p!@$pk!@("H,xN J,xN @Jf/ NSXO`&op'@$pl'@('|*,xN|"KN o gNLlNuH*o / avAl r Max` m",xN/ aTXOJf`wF1( y hN7 m",xN"@Jf/-"NRB"XOpL`Nu/~ g h"p(r. .NuH*H gD m",xN&@Jg2 +*gWg]fp+f'|+` +k&`B LhNuH*H g&m -*f: gv +Rg",yNBR +fg",yNBf/ NKXO`@p-f "M,xN`,p-f$Jg/-NKRXOB y h"MN6LhNu/ *o`aZ Ma @Jf*_NuH./ &o*o| g4 y hN60Jg" @!K!G!o$B"@ M,xN|0LhNuQOH.*H/A| g Jg&m`RXJfd+GpwG(`pL(PONuQOH*H/@ ~ gH-f@&m`RXJf -d*"m/1HzHmNMA r MaO `pL(PONuQOH6&@*H/A~ gfJg` KJfS,T y hN5*$@Jg>/</NIPO%@g*%m"%|+%F"jf m&"J,xN~ LlPONuH*/*o|S` M> ReL `NuH6/<HxNIBPO*@JgA p"Mp6,xNG6"K+IAp|ЀNHx/ aA*&HA "Kp6NE6"J'IA <NHx/ aTA&&HA "Kp6NE6"J'IA <NHx/ aO LlNuwH7fH#*o&ma$+@g\~| y h'e"m"i"i>)<)"k.r2t4///)(/N48OJ@g K"m,yNp`pLhNuH*o mJg,yN/-NHXOBL`Nu op///(a,O pNu PRT: oHxB/(a O pNuQOH?6./8*o4&m m/ /H0N XO g^|zx`@0/>g kRJ0HfJ@f*// aLEjHz/ NMO JJfS ܀RR^m/</NGPO/@(gx`:0/>g kRJfJ@f$// aEjHz,/ NM`.//8NMVOR^m&o,$o(JgUg0`XA"$<,yN(g>"$ 8 HwwI‡ d&N*"N`*B/ NPO'@NRg/ / N.NPOp'@N*Rf0p'@pp'@&kNh0|/ "@$H k,yN$_`Jo>g/ NXO/ NFDXO/ NXOpLlPONu H/4*o0&mB/#~| /4" kN/p(`N kF0Xr@ p gSg p6f+5f kFp{(fBo&Bo$T`Zr"f.r\/#g&Jo&gBo&`t?B&Ro$ o$o&t?B&`Jo&gr\g GR"jRR@#Jl6l $kFp}f/E(` GR/ "jR`j GR j R`T rNJFR(*` GR j RRl(6wJR0m` p2ЫJ/@(` GR j RR(*/(JmjB5xpL, NuH./*o|BBNKPO+@JgHHx4/NL>PO+@Fg("@A: r,xNDHHg/-FNKXOBF/-JNJXOBJ L`Nuclipboard.deviceFORMFTXTCHRSH &o(*o$ KJfS/H"t‚"mFB0?Ag$/R`$//B mFB,Hz/ ap ѯ$Ho$/ aHz/ aHz/ aHo8/ aO(AF"P3|B)"P#K("X#o$,xN8Jog*BGF S1|B( SC!I("[p#@$N8 mF1|B("mFN8HHLhNuH&o owKĺ< AF"P3|B)"P#K("Xp#@$,xN8HHLHNuH*o "mF,xN>/-FNIBF.JNI0BJXOL`NuH?6./4 o0&hBo*|BBHo,HhNPO*JgxK, E,`*Re*o0pcpc //4N2XO, o,CNEJfBpcBo( gpkTgp?@(0/(HHx////` o,CNCJf k,yN` o,ClNCJf k,yN` o,CXNCjJf( y h$ex$k*fl J,yN`^ o,C,NC2Jf( y h$e@$k*g4 J,yN`&p+@ri+At?B*`p+@pi+@p?@*Jo*g k h.,ywMƂ&H/N -LlNuLINKMainALINKBEEPCLOSERXSRXSYSTEMCONSOLECON:0/0/320/50/AmigaGuide/CLOSE/AUTO/WAITstack 40000 %sQUITACTIVATEWINDOWWINDOWTOFRONTWINDOWTOBACKZOOMWINDOWUNZOOMWINDOWH6*o&m$m g, g(Jg"%MA"k,ifHx/ aPO`pLlNuH.|`HFBFHF A  f*hRF g 9g,@ y hF "MN` L`NuNot enough memoryCan't open databaseCan't find nodeCan't open nodeCan't open windowInvalid commandCan't completePortwNǃ closedCan't create portCan't search in search documentCan't set bookmarkCan't load bookmarkCan't open outputKeyword not found in cross-reference tableLoading...Building search document...Text Search: %s_Contents_Index_Help_RetraceBrowse _<Browse _>Find DocumentFind Text_Find_Next_CancelI_gnore Case_Only Whole Words_Scan Database Found no occurrences of: "%s" Found 1 occurrence of: "%s" Found %ld occurrences of: "%s" ProjectPPrint Print As...wO Close WindowQQuitEditBMarkCCopy[Select All]Clear Selected Print SelectedNavigationDFind Document...FFind Text...NFind Next Set BookmarkGGo To BookmarkH" o "y N=Jg @C I"@"i,yN2pLDNuFindNodeMain%s @{"%s" LINK %s %ld} SearchStringH6*oA"y N=(&@JgLE k"Jp,yNDAR"ofr2/ "J  krNJ _/"kpNP$_` AR"ofpLlNu@H?6&ol k*k"MM/H4/I2/f4*&ATC5C@2*ofTA5Al2/TH)%HH6.HÖQ5Cj)$H5A5@)%HH)$HH6.HÖK:2.@)&HHH:3 3 -H=|.-I N,yN4%@g @!kV j < Gz,yNjK U!Jx ]"h2* k,yN"jpNp0+"jN%K%kA%H^A&%HbHj0NRA".NHXO o@"J,xN `p'@ph'@/ N0HXO gJg&j*j K,yN KN>0|/ $H K"otN$_ mC,hff/ HjN:.HjNwU5&0`/ HjN<.HjN2O A/ "j,yЕN2$_pLl@Nu/ *o mCF!IfpKN// aPO*_Nu/ *o mC!If <-NV// aPO*_NuH*o A"y N2^Jg<"@ i0&P g0 KJfS rcHx/// Hz/ NМ.aOpL(NuYOH36$o4 o(*h"M/I "/,$<,yN.g"tvNJk"vN,&mAP"o0N1*@JgZ5/ o,"K$MNV$_JgR/-N.rXO o0 g J$H"HJfS X/</N."PO+@g"@f`/ //4/ N@O *@ gJ'Mv mRL5+G:+FJ+B>/ //,NwVFuPOJg+B:R6////8//,NҘO",yNpLlXONuH'6*oA"y N0JgM\<2< @h<4<h< JAg Jm`g&m K$h/ / /H(NPO -Vop6FN00|/ "@$H k,yN$_/+N.NXO,gbAC$f~z`JGf /*Hz/ N0b./aHO~j*o/ / / NzO Jf> M/ /N./*/ Hz^/ N0./aOJf ,yNR*o/ / NPO/ / NPO&o JgdEJf <JN~|BHBo:Bo8Bo6Bo4Bo2Jg",yN/@H" $<ND(g"tv,yNJk"vN* 'po <'p` *r ځBogr2"y iwY_2p#(fBo>`AEf y"yHiHhN|POYfl y/( N * y.Nr./ y/(/(aO`.r2 y"Hp:)fC IpCN+RJf?B>p0/,*Rr?A8?A g"m`ɳg/<Hx2NPO$@Jg/ //aLlNuH6&o*o g: g m>fB>"K,xN/+N:.N2.&N*.N$XO gA""hg$Pf +HB+H>LlNuH4*oA""hg&P` / BarPO&J$S f+HB+H>L,NuN?N(LN?@paH>6, *I/K( gJg g KJfS"pҀT/</NFPO$@Jg",yN,Hz/ Hz/ NO" $<N*gn&mx"A.$vN"A,$N-gxwaگ7E&փ"$ N"N g0/.2+ @f 6/,2+CghH26+ /@$ "/$N:2/,H6- N;@"Yf02/.H6- N;@2/,H6- N;@0+ H2-H6Hցo0U2-Ak :0+H2-H6-HցoM0V2-Ak<0-&2-@l;@0-(2-@l;@0-*rAgv62-Ho;@0-,rAgr26-Höo;@",yN/ NXO Ll|Nuwin%s.%sQOH>&* |/I gJg g KJfS"pҀ/</N2PO$@Jg|",yN*KHz/ Hz/ NO" $<N(wb+ g4*o m. $"vNYfA$"vNQf|"NJg"N/ NXO0Ld|PONuH!6/@/I,xN*@~ @B o JfS r ЁrRm /</NPPO&@JgvE//Hzx/ NO " t,yN.g."$ NJg +j4"N~+|`""N~`" N.g"N" N./ NXO LlNuENV:%sH*o~`4pЭ g:~` p0B3RG -<@e -<7@E J,xN M"KN JNLlNuN3pahH?6/*ox M,yN&@JgC,N:C, KNC,ApN?@(2+tBdt`t4RBz$o?B*`r *Nՠ%@5E @JfS C, j,yNP@5@p0/(r2/*t4v6///// /*/ HoHa4O 0wdzjo(*$R f"K,yNx0LlhNumQOH'4:/B>/:*o,"&o0 gBo"`Bk7o"7F B+ +&N$@+ gR?|R A*'H02/FA|1|1|!o4C!I Bt gA?|V `'Mp7@ r?A 7o 0+ o"&S ffp0&o0// //0aFO rE444YB44BZE BBB?@` 0/7@&S fL,PONuYOH6>/.*o$|$o(`* gGG`$R f$o(`L* g2&j k JfS/H @"M /,yN2+@G*Fdp0`p0,$R f0LlXONuH*op8rHA,xwe}%MVN:&@Jg(pM >/:pRЀrHA,xN:*@JgG0C22242v6C("v?A&"SCHHH2/&H" $ K",yNzA<"HN:A+H@p0rЁr2N?@$Hr2N+@"<,xN:+@ g4(Bo2`0/2H"4/$&ւ'Ro2p02/2Hm`"MpRЀ,xN. LhNuH*o g" - g"@ -,xN."MpRЀ,xN.L`Nu H?8/J:/F/>&o8*o4Bo.`0H"M,yN0/.H2HҀ0+H/@( "M"/(N0/.H2HҀ0/.H4+wgQSH6+HւS ""MN 0H"MN0/.H2+H4HԁS0/.H2+HҀ "MN0/.H2+H4HԁS0+H2+HҀS "MN Ro.0/.Gm0Bo.`0H"M,yN0H2/.H4+Hԁ""MN0/.H2+H4HԁU0/.H2+HҀ "MN 0H"MN0/.H2HҀR0/.H4+H6+HւS ""MN0+H2HҀS0/.H4+H6+HւS ""MN Ro.0/.Fm4Lh Nu H? o8*o4 g gG0246(?@(0/>H?A&"M,yN?B$H0/(HЂ.S2/&H"MN U2/&H"MN 0/$HJjRwh-KG(2HҀ, S6H2/&H҃*S&"M"N (U"M "N W2/&H"MN W"M"N0/(H2/*HjR4/&Hԁ"M"N 0/(HR"M"N "M "N "M /,"N 0/(HT"M"N Lh NuYOH:/./&*o xBo0H dP@0;N((22<<DDDDD</&&o *o0+?@H d@0;N::\\||0H2H/// / ajOwi_$`0/S@H2H4H//// / a`0/W@H2H4H//// / a`^0/[@H2H4H//// / a`>0/_@H2H4H//// / a,`poH2H4H//// / a OL(XONu H4/.0H*0HRH"ҁN(/<HxNPO&@/@ g/</NPO*@/@g/</NPO$@JgpC"""&MBo&0H*S` K+H *HRo&0/&Hm*o CB0"&o"`CB0H"ҁҁ"&k f `/ N.XO/ N&XOpL, NuH4:/2/**o$C22 o 0(B-&m0HJgSwjMXgSgSg `$E@;|`E``E`ExH Ѐ7RDp@m m "h p@@0H2H//Hx///0aOL,NuH42/0/&o*o$k HH//B/ / a0-@@OL,NuH?6:/>/6&o0*o, k "k,hB(B+$k JGf0-@0-` 0-@0-@0U@K:B]B]KB]B]2SA:t:6UC:::K::8SD:::B]K ::::LlNuYOH74:/:/2 o,*h &m $k 0U@2YA?@"?A JGfV01m4H6H//B///8a0T@460-R@5@7@0/4H2/6H./Hx/ //Ha`T0wkdy1m0H2H//Hx///8a0T@460-R@5@7@0/4H2/6H./B/ //HaO$L,XONuH6:/2/*&o$*o k "k,hB(B+$k JGf0-@0-` 0-@0-@0S@K:B]B]KB]B]2UA:KB]2SA:::::LlNu/ *o g/- N.N.NXO *_NuQOH76>/B|*o0 gz&o< gp KJfS r2*t1ڂ/</?@,NxPO/@&g@ @!E(+@!K 2B(!o4E*@,Jt,Q!J%o8K,!M 4/$v6"@M-%N `,r_gR` j R o&,yN5@JfB*owlt0&o&-g0 K,yNrЁD7@jp o40(2- Hj`Z-g^-g m0(P@7@` K,yN2-HjR7A0+jp o40(2- HjR5A7AJf| HHNrLlPONu o gJg /(N8XONuH3/0@2A@0H@4JB@0H@6KC@ ЀЃ&փւփҁH҃HҀ0LNu/>/ p0B/aPO.NuH7*o&o kXp(rpM/00Hm.H ЀSG O820;Ag~H ЀRG O820;AgH Ѐ O8JpfRG H"ҁ O840;B |~?@"`JH ЀA00r20/"H$Ԃ00(t4//aPOFo<H Ѐ O820;A RGo2mBo6`Ro60/6H"ҁ O8Jpf|~`NH ЀA00r20/6H$Ԃ00(t4//a8POFoH"ҁG823tBg<;ARGo2m;mwnʣw:LhNuH"/*/X ,xN:*@Jg* L` Nu/ o gY"H ,xN.,_NuH*o &U`6 Jg4SgSgSg ` K&h`"+R`P` A* ` fƑ* L(NuYOH./*o/M ` gHo aXO&@Jf L(XONu/,/ / o//aPOJg @ (` ,NuYOH./*o /o`/ B/aO ,Jg` F΀HoaXO&@Jf L(XONuYOH4./ *o/o`*/ /a$H&Iag0,j jN(H Kaf$I$ L rNpPJg`p JL| NuLL H?>O$H&I*@&AX"Oa$ Ja@gL,jp n@ jN(H KaFf.$I$ L N( L"M ag L"@ Np`p`p O/a O L|NuH00twsCDvN"H LaX$@g6C0*" .WfÉ& L a4$@gANjgt(`tJg L"JaF L"Ca@"J" L NuH@PRNLg/B1@|B0PN _@ Nu" gp)f 0)PRNNu/ &j#JLHH&_Nu"h"iLHNurexxsyslib.libraryX$*RLFN<H60B*d|??dv?@BH3RB?? 3? 3?N3 t`wt\hdx|TXlpe͔2˼,$ xZt^6P~0xzj0 R@d<H>l,Z<nh .rwuX t,xfV Z"v>pHzL L68$b2~l}}n}6}|`{wvqnnvl@k|jjdvok jgggggTgBdzyxuufrrrrnq,ppnoohddnnnnkkiYYwv`__(_^^]0\`\ WWR^R`Q&JINQPPLII:GGtD>>=???j?2>>:9R9987>X>,===P<<;:D:497064-++|+`+@+*)r)F'/((b'F$$>z Lz$ pZD Rp@ b  r b Htwwb(fXJ8`( xL^F.&?$> 6>FRf z>-<>{}[]()@ .,!?:;" AAAAAACEEEEIIIIDNOOOOOUUUUYaaaaaaceeeeiiiidnooooouuuuy    wx&6UUUU  $ TP |  , H J H , H X H wy( H r H    4T`   4  , H J H < H wzӲTh H ( H r H ~?2RRRzRw{>VRtRR RR8w|6\R`R|RR w}$,d$e6fJgZhji|jklmnopq@Lhx,-6789:;J K*LHjrz$4F w~2T C C 0: \H  WH  F  F  w^ x p h ` X P H @ 8 0 (    x p h ` X P H @ 8 0 (  T  &l.6~xtpjfb\XTNJF<82.*$ " \ 0  h<w&r`F4X,|P$>*@F???~???@(( X4x< X4((@??" \ 0  h<+'~Extra_Utilitiespwis'Ec+p&%$#"!      Qoml93CH~$H$I,x/H&n"+g A"(4`":t <d",Ёt&A"<N:JfL` @$@"@ < Sf g I $IS`(I)|`L)NHJLHPg& Ь.@ ,/@Ѭ`")A$BLp"<0N&nChpN)@fpd`)kDJg~ k"h r)ITЁ^@)@\H@@"<N:LJfp/g @)@X Sԁ SQ S"  Q"/`JA\NA\N)@L/$@ *$g,l @"(N(()@D"N lL/Hl h$)hTN2N>Bp` /.lP/ ,X p l pC/N )@ pp/@p`jp l tC/N )@ tp/@p`Pp l xC/N )@ xp/@p`6Sf p*//f|`&Jf"p l |C/N p)@ |`p)@ D`p)@A/N]'L(Rf&B ` <A N*@./pJg*J Pg / HzN/"POpr M"l `N MN`Jf AC NJ PgJ |fJg HzN.XOJg(&ld`J Pg/+HzN.PO KN(&S f`f$l |`\ jNAl&p` j"kN0Jg K&h f fAx"jN`J Pg/*HzHN.ZPO KN($R fJ PgJ |fJg Hz N-XOJ PgJ xg Hz N-XO$l x`` jN Al&p` j"kfJfg K&h f fA"jN`J Pg/+HzN-POp'@.$R fJ PgJ xg HzN-fXO&l t`N < kN*@Jg,J Pg/+Hz2N-pPO?f0pr M"l `NL MN` A|"kNF&S f&l p`N < kNt*@Jg,J Pg/+HzN-POp" M"l `N MN` A$"kN&S fJ Pg HzN,XO , `g @Nh g MN^)M `Jg, <A N)@ `f ACN l `N"&ld`J.f +Ѭ h , h do".А d , dm l `N" l `N" KN g m"k N.HJg> g MN < k N`*@Jf At"k NJ Pg/+ HzzN+PO/, ` K"MN#XO&S fX g MNn l `N"R , `g @NZB `A ",lNA "A $NJ Pg Hz~N+ZXOJ DgJ[ Pg HzN+BXO&ld`R*lh f)Kh`6` m"kN-dJn $M*j f f 'lh)Kh`'M%KJ Lg KN&S fJ Pg HzN*XO*lh g HzN*XO`J.f MN*m fJ Lg"*l l gHzN*XO` MN*m fpN=LlPNuH4,.*H m gJf  Ma8+@ mazAl$p`t j"mN,vJf^JgA"mNd`VJ.fF SfJgp%@.`2A"mL,N8JgA"mN&`RAt"mN`D&J$k f f maAl!`'M+JJdf)MdJ g l )M L,NuDuplicate module in library: /Duplicate or conflicting action for module:Add- Module is already in library:Duplicate symbol definition:%s File not found: Unnamed module encountered in library %s containing the following symbols: Enter new module name: YOH4/H o *h&`@&m*`4 ka$@Jf ka$@J gA,"kN `%o &S f*U fL,XONuYOH4*H/m& `P$k"`> jaT&@Jf ja&@ k g"hg*pN 2 @ '@!M$R f o /P &o fL,XONuH*HaAl&p` M"kf Jff `C@Np MC8NYg A"CN"/8/A8p" MNd* /8r MNVp MCCN < Kap$R fN oa`$ Mar MN`. *g ACNp" KN%@ / Ka Ma/@ Ka "//A *g ACNt / M"Ka` / Ka Ma^/@ Ka'i"//A *gAdCN*`Jg Ma$r MN`j / Kaz Ma. Kal  M"Ka6`B / KaR Ma. KaDJg$ X M"Ka`Jg / Ka Ma.fJgp Ka`,HFHrF́ Jg0Sg,Sg(Sg$Sg r}g0Sg,Sg(Sg$Sg SgSg`b Xr MN`  Ka  M"KabpAЀf Ma Kax Ma. Kaj  M"Ka4`>ADCFN`.A4CRN` L,PONuH4*H/H < m N&@Jf A."m NHz6A!"mNHo!AgC |N <AgVHNPO$@Jf AC_NJ -r KN, < Ja m JfS.,ŕgp, І Ja  J"mN  JCNt/m&`` m gPJgLp} JaH m JfS,.r΁gp. Ї Ja  J"mN  JCN~|`^p KCNrYf / g f o hCNJ /m l@0;N8jjjjB"jjj f A.CN|` Ka* N*@"@  KN"o i g "H MNJg ACN MN`| -g ACNp" JNr+@ / Jدa Kaz/@ Ja"//A -g ACNH - K"Ja` -g A\ClN" / Ja Ka/@ Ja"//A -gA"CBN` / JaR Ka* JaD  K"Ja` / Ja* Ka* JaJgv X K"Ja`JfJ&g < Ja` ACZNh Kal.g*HEHrFʁ Jg0Sg,Sg(Sg$Sg r}g0Sg,Sg(Sg$Sg SgSg`b Xr KN`  Jar  K"Ja6pAЀf Ka JaL Ka. Ja>  K"Ja`PACN`@*m*`Z m JfS}M*.r΁gp. Ї"-HABA၀ Ja  J"mN  JCN - Ja*U f~p Ja` ACN**oJfJfJ*gx < Ja*m*`Z m JfS,.r΁gp. Ї"-HABA၀ JaD  J"mND  JCN8 - Ja"*U fp Ja < Ja o/P*o f KN JNL,NuYOA.g yNXONuYOA.g yNXONuH*o MJfS.` A N|JfA N L NuH~K,`p%/f o(R(r@pdg:p gWg[g`D&]`4,Gz rTr+AxSSJjB/` ANG/ NHXOހ`"Rp/A N`Rp/A N o(R(@fXA N L(Nu0123456789ABCDEFH*l`&UpЭ"M,xN.*K fB`$pЬ$ l)h)h$"@ ( ,xN.JfLhNu o"o/o QOH*H/IN&@gp+r/gr g r"g K"oNL(PONu o"o/o  H4*I$H/H` p/ r.g Sgr-g`&JS`@ f f&JS"oJfB` A.fL, Nu o"opr am zn am zn fB8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 , @f )i` hf!i ),xN.LL2V nn&,g"Cn2",Ȳ f(EJRkB8*D匰oB8*kEH`&)gf"C`GBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*j ,(",,xN:Jf )| `"@E#l)I#D#l &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu /H.*l` mN*U fKpUf -g"- mAN'#: M*P f L Nz / oYOH.*H|@rAҁ­f p`=<;:9876543210/.-,+*)(sc5p')*""H~$H$I,x/H&n"+g A"(4`":t <\d",\Ёt&A"<N:JfL` @$@"@ < Sf g I $IS`(I)|L)NJLHg& Ь\.@ ,\/@Ѭ")ABp"<0N&nClpN)@fpd`)kJg k"h r)IЁ^@)@H@@"<N:LJf </g @)@ Sԁ SQ S"  Q"/`JA\NA\N)@/$@ *$g,l @"('*N)@"N l/Hl h$)hNjN*p` /.l/ ,g @NNj NoJg ,l",gN,xN|"lN`,x ,g"lN."lNb ,"LN. L~Nudos.libraryH?6rB/AB/@, MtK,*/I(B/A?AB/H4G&&&&*/I, "<,xN,lN)@N)@Ar"$<N)@ l|NMBBBM BBBM#BBpBM(BK0BBB,6Bp)@`6lT`.)|`$pd)@`*HHB*A8"Ja$t @RJfd` t lg '-Cfkr0mpr6lj7HHJg r0g JSgSg&SgSg:Sg*` 2p(l` (mzp0l{` mzp0l` pA CN4` _` $l <x)@x`HHAm0g HHr Ё`HHr8gr,g <x)@x`$ <x )@x` A"Ja"RJf <x f <x g Ar"Ja" <x'.mf^)@x` z$l`>HHAm0g HHr Ё`HHraf\` AV"Ja"&RJf` .$l`^HHAm0g HHr Ё`HHrbg SgSg`)|`)|`)|` AV"Ja!RJf`)l " \` m l| (ANBpNW&l KJfS( rlFm*/ /,HzHoN` l| (ANBLO`LJop/3Hg p:3Hg~`~ ,"ҁҀE ЇN&%@Jo> ,"ҁҀ C"q`SdUf ,"ҁҀA pR/H ,"ҁҀA pBR`&lJfA"Ka `'/uwuz`HH"҅ҁҀ*p0HHAm$Hfr*fbR?|refR|p@`0rigJfJgRp@@`rwfR|B/pA CN0`g HHr Ё`HHJg(ragYg\Ygrg`l_R`Rp@@ ?@pA CN0|B/ ?@pA CN0x`j|B/ ?@pA CN0X||pA CN0>R`.|B/ ?@pA CN0R` RA"KaJfx` ,gF @"JfS( l JfS ЈRN$$@Jg l"Jf J"lNt)J`)lJ,g'0{9|;`|@`$l`HHr0g\Sg`SgnSg|rgJUgr g]gSgpSgtYgr g"Ug|r gfYgUgdSgHSgLYgh`vpp`v ,p@@)@p`d ,p@@)@p`R ,p@@)@p`@m`8m`0m`(m` m` r`q`ArN@RJf`$lJgPz`HH"҅ҁҀ*p0HHAm0fpmpdoA0"laF`T)E`Lp)@`B|:`8R/Ao`* lCaJfB/B`)l N`/l` lJfT$H`NHHreg.WgQgUgSg(`' 1l]`$lX` `X` @X` @XRJf`&lR lJfp)@)@`xz`HH"҅ҁҀ*p0HHAm$Hfg HHr Ё`HHJgregrg `R)E`R)E`RA"KazJgJj` lrrgrbf` Jf$H`^HHr0gSgr1g2rgSg `.`2`*zZ`z`ly` A"la`RJf`h/l`^*lfAvM,Ar,Ar,``E JJfS RN &@ J"@frcf)K`rd' 2mKӰf)K`)K` lHHJgr=gdr%gSg"rg`A/H0`A/H0` l(rrf A/H0`vrnf A/H0`dA/H0`X lRB/?/H0`FX`<lm`2p)@`$)|`lm`x$lR`HH"҄ҁҀ(p0HHAm0f l 9| b` l 9| b` l 9| b` l 9| b`9| b` lrdf r(A d`prnfC INrrᡃ `V|=`NB/>`HHz/,$Hz/,a/SHH./HzHoNXb l| (AN:pNOOJ,f' 3$ACad)@f(/0*o4 /,o* up/gHoCHo0  MC BaPO)@fJ/>gHz /,$Hz/,aOl,Tg\,]g$ , Ngr* @g)@ "A )H N`A)H "G(~*/0`d"/,p@A8"uNdl(SA8C fJfgFA8"Hp.)f.EHHCm1g HHr Ё`HHrcgCNm A8Ca8JfPA8"HJfS ^NX$@Jf l| (AhN8pNMR J&&HBB*AC8f`pA ~C8N]Jg."/,/5Hz4HoNV l| (AN80O `LA8"HJfS( `E8r/' 4agr:fB*`SJjJkA8C Nl(` A C8fA8"HJfS ^Nx$@Jf l| (A N7pNLR J&&HBB*AC8f`A8"HJfS( `E8r/gr:fB*`SJjJkA8C Nk` A C8fA8"HJfS ^N$@Jf l| (A N7 pNL R J&&HBB*AC8fA ~N]FJgXR, /,m/G(f l| (A N6pNKC p,xN)@g,@pN"N,xNb*o,J/@gF&o(~`6E JNb4(Hz / A@"MaA@NbPOlR K&P f/G$$o(*/(`*fA' 5U)H"H l Nab)@,]g,Jg @Jgr*"@g)@ "`A )H "A n)HB/BJl bfp9@ b0, bH lCN)Jg A N7`DC p,xN)@g(,@AP"l|N."N,xNbB l|B` A N7^~ ,]fJfNJ/AgDJ/Bg>C p,xN)@g,@AP"l|N"N,xNbB`A N7NX, g@ l| (A N4C p,xN)@g,@AP"l|N"N,xNbB ,g"@,xNb l|BBJfDJ/Bg>C p,xN)@g ,@AP"l|N."N,xNbB` A xN6T~ NJRJ/gH g / Hz HoNO l| (AN1V` Ho8Hz nHoNO l| (AN14O AD"$<,lN(f*HoDHzHoNOV l| (AN0pNF O A )H v"o0J/?gHz/ /ADNETO `M8fHo8Hz/a 6O &o(`Jp* o((fHz/ A@Ca D`HzHkA@Ca .POHo'88Hz/a O &S fp* o((fB/ A@Ca `BHhA@Ca PO g/ Hz\/a `Ho8HzL/a O lCHa DJg @HhHz8/a hO &l./4`(HHram l@0;N.gE`.gE`"gE` r"ҁҀҁA$HHz/ /, vADNCHoDHzz/a O`pHzHz/, vADNCHoDHzP/a O`F`@ `: `4`.`(`"```` `G Rr+gJfŕ"ҁ҆ҁA&Hz/'9$p~/, vADNCHoDHz:/aHzHz0/, vA\NBHo\Hz&/aO0g Hz /aPO g Hz/aPO g Hz/aPOg Hz/aPOg Hz/apPOg Hz/a^PO l h$d Hz/aFPO rgp* o((f/ / A@CaRPO`C/ Hoolg Sgr-g`&JS`@ f f&JS"oJfB` A.fL,PONuH4&I*H`$K` f `RJfRJfpL,NuHL(`H&I*H`THHAm0g HHr `HH.HH0g HHr `HH"g `RRJgJfpL(NuQOH14.$o(*o$/H/I mp`x "&pt-g v/gp`\R+gfp`L*I`:f0J+f0*o$"l&" o$pt-gt/g R ` RJfA L,PONuH36&H/H C%fA%"t,lN.f$pAC%QC)fA%"N.Jg "A'?v$$NJf|@`,/"N,xN&@ @$hr!AA%"$<,lN.g. RNGf*@Jg"$ &NJoB5`B",lN'J LlNuYOH!&H/H ,rf |p`VJf*Aa)@ g @Jfp)@|p`*R , l *H5gt gt gp ",0gԛp" l ",0fDp-0fTK`R&l gr"fJgB`p)@`p- l ",0f`R ,.T`R , l 0gt gt g p ",0f l ,J0g RB0`r)A*H`$ l ,J0g l| (AN!,'@1T#p)@ gB,`| L(XONuPH&I*HAC"BA"MNU,A"HJfS rO "KNU*B/WAN"L(PNuH&I*HJfS. 5r:gr/fdCf KJfS,`3hr:g r/gSJjAR"KHzza8A"HJfS RNXO*@A"@f L(NuNNX4H 6&oL ,"K`Rr gr gr ggR$MXr"fXR K$$H`<r*f2RHHr0grg r g `B`T` `R`r"gJfRB`"$`Rgr g r gr fJgB m'AXT ,f l`AC(/IC8/I(B8C)I()HJfhAC""""2"l i$/Hp(A"o"iNSA"$<,lN/@ /@0/@@&@,xN @!k`8,lN/@ N/@0A"$<N/@@fA"N/@@B$B4BD/|/|,/| f M'GS"jf Jffp`$R fpGNI$@Jgn0<r JQ g" $<,lN`,lN%@Jg.$'J%M&kp" g /6/@'o'o> p` JNGp`pLl4NuH (g &h!SJg "+,lN KNGLHNuQOH76/H( o(*h~| fp` -rgtJfJf -o p+@`Vp+@JgJEgpFo*HzHlN1FPO/-HzHlN14O ~F`  K"J`Sd&JN MEpF&"-$ ,lN+@/@$+JJ$f p+@` fz`. mHHr gSgrgUf|zRS' HC1{(`zJgJgJgl&m`fJg"$mr"g\r gTr gLf8`F$mr"f|`&HHA0f$r gr gJgRSRJfJg gB3x -oRS LlPONuYO/ *H -gC Y/H+QBS /`8Jg Ma/@g /` roCS QX"/H o `p*_XONu/ *H+I o+HRJgR*_Nu"Hp #@d#|

<,/I - eFN&@"- @0<rQ"- m"K`Sd+K &mJf"p@Nd&  m0<r"PQ m"phJf o"p` L(PONuH.䈰 d &hJg&SJg `pLNuYOH#6*H IJfS./I $M`Sd&Mpq+fpx`pq@B5x|" $<,lNJg "Np`@N|reҁf2.x r N=rr0Ёx r N=bp0ҀxB5xRpdmpLlXONuH&I*H,xN| grN(.rN(, g"<N(*"<N((Nv g c ` & '#KK_gކ*LhNupH#.*H/IpN&@rt @Qp@N'@2< @Q'| A"Ma Sm( l @0;N |`|` |`p'@| rA"KNXJgSgSgrg`A8N ``A>N TA"HJfS, Prlo|d"H A#N?pAC.N? O#B0hAN ACN6,,lN|ANH܀ OB0hAN `AN [gp@ kNp KNp`"&`[gp'@ SCN\ o pLhpNuYOH *H/I pN:&@r"@Qp@N&'@2<t @Q'|  o '$Lt%Q L(XONuYOH*H g-gp+@ UCBNB~``|z`< U((CHHSN m"px qXHHN m"px#XRX l m"px&Q fRX / d mJxf U+h` U (jRN&pL(XONuH*H g-f g @p N~|`H-g,zx` PHHNRX l m phJf mp@ PNRX d mJhf - mNp MNL Nu H'6,.*H,l| n/I g!G,z g pgz&I g pg$o0 g pg l(gHH"ҁCL'%MU01HVN&@HH$ԂAL20(HV @M/@( A("la$@Jg RHHN$A"Ma` @"o aV @"o0aL`n ( PN<"l/i( A(aJg l"@"F%E&p l PC%N` l"Ma0 l"Ka& l"Ja"l Q#hpLl NuYOH4,.&I*H l|$h g pBl%F g*\f  la$@Jfp`z g pgz g pgJ gp o g l(g* RFCE I"Ma2 @"Ka* @"o a `F  PN"l QJf2FEpCNR l"Ma" l"Ka l"o a p'&N8YBL,XONu$H./A"l| i g(\gp`  la*@ l(gL g U|A UB(`0,ZHVN*@/@( A("la0,ZHVCpAB`|AB/ arJg @  l PNp l PCNj`j l ( PNp l PCNJ/| lCa lCa lCa"l/i( A(a."l Q#hpL $NuH,*x` ra؀Rm LpNuH 4*o(/H$I/I la&@Jgv l(g Sp("tF‚"o"CpAgnG@" gg K"JaJ&@`r%A g/''O*g K"Ma*&@`p+@$o, g/g K"Ja`p%@` gp%@ gp+@&o, gp'@`  PN~p l PC"Np/"rF o &o,rAg\ g/#g l"Ja`p%@ g/#g l"Ma`p+@ g:/#g l"Ka`&p'@` gp%@ gp+@ gp'@pL,NuH* (@//// aH(EPOL NuH* (@// "/aj(EXOL NuH* (@// "/a(EXOL NuH* (@ "/ a(EL NuH* (@ "/ a(EL NuH, (@aB(FL@NuH, (@aR(FL@NuH* (@ a'(Pb:x(EL NuH, (@aZ(FL@NuH#6*Hp[N8&@pANF$@p: MN6PJf^B" t,lN.`F"$ ,lN"N.,"N.JgJg KC0H  JCN&@Ag  JNR L,DNuNH "$<,lNL@NuH*HJ|g, l|&h g kn>(Hpo[f~@` ~@`~@  MC NtL(NuH7.*HJfS,`SFJFg 0Hr 5gJFg0Hr5fp`p*JFg&0H&"$ ,lN2Hg AaaJg"A$v,lNL`NuH.*HJfS,`SFJFg 0Hr 5gJFg0Hr5fp`p*JFg0H G"MNJg A>aa@Jg p GCJNpL NuYOH0/A "A$v,lNSg AaaL'*R6hp~@ XONuYO/./Ap GCN Jg Aaa.XONu/",lN,_Nu @NDH0&"$ ,lNаg AafaL@ NuH7,.*H&S" $,lN*Rf Aa4a` Jg Sg Sg ` ` Ї`" t&,lNL`NuH*H,lN ML``/ *H"l| i ( M*_`fARapNH* (@ a(EL NuH* (@ a6(EL NuH* (@ a(EL NuH /( (@HHAa(DL0NuH, (@a(FL@NuH ,(@"l| i g*hn g NRL0@NuH* (@ a|(EL NuH /( (@HHAa(DL0NuH, (@'+S~a(FL@NuH, (@at(FL@NuH, (@a\(FL@NuYOH, (@/IaZ(FL@XONuH, (@a (FL@NuH*H, (@zG`RPplJfplA!X!X(FL8`NuH*H, (@zG`RPpl Sfpl ABX(FL8`NuNuH*H L+H,lNM,+l+lA@,A,A,A,A,A,A,A,A,A,A+HA+HA.,AH,Ab,A|,AML,A,A,A,A,A ,A ,A ,A ,A ,A ,A ,A .,AC"A+HA+HAJ,A"A"A&',TK+HAFM,AR,Ab,A|,A+HAM,A,A.,L`NuHp"<,xN. gA4apNg A*aNܲL@NuT/"AzCp"Q2BA"HJfS, N܀AC\f"l| i/H )")A"oN"l| i/H )r oN,TNuFATAL: Can't allocate bytes! YO/ *HJfS R/N`Sd *_XONuH**H|/N FR r N*Rp0Ҁ"O  r N*:*n*` OhSl L `NuH**H|/N FR r N*,p0Ҁ"O  r N**p'-U-uBb*` OhSl L `NuYOH&I*H-/f Kah Uab-/g$p Ma"l| i/H )"< n oNL(XONuVIO: Seek Error:Write Error:Read Error:X/ *HJfS rPb ACNC MNxAN:*_XNuH1.*H - g6"-$v,lN"-Ng MCja+C ` B0+G L`NuH0*H -"- g Ma"-$-&-(,lNа(g MC$ap+@` -(ѭ -(L` NuYOH1*H -"- g MaF"-0/A"-$- Ap /&0,lN.n MCaTp+@`߭ L`XONu'.V/cH'6,.&I*HB" $<,lN*fp`Xp6N$@r5t @Q MJfS RNۦ$Jn~X Nۖ%@%@ %GB*4%E"Rf%F,& LlNuH.*H gNf Ma"-,lN - mNHg UN#n U JfS R UN&p6 MNL`NuH!.*H gX",tl.$-oD @aHB$B(B-4+m,xN| - mN Nھ&@Nv+K+K +GpLhNuH*H-4g*J(g& Ma. -(ѭB$B(+m B-4`~ L NuH!.*H+@"-n$-$ԁn m+H `*-4g MaRfp`C"B$B(+Y B-4 '/W³7L NuYOH4.*H4&m , /I(o+F($Ipn\ ЇlR Sm2 l*@0;N" (o+A(+K ߭`^*`Vm MaRfp`VJg4 -l ( JG "S`Sd٭ٓ,(o+F(ĚJf -($o+@$ L,XONuQOH/4*H&m " $-$.,$I/@ /I$pnHoD Sm2 l*@0;Nݭ+K `z(`Jnpۭz"-0 -$Apаo.-4g MaG&+[ Ma.Rfp``+G$` Ma.Rfp`J߭'0X$ -0rlR0 m , m "J`Sd$Jݭ *چ.m^ۭ / L,PONuYOH*H/@ -(Xo Ma4&m -/g / r@ҁd~` @d / @~`` dB@H@Cp"/  / ~`:B@H@CpG "BAHA" ~`C A~߭ ߭߭( -($o+@$ L(XONuQOH!*H - "$-$rm&@-/fCAXX `4f~`f~` f~`.߭߭ f p/@`fpt?K**p+ѝ`f.pK'1YXxtG&&pѓ /@pѯ`pKrC""pё C"pё /@p+ѯ`b-/fp MCa`Lp MCaG/f~`/f~`/f~`~Jg  MCat` /L(PONuH* (@ "/ ab(EL NuH* (@ a(EL NuH, (@a(FL@NuH* (@ a(EL NuH* (@ a(EL NuH* (@ a(EL NuH* (@ a(EL NuH, (@a(FL@NuQOH6*HA$+HAM$,CT,,"m +i$8$mG +K<+R@/I"H o h,xN| LlPONu'2Z'MؒSC_IOH66,&I*HzpvN8$@rut @Qpwf*p++fz" $<,lN%@ f" $<`" $<,lN%@ * gJg"tv,lN * %@ *pڀ NӶ%@ NӬM,pr ^Qp RQrrWDH j"R" |\A"%H^B*bpxf,xNHH)@x ,xrg.@cRԓ,xN%@dAhN(J*gpR Jal` pv JN LllNuH1*H~ gJ- g"B- GT` K,xN K,xNJgJ-f UJg"- C $ &(,lN- HH"- ,lN mpАNҔ UpАNҊSn ,x,xNp)@'3[zxpv MNj LhNuH6.&I*H$UJ-fJ- gvp`Jg JC  K`SdƞJ- g6ET` J,xN J,xNJgB- -0@g | p`@$m+U*BpW Ma,m JC `Sdߪ- HHLlNuHH4*oh$od/H/I"Hp?AN!B/[A"HJfS. &o gB&o` gB gB gB,`4A&HHHr.g Sgr g` gAfB`V,`R SJn`HA&HHHr/g"r f. g A"JfR OB0h` g A"JfB` SJn&o`JjD gTAf`JA$HHHr:f" g'4\AfB*"o gAf` SJn gAfL,HNusc:libs/scspill.libraryYOH4*H&M/I g KN"&@g p:+gB$o g0 K"JN$@g *HHr/gr g r"g/B&J$o g K"JN&@"o g A.NL,XONuH. L, ,g @NzKJg&UBLN(FRPpma l| (g @p N l|B ,g"@,xNbB ,g"@,xNb)H ,g"@,xNbBCp,xN)@g,@pN"N,xNbB ,g ",lN NLxNu/ *l g lN ,g g @N|)H)H'5]ğ_*_Nu o"o/o /oLH?4*ox/H0&IB/?B/>B/=B/<| ;Bdp/@`B/:B\zEH(B@/I4`Jp o0r g"Wg&QgUgWg"`2|?`|>`|=`|<`|0;R0 o0Jfp/?f| ;r* o0f"SX"/AdlDd@?R0` CdNѯ0 o0r.fBR0p* o0f SX /@`lp/@`R0`C`N,fB``ݯ0| ;p o0rLgrgYg `|:`|:R0 o0R"o0r@$/H*pEgUgp g&Qg4p gSg^SgSgSgUgH[g"SgSgWg~UgWg'6^bd`p/:f SX"P 2` SX"P"` SX,Jjp/@\DJ\g EI|-H`"J/>g EI|+H`J/=g EI| Hz  JNZ. /`fJg /`Jjr/A`,/`Jo J "JNr0 J`Sd./`ڇ Sf /;fJ`fB` /`Jjp/@`|:p/:f SX |<` SX,/$rug\rofJ/gFr g t+gt-f2Jk./;f` p/; MNSdlp MNS` p/; MNSdl`p MNSl`pf J`fp` p`fp/@` /`rmr`",JgpfRHoHHo`HoL///Nt`HoHHo`HoLB//N\O,pn .o S ㈀gSD Uf /Drm"/`mxPGHzr/=t/>&/\/D&JgzJj r/AD.`,/@Jg"/DJkځt/<&/`gRJgPJfLJfB``8(R,lr/A``&"/`o/F`EG`S` /`gr02g'8` = /`f S`JgS`گ`R`گ`ZJgS`S /DJj"D`",pcoR oR,/@p/<"/`$gRJg2Jf.m S/@``S`S /`g AHp0gJ`fS$otJ/?f /dod` p/; MNRSdlJ\gp-`J/>gp+` J/=g p/; MNJ&g| /DJj:p0 MNp.`RDm Smp`p0 MNS`l` Smp`p0 MN /DSDJjJ`fJ/nf`NaNp$hBJBjS$hB2)H$L NYNXNu BgRB3BHB3BBF4)g\jVBk Bia`Ha.Ri`tiaaSiJkSi`BBBF/gaJFf BfSi`0 RB Bkv$( Jg xiSBk:x Bl281  9o"0 R1 1( SBjRiSCzgR$hG0 g SD6CkS@xQJCk0Q$hBJigS$hB2)H$L NYNXNuSBfNu|H0$&҃тdRL Nu/t?<@ B m RSWfO$NuNPNQH~0pr3@3@3@3@a';cpN 0fi ` -fi` +fa^ 0m> 9n8i 3F <)i/gRi`a2<) ҆Bц` .f JifbRi` Eg efPa +g -f ia 0m0 9n*:)iFi im`?)_ f $hB`4)?)_gDBi/gZ3|?Jk Si`Jig ktiaTaZSi`a|Ri`t4)?)_gHNL$h$$$h$p0)L ~NYNXNu,(g !|NuH$hN<L?3FS fiNu?)_g|Nu$fprt`"HBHBB/'<d>t Q$Nu//grB Jf BB /g2RB/fHC poRd R`SBgBo Bl*J?BBHB_HB&NuH/<N,p`H/<N0<HBBH@B@OLr` /)@pN$H*l`&UpЭ"M,xN.*K fB`$pЬ l)h)h"@ ( ,xN.JfLhNuN^NV o"o /  H"6&I*HB)@ Jf plN.)@Jf plN)@Ho/,Ho@ K"lN lCDN4O J/g lCf辀f ,",貀g ",lNptЀfp`pLhNu o"o / H!*H/@B/I" t,lN.fp)@)|p`D <NF&@$"NJfp)@)|~`"N~ Kp@*Q KN LhNu o"o$H4&I*H~$M`p/r#g$YgrfJWDHRJgp`r@p(g*pg`X M"KaJfRJf` GR @r)fB7x`A"HJfS MCaJf`XRgRr N@,p/N4g`6pN&,pNg p`2p/N ,pNgp`@fJgp` '?g&L,$Nu o"oH&I*H`pN.pNgp`JfpL(Nu o"oH&I*H KJfS. "M MJfS R I"MN `SdL(Nu"o o f SNu / oNU"Or N A0Jf fBN]Nu o"oYOH4&I*H$M`Jp/ r*g$rf$JWDHRJg*p`: M"KaJfRJf`/ VDHJgp`@ fJgp` L,XONu / oNU"O"AA0f fBN]Nu0123456789abcdef / oQO"O2Af fBPONu o"oH0 $Hr & +g -fvRH0m '@h9<n$҂ҁJfҀ`⒀`" SL Nu o"o / H.*H IJfS,m,S  MN B5h RL Nu oH0 (r2N0"< jҐ$邔&僖֨"遒ҀҬ L Nu oH?~"t,lN,fp)@)|p` <N &@Jfp )@pg)@"Np`b"$ NJfp)@)|`8 +r2N"+&郖"+(鄘*ڄ.ޅރހ ? BN<"N LHNu oH *H&M` pA0g rt ҂`rJf L(Nu oH *H&M` pA0g rt `rJf L(NuN 6N . o'AiճH!"t,lN.fTN|)@g&Ug&Sg"[gUgSg"[g]gSgSg`p`p`p` p`p `p)@p` L@Nu / o"/ H#6,.*HNpANx&@Jfpg)@p )@p`po*"$ ,lNzJ@fDN|)@p)@ BNp`"$ ,lNJfN|)@p)@ BNp`po BB `L G"( A+h "(( AE*rPcrP`rCh`SdrAhB0+H +t:+SM<B^B^+k|ANM,,, +B8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 , @f )i` hf!i ),xN.LL2V nn&,g"Cn2", f(EJRkB8*D匰oB8*kEH`&)gf"C`'FnGBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*j ,(",,xN:Jf )| `"@E#l)I#D#l &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu oH7*H~&x fp`,lN,fA~"$<N,~ k$e,/|! NG$&&"&B" A $N*`"" t&N"JfN|)@r)A*`*Jg"N LhNuNIL: oYO/ g$&@`RpA0f KCN /&_XONu o /"/ "o'GoXQOH .*I&HN"*x/H` mRR SR - lJnJo MN& -" KN:؀ "N&L(PONu oH*H gpAЀf, mC"BB- p"-g`JgF - Jjr+A - g("- mAN.Rf` g+mB p0f-gpp`$p` ~KJg MaDJg~*U f L Nu o"o/o /o H&I*H/o`8p%/ f& ofR`/ / CNHPOJg/@` p/ KN o@ /HJfL( Nu o/",lNJfN|)@N)@p`p,_Nu'Hq o XB!HNu /H.Jkpop`F A*H0|"Ug. f Ug Uf K`K`*U N/ "NXOpL Nu / oH.*HJkpo0|`A pxC#x L Nu /"A0gNu //.gRrgmJpzn pA0x`:p6Fm0p Fn pA0x` /m 1l pAU0x`p.NulB,, $VER version 6.00<$VER: SAS/C_Driver 6.0028 (21.7.92)(((<}pwrq''IrA ar~`2A af~`&~`"p/@d`A"HA naV`A n"JavRJf JgA ra(JdgA jaBd~`$l`^HHAU0g HHr Ё`HHrbg SgSg`A $a`A $a`A $a` A $"JaRJf`$l`Rgr=fJg^$l`@HHAU0g HHr Ё`HHrif A aV` A "JaRp=fA"HA aB`A "la2`A "la"`$lJfA "Ja6`x` ALRszlHpdHHAU0fALBr*f>Rpef A a`&rigJf A a`rwfA ~aR`HHAU0g HHr Ё`HHJg4ragYg8Yg$r g[g:`HA 8a:R`HAa.R` lJfAa $l`bHHr0gSgr1g4rgSg `2Ata `4A`a `*Aja x` Aja n`Ala d` An"la RJf`Al"la N` ls }Igrcg rdgrbfp=(gHz@NXO`|$lTpc lްfA6"Ja `^pdfA,"Ja `JA("Ja `< lHHJgr=gxr%gSg*rg`ACa `ACa `pr lް(fACa x`pn(fACa ``ACa P` lR"HAa <`Aa "`Aa `Aa `xAa `n lHHCU1g(E`RHHAU0fBAz"la ,o$`*Ana ` /+HH/,/Hz`N pN'TO A+a @)@f*/ /\o," up/gHo+Ho`  MCaXPO)@s ~#+mJfJ`g gp*g A"Ka <`(Aa $` f A$a `p*g A"Ka  Uf2p mCVfHzNXO`."/\ ua R\ /\ma Jg /HzNPOLlLNu*BSS=CHIPCODE=CHIPDATA=CHIPInvalid -a option: DATA=FARDATA=NEARInvalid -b option: ONERR=CONTINUEANSINMINCOLDPPSTREQCOMNESTIGNORE=77NOERRSRCTRIGRAPHMCCONSSTRMERGEUNSCHARNOWVRETNOEXTDEFSIDLEN=100Unrecognized -c option: NODEBUGDEBUG=LDEBUG=SFDEBUG=SDEBUG=FFDEBUG=FDEFINEERRORREXs `}XMATH=FFPPREC=MIXEDPREC=DOUBLEMATH=STANDARDMATH=IEEEMATH=68881Invalid -f option: LHEADXSYSXMACLMACLNARROWERRORLISTLISTFILEUnrecognized -g option: LISTXREFBSS=FASTCODE=FASTDATA=FASTInvalid -h option: GSTIMMUnknown -H option GSTIDIRInvalid -j option. Warning/error not specifiedERROR=ALLIGNORE=ALLWARN=ALLNOERRHIGHIGNOREERRORWARNUnrecognized -j option: LINKLIBADDSYMSMALLCODESMALLDATAMAPHUNKNOSTDIOMAPLIBMATH=SDEBUGSTRIPs WζMAPOVLYMAPSYMSMALLCODE SMALLDATA VERBOSEVERBOSEMAPXREFMAPMODIFIEDCPU=ANYCPU=68010CPU=68020CPU=68030CPU=68040OPTSIZEOPTTIMELIBCODENOAUTOREGCOMMONAFPInvalid -m option IDLENIDLEN=8OPTIMIZEnil:PNAMEPPONLYGENPROTOGPPARMSNOGPSTATICNOGPEXTNOGPTDEFMAXERR=1 MAXWARN=1MAXERRMAXWARNUnrecognized -q option: CODE=NEARCODE=FARPARMS=REGPARMS=STACKPARMS=BOTHInvalid -r option: OBJLIBInvalid -s option CODENAMEDATANAMEBSSNAMESTARTUPCBACKCRs sESCATCHRESCATCHRESNRCATCHNOSTKCHKSHORTINTNOEXTDEFSAVEDSPPBUFNOVERSION Invalid option "-%c%s"NOOBJNAME MAKEGSTNOOBJNAME MAKEGST=project.gstNOOBJNAMEOBJNAME?USAGE: lctosc [>file] [lc options] %s ENV:SASCOPTSInvalid Options in SASCOPTS, ignoring the rest***%s%s YOH&I*H/N `THHAU0g HHr `HH.HH0g HHr `HH"g `RRJgJfpL(XONuH14.$o4*o0G&&& mp`x "&pt-g v/gp`\R+gfsp`L*I`:f0J+f0*o0"l&" o$pt-gt/g R ` RJfA L,NuH36&H/H /N$C)fA)"t,lN.,o$f(pA`C)QC-fA)",lN.,o$Jg,"A($,lNJ,o$f|@`,/",lN,xN&@ @$hr!AA)"$<,lN.,o$g6 RN*@Jg"$ &,lNJ,o$oB5`B",lN'J LlNu H!&H/H/N ,"rf |p`RJ"f*Ada)@&g @Jfp)@"|p`&R" ," l&*H5gt gt gp ","0gԛp"s9 l&","0fDp-0fT""K`R"&l&"gr"fJgB`p)@"`p- l&","0f`R" ,".T`R" ," l&0gt gt g p ","0f l& ,"J0g R"B0`r)A"*H` l& ,"J0gAHNp)@",o gB,`| Lh NuYO/ /HzD/N NO XONuYOH.*HJfS,",҈T/N ,검o8N&@Jfp`H ,g , l"K`Sd lN>)KJg ,R"lG [fݛpL(XONuYO.p rAQXONuYO ,XONuYO/ p *_X`HH&I/Np a4JssB/=B/<| ;Bdp/@`B/:B\zEH(B@/I4`Jp o0r g"Wg&QgUgWg"`2|?`|>`|=`|<`|0;R0 o0Jfp/?f| ;r* o0f"SX"/AdlDd@?R0` CdN2ѯ0 o0r.fBR0p* o0f SX /@`lp/@`R0`C`N,fB``ݯ0| ;p o0rLgrgYg `|:`|:R0 o0R"o0r@$/H*pEgUgp g&Qg4p gSg^SgSgSgUgH[g"SgSs`"agWg~UgWg`p/:f SX"P 2` SX"P"` SX,Jjp/@\DJ\g EI|-H`"J/>g EI|+H`J/=g EI| Hz  JN . /`fJg /`Jjr/A`,/`Jo J "JNr0 J`Sd./`ڇ Sf /;fJ`fB` /`Jjp/@`|:p/:f SX |<` SX,/$rug\rofJ/gFr g t+gt-f2Jk./;f` p/; MNSdlp MNS` p/; MNSdl`p MNSl`pf J`fp` p`fp/@` /`rmr`",JgpfRHoHHo`HoL///N `HoHHo`HoLB//NO,pn .o S ㈀gSD Uf /Drm"/`mxPGHzr/=t/>&/\/D&JgzJj r/AD.`,/@Jg"/DJkځt/<&/`gRJgPJfLJfB``8(R,lr/A``&"/`o/F`EGsl`S` /`gr02g /`f S`JgS`گ`R`گ`ZJgS`S /DJj"D`",pcoR oR,/@p/<"/`$gRJg2Jf.m S/@``S`S /`g AHp0gJ`fS$otJ/?f /dod` p/; MNRSdlJ\gp-`J/>gp+` J/=g p/; MNJ&g| /DJj:p0 MNp.`RDm Smp`p0 MNS`l` Smp`p0 MN /DSDJjJ`fJ/ 9n8i 3F <)i/gRi`sbGa2<) ҆Bц` .f JifbRi` Eg efPa +g -f ia 0m0 9n*:)iFi im`?)_ f $hB`4)?)_gDBi/gZ3|?Jk Si`Jig ktiaTaZSi`a|Ri`t4)?)_gHNL$h$$$h$p0)L ~NYNXNu,(g !|NuH$hN<L?3FS fiNu?)_g|Nu$fprt`"HBHBB/t Q$Nu//grB Jf BB /g2RB/fHC ps7EoRd R`SBgBo Bl*J?BBHB_HB&NuH/<N,p`H/<N0<HBBH@B@OLr` /)@pNH*o MJfS.` A~N|JfA~N L NuH~K,`p%/f o(R(r@pdg:p gWg[g`D&]`4,Gz rAxSSJjB/` ANrG/ NHXOހ`"Rp/A~N `Rp/A~N o(R(@fXA~N L(Nu0123456789ABCDEFH*l`&UpЭ"M,xN.*K fB`$pЬ l)h)h"@ ( ,xs(qnN.JfLhNuN N / oNU"Or NA0Jf fBN]Nu / oNU"O"AA0f fBN]Nu0123456789abcdef / oQO"O2Af fBPONu / o/JNU"Ol-Dr NA0JffB N]Nu o"oH0 $Hr & +g -fvRH0m n$҂ҁJfҀ`⒀`" SL Nu o/ *H-f0 ,N +@+@f p )@p`+lpB Bp*_Nu oH *H&M` pAU0g rt `rJf L(Nu / o"/ H66,**HN Ns]&@Jfp`+f)|p`+gHx rNXO+gp " MN$@Jf"+$ &,lN*Rg\ `n& $ "+,lNRgB*J"+AT$vNRg*Ap "N$@ f"+$ &,lNRg `,lN|)@N)@pLllNu /"//o H7*/ ,.N N*@Jf p)@p`XB&S"-$,lN"RfN|)@p)@p`* Jg Sg Sg ` ` І`"-t&,lNL`Nu /QO. ,Sm& l@0;N p"`p!)@PONuJjDJj Da DNuaDDNuJj DaDNu/HA4s&^f"H@HAHB4g0H@40HB2$Nu/v AdQC AdYC A dUCJAkSC4HBBBHC604HAdSCЁr2HCH@A&$NuHp$g JfB`&HBHBBBւHAH@B@ЃLNu /H.*l|`2 -Jgf2H  lN`g "-,lN*URF f/NhXOL`Nu8H 6&oP ,F"KN`Rr gr gr ggRF$MXr"fVR K$$H`:r*f0Rpr0grg r g `B`T` `R`r"gJfRB`"$`Rgr g r gr fJgB FmV ,Ff ls7Et`ANC,/ICB8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 , @f )i` hf!i ),xN.LL2V n,n&,g"Cn2", f(EJRkB8*D匰oB8*kEH`&)gf"C`GBsBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*,j ,,(",,xN:Jf )| `"@E#l)I#D#l &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu /H.*l(` mN*U fK\pUf -Jg"- mAN: M*P f L N oH*H`R,g@R ,n" lRr f,,g$A~Nd`S A~Nt` A~Nh~Jf,g>R ,n lR ,gA~Np `Sp A~Nsu;` p A~NL Nu / oYOH.*H|@rAҁ­f p`}}H~$H$I,x/H&n"+g A"(4`":t <hxd",xЁt&A"<N:JfL`, @$@"@ < Sf g I $IS`(I)|hL)NJLHg& hЬx.@ ,x/@Ѭ")ABp"<0NCpN)@fpd`&n)kJg k"h r)IЁ^@)@H@@"<N:LJf </g @)@ Sԁ SQ S"  Q"/`jA\NA\N)@/$@ *$g,l @"({+N)@"N"* g$<N)@g @'h l/Hl h$)hN*bN?p` /.l/ ,g @NN*ZN7Jg*,l",gN",gN,xN|"lN` ,g "l,xN."lNb ,"LN. L~Nudos.libraryH / o)|OdaJ ,gJf6Jgp lCVf apNFlHzHlN)pNFZPOJhfJ|g$ ,dN6)@Xg <N6)@Tfa , ,g, @CNL)@f$/,HzHlN(pNEO `A)H,, Ѐ"Ҁ N6()@\f/HzzHlN(~pNEO ,"Ҁ"l\)I`p\ lCnNL)@f/,Hz"HlN(6pNEvO lNJf/,Hz8HlN(pNEPO ` lNJ& lCNK)@ f/,HzHlN'pNEO l N&Jf/,HzHlN'pNDO ` l NIJhfJ|g|*,dx` lXBHRXeN $N N (N NNNh lNHJfp`pLpNu?Missing filename ("?" for help) wCan't open %s Not enough memory for %ld lines per file r%s is empty Improper -b specification: %s Unrecognized option: %s Improper -F specification: %s Im6proper -l specification: %s Improper -L specification: %s Too many file names: %s, %s, %s Specified column is non-positive Last column precedes first column SAS/C Diff: Version 6.0 Copyright (C) 1988-1992 SAS Institute, Inc, Cary, NC usage: diff [options] newfile oldfile options: -bSIZE set I/O buffer size to SIZE (default is 4K) -c display only lines COMMON to the files -e produce editing script -lNUMBER set for NUMBER lines per file (default is 2O000) -oOUTFILE send output to OUTFILE -p filter input for printable characters -q quiet flag (if no differences, no message displayed) -w ignore trailing blanks in lines, and compresses stretches of whitespace to a single space -FNUMBER NUMBER is first column to consider in comparison -LNUMBER NUMBER is last column to consider in comparison Out of memory QOH.)I)I)I)Ip)It)Ihp)@)I,K/H`&Up-f+HHrFg]g*rg0Sgf'MUg_gWgjSgSg>]gR`O `ACN0,Jf UHhHzHlN!hapN>O p)@|`dRx`^/ HzHlN!>apN>zO `@Jf K)H`2Jf K)H`$/ /,/,HzHlN alpN>8ORXm ,Jk lHzHlN a6pAN>PO ,glHzHlN apN=POL(PONuHzHlN HzHlN vHzHlN jHzHlN ^Hz2HlN RHz:HlN FHz\HlN :HznHlN .HzHlN "OHHzHlN HzHlN HzHlNHzHlNHzHlNHz8HlNHz@HlNHzpHlNO@NuHzHlNPOpNJfp``JpgRATa`F < lT"KN>fJfp`2Jpg lTa lT JfS*o. @CTfJhgJgoS`*,S`GT3hr g r gr fSlmAU hB0h,~AT0hr gt fJJg GRCT `RAT0hr gr g`CT GRET"Rp gp AT0hgp 0hfp AS0hf`"Jgo,*~`ATXxRRoATB0xAT L NurCan't open %s Line table overflow diff I/O error %s empty Internal error retrieving symbol table entry H*H~|`$HHrWAu0Jgx`SRR&MJf xB5xL(NuYOH4B lC8NA)@f/,Hz(HlN(pN:hO |`zxRr܁/GeHzHlNpN:6 JPOATNH.AJgJ&px` kCTfJffRz`&SR fJf2Hx "N&@ @ NXO`Hx rN&@ @ NzXOJhfJ|g NB*@"l\"#D #GBJhfJ|g$l\ g%M`%k la./Jf )@rb2 ,JoHz HlNPO`/,HzHlNO p N9" lL,XN=QOH4~ lCN?)@ f/,HzHlNpN8O |`zxRr܁/G eHzHlNrpN8POATN.AJgH&px` kCTfJffR z`&SR fJf0B "N&@ @ NXO`p/ g"ANj&@ @ NXOJhfJ|g N*@"l`"#D #GB./ 'GJhfJ|g$l` g%M`%k l aJf )@ rb2 ,JoHzHlNtPO`/,HzHlN`O p N7 l L,PN`B,B,a@.a,JfBJf2 ,,e ",0 dDSfp0g8HzN"bpN2XO`&p )@a(`p)@Jfa4` p)@a aJgSg SgSg`8L`Rp)@aL`@)l,@)lDp)@aL`"HzLN!XO`: TO TRANSFORM %s INTO %s ... Internal error: out of sync Internal error: bad case in report *** DELETE %d FROM %s *** %dd *** DELETE [%d,%d] FROM %s *** %d,%dd %c%s *** APPEND AFTER %d IN %s *** %da .$'-+*/?[]^!&@\\%s. *** CHANGE %d IN %s TO %d IN %s *** *** CHANGE %d IN %s TO [%d,%d] IN %s *** %dc *** CHANGE [%d,%d] IN %s TO 1%d IN %s *** *** CHANGE [%d,%d] IN %s TO [%d,%d] IN %s *** %d,%dc --------------- NO DIFFERENCE BETWEEN %s AND %s %d] [?: STATISTICS: Lines in %s: %d Lines in %s: %d Lines shared by %s and %s: %d Percentage of lines in %s that are also in %s: %3.1f%% / ,0"Ҁ*l`)@4` R0R<Jf ,0 c ,0",4fp` ,0ЁS)@8p*_Nu/ ,,"Ҁ*l\)@@`R,Jf ,,c ,,",@fp` ,,S)@Dp*_NuH `(R,R0R< Mpf@ 0f8`$ ,,"R$ԁ l\*H"Ҁ&Hpf ,,c ,,c , ",0cp` , )@8)A4p` ,0 cp`pL(NuH# ,4",8f2Jtf/,/Hz|/,N`TЬH/Hz/,NO `@Jtf/,//Hzj/,NO` ",HЁ$,8ԁ//Hzh/,NOJtfD.,4`(,HH  l`a\//Hz>/,NVOR8cHz,/,N>PO` ,H8Ь4S)@HLNuHJtf/,/, 9n8i 3F <)i/gRi`a2<) ҆Bц` .f JifbRi` Eg efPa +g -f ia 0m0@UL 9n*:)iFi im`?)_ f $hB`4)?)_gDBi/gZ3|?Jk Si`Jig ktiaTaZSi`a|Ri`t4)?)_gHNLL$h$$$h$p0)L ~NYNXNu,(g !|NuH$hN<L?3FS fiNu?)_g|Nu"HAA Am$ Al>8HANuJgH<H@8D:<9pHANL1FH@,龳F@LDH@HDNu l6H@HA0BAEl`fv lPCH@J@fXCt;BH@$纳B@KCm H@EDH@NuDEM$ꩱH@@H@Nu l F`H@J@fF @1lF @@lFJkFH@JFlDFN܆rсNuJFgH@ @@HFF@H@NuR܆NuH?@aLNu<<><H@HB8F@BBDGmNBm, fJgN Gm fJg "NJf JfNNGm. fJg "NJf JfNN|:GfJf JfN(N`@ @Bf&Jf JfNBCGNBCG`BBE?GhNH@.៳G@HB.៷GB.HG,HFކBGGHGHA,BFHFކHC,BFHFކH@HB,ރv݃ށ݃"HA&HCт$B@@H@HBBBނ,ц҇tтND$fprt`"HBHBB/t Q$Nu//grB Jf BB /g2RB/fHC poRd R`SBgBo Bl*J?BBHB_HB&NuH/<N,p`H/<N0<HBBH@B@OLr`/./)GpN.NuH?@aLNu<<><H@HB8F@BBDGmpBm, fJgNtGm fJg "NVN4Jf*Jf$HHyNlXOL <@rH@NuNGm fJg "NN:Gf*JfJfJf JX;fNNnN`@ @Bf&Jf Jf`nBCGNBCG`B BG?GhNJH@.音G@HB.| GBHD8"DHB8HA0BAHB:HC<HC>HGFHGBFHF݅dSD҃тBCHD,HBhBD HBH@HA0BA`*8HA0BAHB<.HGHGGHFBGGHFdSD҃тeSD҃т,HBhBE HBBH@HA0`:HA0HB<ŐdSEЂeSEЂHEHBhp: "( :HDN mJElL` El@DEMXE E9oN2B@H@HAEnE$ꩱtӂтH@@H@Nu$艱tӂтH@E @eN@H@NuH*o MJfS.` AN~|JfAN L NuH*l`&UpЭ"M,xN.*K fB`$pЬ l)h)h"@ ( ,xN.JfLhNuN:N2 / oNU"Or N0A0Jf fBN]Nu / oNU"O"AA0f fBN]Nu0123456789abcdef / oQO"O2Af fBPONu o"oH$*H~`$I`gRJfJf`RRJf L$Nu o"oH$*H~`$I` f`RJfRRJf L$Nu o"oH0 $Hr & +g -fvRH0m n$҂ҁJfҀ`⒀ &PN`" SL Nu o/ *Hpg`0 ,N +@+@f p )@p`+lpB Bp*_Nu oH *H&M`"prAu0Jg rt `rJf L(Nu / o"/ H66,**HN  N $@Jfp`pf)|p`p gHx rNXOp@gp " MN &@Jf"*$ &,lN*Rg\ `n& $ "*,lNRgB*K"*AT$vNRg*Ap "N &@ f"*$ &,lNRg `,lN|)@N)@pLllNu / o"/ QOH76,./H$N  N*@Jf p)@p`pf)|p)@p`B!8i&o$"-$ &,lN*RfN|)@N~)@p`lJgp@f `\$Kp *f "-vN Bp "N*@JgG` r gRe&o$* p" KN*@Jf ` LlPONu /"//o H?*/$,.N N*@Jf p)@p`XB&S"-$,lN(RfN|)@p)@p`* Jg Sg Sg ` ` І`"-t&,lNL`Nu /H.N NF*@Jfp`>pgB`."-,lNp@Ѐg m NP - g @NBpL`NuYOH/6*o,~|'A)HN &l$K|`$K&RR gJf f.pN $&@Jfp `"BB f)K`$*,R`* MJfS RN'@ fr )Apg)@`f M"k f k p0JgSg Sg Sg` <0gp`*~`~`~p0g <@0g < 0g <0gN" t,lN,g> <0g"N k N` <0gB/'`0"N <0g." $<,lN(gX,,FrJ/'g<" $NF`2,< rg <0Jg,<" $,lN(g 'G'D `&,lN|)@ + g @N ,N)@pLlXONu /QO. ,Sm& l@0;N p"`#2p!)@PONuJjDJj Da DNuaDDNuJj DaDNu/HA4f"H@HAHB4g0H@40HB2$Nu/v AdQC AdYC A dUCJAkSC4HBBBHC604HAdSCЁr2HCH@A&$NuHp$g JfB`&HBHBBBւHAH@B@ЃLNu /H.*l|`8 -JgJf2H  lN`Jg "-,lN*URF f/NXOL`Nu8H 6&oP ,"K`Rr gr gr ggR$MXr"fVR K$$H`:r*f0Rpr0grg r g `B`T` `R`$#r"gJfRB`"$`Rgr g r gr fJgB mV ,f l`AC,/ICB8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 , @f )i` hf!i ),xN.LL2V nLn&,g"Cn2", f(EJRkB8*D匰oB8*kEH`'E&)gf"C`GBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*Lj ,L(",,xN:Jf )| `"@E#l)I#D#l &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu /H.*lH` mN*U fK|pUf -Jg"- mAN M*P f L N / oYOH.*H|@rAҁ­f p`>p3UgPpLFr@ҁf B `4p gp` pnFrnFf B ` p+@ ` - (!6el4 mR R r@­gr f MN,Jg ``pg.B -rAN,Rf`r Sgl`dJf MN^Jg p`Tp+@ +m - m MN, mR R r@­gr f MNX,Jg ` L XONu o /"o H4,&I*H$MS`Fpg(Sm < f kRp` KN4` KN,*RgSr gJnfp`B L,`Nu oYOH*HA|fFAN < g2 -rA N.o~/ `Jf`~`Sm mRp`p3Sg"pLFr@ҁf)IY` Bp`pgFB~- JgB- ` -rA N>.o~/ `zJf`~`dJf MNJg p`L m+H -"- mN+@.oS mR~`Jf` B~ L XONu o /"/ "oH 0.&I$HNx*x` kRR SR + lJnJo KN$ +" JNT؀ "NL Nu oH*H gpAЀf. mC"BB- p"r@ҁ­grírí`JgF - Jjr+A - g("- mAN.Rf` g+mB p0fp@Ѐgpp`$*rp` ~K|Jg Ma@Jg~*U f L Nu oH*H~ g -fp`@pg MN.p fJg mNB -NRgJgp`pL Nu o"o/o H4$o &I*H~,,zJg JNxp+r+g r6gSg` |r++WDHH*` zpa+f|prag rg[g*`>JVrA,.<@`,JVr,`JVrAA,`p`/,// NO (Rfp`dJg`0prag rg[g`Hx rNXO`~`~̼fK**%D%H%H %H* L,Nu o"oQOH4*H/I G|+ Kn`$K&R gJf f p"N&@Jfp` K$p!rQ R/ M"oNtXOL,PONu o"o/o /o H4$o&I*H/o `2p%/f fR`/ / JCN(POJg$@` p/ KN@fL, Nu o/",lNJfN|)@N)@p`p,_Nu /H.Jkpop`J AP*H0|"Uf`0 f Ug Uf K<` Kb``*U N/ "NXOpL Nu / oH.*HJkpo0|`AP pxCP#x L Nu //.gXrgl`Npzn pA 0x`>p6Fl`2p Fn pA0x` /l` 1l pA,úA4E0x`p.Nu//NPONuQ, $VER: SAS/C Diff 6.0@ ((((( H -L`j EE8EB/auto/close/waitcon:10/10/320/80/  |@,pL Nu / oH.*HJkpo0|`AP pxCP#x L Nu //.gXrgl`Npzn pA 0x`>p6Fl`2p Fn pA0x` /l` 1l pA&ŋk GXgrepH~$H$I,x/H&n"+g A"(4`":t <%d",Ёt&A"<N:JfL` @$@"@ < Sf g I $IS`(I)|%0L)NJLH g& %Ь.@ ,/@Ѭ0")ABp"<0N&nClpN)@$fpd`)kJg k"h r)I$Ё^@)@,H@@"<N:LJf </g @)@( Sԁ SQ S"  Q"/`JA\NA\N)@/$@ *$g,l$ @"(ǯ=N)@"N l/Hl h$)h$NN&p` /.l / , g @NNNJg ,l$",gN,xN|"lN`,x ,,g"l(N."l$Nb ,0"LN. L~Nudos.library$H/4~B8B4B0|zp/@,*oL/ //LaPO&@B$xE`*Rp-f-HHr$gr2g.r gfWg_gxSg(UgSgUgWg*`Hl&NXO`J-f~`/ aXO`J-fp/@8`x/ aXO`nJ-f p/@4~|`\/ aXO`Rp)@$`JJ-f p/@0|~`8/ aXO`.R`*R"`$B`p)@`/ HlnNHxN-OgK& RXHm/G@/F(/E$J"gB0B@./H$nHlNHxN-lPOJ0gJ4gHlNHxN-NPO  oL$PpoSHh/a*PO&@`a^HxN-XOJfHlNHxN-PO/ NXO*@JfHlN|HxN,POHl/ N(J,gp JCVf aBN,XOHlHlN-4HxN,O B,BHxHlt/ N"Orl/ HlBN2PO`B<`dHl!uN(XORg /,/,$Hl!uHlZHlN,O`6HlHl!uN3PO&@JfHl!uHlNPO`J"fJ0fJ$gHl!uHlNPO|z~/ HxHl!N.O JgJ;vg Hl!aXO/ Hl!N ޯS'M g+K*K`*mJfR$o Jf + f `&k `L,PONuYOH4&o*or\f-f HH&p`px-fZ-HH/aXOJg4-HH/axXOJg mmB// HoaPOp`HHlN HxN$pPO~E`-fއA0xHH&`RTJf-HH&pL,XONu// pAs2mpFopampfo p0m p9np`p.NuH*o ~`p]5xfp\5xfRJ5xf L NuH4*o&op[g/ HlN|PO`p!+f~B/ Bp//Hx!a`~B/ Bp//Hx[aO$@Hx]Hl#/ aO %@oLA#"HJfS R/N!XO&@JfHlNHxN#(POA#"Kf%K g+J `pL,NuQOH4&o$~|z$o(`pFop`6JfHHrA0fHHr$g]gSgWgr-gSg`VG#HHBBBB/HxaaHH.//@4aO$@Rpo\BBBBp//Hxa*@A Έ^#"HJfS+I r Ё.N O+@fp`jA#"mf+J%M `*J oB o( `>Ho/ aPO"/A#X܀Sހ`A#B0XpoP/ / Bp//Hxa*@A#"HJfS+I R.N O+@f `A#"mf`HH/ / BB/HxaaO*@$`A#XRRR*KJf@$A#B0XpoN/ / Bp//Hxa`*@A#"HJfS+I R.NrO+@f `.A#"mf`HH/ / BB/HxaaO*@ L,PONuYOH/4/3*o,|z`p\f*Ho / aPO ER"/ $(܀S / h`r-  f Jo+f ER"`n+op\fV$Mp\f,Ho Hka$(+HH.//(/aO܄ڀ`*+HHHH/ //abO ڀR` HlNbXOR$o(&JgJf0B5XfJf Hl0N4XO` `Hx]HlHN POpL,XONuH//*o op`x*R`HRRoB5H L NuH/*oHH/ /- Br///aO&@Jfp` m g!K+K 'M L(NuH*o~|`2g r0g r7g rWR5xHHGf o L(NuH/K` fp` RpfpL NuH4&o  %*op^f/ B/ aO .`~|HHRgzrbg(` k g5hf/ // aO .lrRJ5hf`h kf8/+/ /NfO Jf$ +f.+`>"ҫ/// a8O .l&R$MJf`/ // aO .lRJ5hf L,NuYOH,/ *o&o$`@r*gr+fz&k(`(/ // aO Rfp*/gJnp`RRJ5HfJfJ5Hf/r*gJo `Zp`Xp*/f|`|`/+// abO Jj4SSlp`(/ // a(O *Rfp`܅&k f@ SL(pXONuH./&o*o|HHRg4r"gWg\r gLr- wR2gbWg:Wf5x+f|`/+/+/ NO Jf,+`t|`pJfl|`hJ5xgb|`^5xr gJfP|`L5xHH/+/aDPOJg4|`05xg*HH/+/a&POJf|`Hl`NpHxNPO L(NuH/*o|`5hfp` RJ5hfpL NuYOA.g yNXONuYOA.g yNXONuH*o MJfS.` AN|JfAN r L NuH~K,`p%/f o(R(r@pdg:p gWg[g`D&]`4,Gz rAxSSJjB/` ANG/ NHXOހ`"Rp/AN`R ҧX6p/AN o(R(@fXAN L(Nu0123456789ABCDEFH*l$`&UpЭ"M,xN.*K fB$`$pЬ l$)h$)h"@ ( ,xN.J$fLhNu o"o /  H"6&I*HB)@$Jf plNb)@Jf plNR)@Ho/,Ho@ K"lN lCDNhO J/g lCuup)@pN~AHC#xLlNu** User Abort Requested **CONTINUEABORT*** Break: intuition.library /H.BJk$m p )@$p`"*l(`*USJo f f p)@$p` L NuYO/p"<0,xN0g.0|"lg" f p,_XNl lB/Hp oN,_XONu o"oH&I/H/I g)H% l%"KNJ*l%Jf)M%p`" M"KN&MJg BA)H%`)K% L(Nu o"o/ p$IgJg f"JRR`$_Nu o"o/ $IgJgg `"JR`p` $_Nu o"o/ p$IgJgf`"JR`ɀR`$_Nu o /"/ SkfSHRJf Nu o"o / JgSf JgSjpNunpNupNu"o o / "JfS`gSdB Nu"o o JfSfNu"o o / "`gSd`BSd Nu"o o / "Joe !Sf`Sf Nu o fNuYH<2",$f)|$LLB8+B:*E؅XXJjjDޠ7Dk*43HBB7Hש&)f4 ,$ @f )i$` hf!i ),xN.LL2V nn&,$g"Cn2",$IJ f(EJRkB8*D匰oB8*kEH`&)gf"C`GBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*j ,(",$,xN:Jf )| $`"@E#l$)I$#D#l$ &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu /H.*l` mOKN*U fKpUf -Jg"- mAN M*P f L N / o/ "*HRC R  mA r"mAN|x=|  JN*/$fA $VER: SAS/C Grep 6.0@grep: Version 6.0 Copyright(c) 1988-1992 SAS Institute, Inc., Cary, NC bad option: %s (? for help) No pattern or file arguments given (? for help) Incompatible combination of options! (? for help) NULL pattern Bad pattern ?No file arguments provided (? for help) Can't find file(s): %s File access error: file = %s, errno = %d,_OSERR = %d rCan't # G,open %s %s: %s %s: %s%s%d lines matched SAS/C Grep: Version 6.0 Copyright(c) 1988-1992 SAS Institute, Inc., Cary, NC grep [>outfile] [flags] pattern files ... Flags: -$ make case insignificant -c print only a count of the matched lines -f print only names of files in which a match was found -m use msdos wildcards -n shut off line numbering -p filter input for printable characters -q "quiet" flag -- don't display file names or line num$yu@bers -s show name of each file as it is being searched -v print only lines in which a match is not found -V print version of grep Illegal option: %s (? for help) invalid command line Pattern ill-formed: no terminating %c Out of memory n t br s f \\[ ]$.[Out of space in mkpatnode Improper hex specification Internal error: bad string to getccl: %s Out of space in getccl Bad character class: Empty character class Closing %c not found Internal%du error in omatch /@ ((((( H  +&4++/auto/close/waitcon:10/10/320/80/  X|h@ +-R8lprof.w#H?:NU,yI# #N#pCQN#&gpC]N#*g~C2#Lp,y*NJfb#2.$<"<H,y&N#g8 9 y H@@NL @ 9й # $HGadBa pd `ApB## " Nj#g @rR  @fR Ё#"<,yN:# 9r"y$#@ @ (#BԀ"VҀC fS"#p "<,yN:#g2H y#"!OAyy ((| 9 y $y$jNLp y!y"9Al&X$"9,y&N&9p$9"9,y&Np$,y 9.g"@p,y*N"9g ,y&Nd"9g ,y&N 9&g "@,yNb"y 9gN."y 9pgN. N]L\Nup`xa  gReNu  fReNu/ (I yp( b CxR (fV y h6 (.)g ( y"A A Jo cdШ yR`Rtpy(_NuH *Hg r f*MR`p-fJpt-fB੊*MT MCNg r g*MR`*MR0,"A@A@$BA9Bf9|\Z L Nu o"oH0 $Hr & +g -fvRH0m n$҂ҁJfҀ`⒀`" SL NuNN=vj@xpfZF@:4*$RJD. zvfZPF:0(#\Z42prof.outdos.libraryciab.resourceD҂ҁJfҀ`⒀`" SL NuNN=vj@xpfZF@:4*$RJD. zvfZPF:0(#\Z       <lstat@gD  H~$H$I,x/H&n"+g A"(4`":t <вd",Ёt&A"<N:JfL` @$@"@ <ʙ Sf g I $IS`(I)|hL)NPJLHXg& Ь.@ ,/@Ѭh")A,BTp"<0N&nClpN)@fpd`)kLJg k"h r)I\Ё^@)@dH@@"<N:LJf </g @)@` Sԁ SQ S"  Q"/`JA\NA\N)@T/$@ *$g,l @"(`N)@L"N lT/Hl( h$)h\NN Fp` /.lX/ ,Dg @NNNJTg ,l",LgN,xN|"lTN`,x ,dg"l`N."lNb ,h"LN. L~Nudos.libraryYOH6./*o ,xN&@ +0|/@$@"jgp)@)]l.Sg Up-f|/NXO U"HRrFgrTgCpZga U"HRpFfRp U"HRpZfRt U"HRpTfCp=ga UV/N&XO)@x*MX`vpmpoapm0HlHz/N-~O Jf/HzHl4N'2HxaOpm)mN `HlHz/,N- ] [ ] -z permits printing of entries with zero time -f enables full line-by-line accounting. -t sets a hit threshold for listing. is the name of the program that was profiled is the profiler's data file (by default prof.out) m *** Break headererror while reading profile data profile %s is too small couldn't get memory (%ld bytes) for profile buffer datacounted = %ld, RUN - NonTable %ld 33mRoutine % Total % Offset Hits Labelm% %6lx %8d %s [lines %d-%d in %s] (%d) on line %d Most hits -Profile Statistics for %s %ld run + %ld ready I+ %ld wait = %ld % run, % ready, % wait samples (%ld) out of profile range %d.%s/,lHzHl4N"HzHl4N"HzHl4N"Hz.Hl4N"HzRHl4N"HzrHl4N"HzHl4N"zHzHl4N"nODHxa$XONuHzNHzNHx+aO NuH./ ,g"@ ,|,xN.B ,g"l,xN.BJgNHJgN|/N!^XOL@NuHK|GPHlN.2XOJf N .pd4, gHz2Hl4N!PO`/ HzBHl4N!O HxaRXOHlHxHx/ N&OSfpc rHx/HlN$O Rg rHA,xN:c>)@f/HzHl4N!0HxaOG ,HlHx//,N%OSg`@LhNuH~*l g ޭ M*P` L NuH&l*l gF g< + d K&P` g "+ @dJf K+H+H`+K K&P` M*P`L(NuQOH|az./,/HzXN O Jf HzjN!.XOHzfN!$XOJf HzN!XO*l gx - fJtgjxeb܀HzZ//HxadHzJ//HxaTO /-/- /-Hz.N nOJg Hz&NXOJf HzN XO m"m/(/)/(HzN OJf HzN XO m/PB m&H/H gT + oc/KAJpg6Jg2HzN Hz//+HxaO/+/+HzN O K&P`JpfD oJg:HzN :HzH/ o /(HxaLO o/(/(HzTN DO m HzN XO M*P`L(PONuH1*oG/ Hz@N  +"+ $Ԁ&+ԃ..///Hz8NHzV//+HxaHzL//+ HxaHzD//+HxaOHHz/+/,HxaO ,g /HzNPOHzZN @XOL(NuH4*l~  l$H ,|"偾dpJg` g @e*@`&m g0 g @ e&@` mf&H"K gpЫ b ѫ -g r @Ҩ b ѭ .p ހ$JX`L,Nu H/lJgprHA,xN:&@ fHxHlN)PO o'h'h ( '@ 'h'h f*K`6 + c&*K`&/M o g"+ "@ b/@` o& o/P/H "Hp,xN.`Z)MLh NuYOH*/$,/ ./*o( 倐І,B R"/lxJgrJg$ "Nz( "N4" 倐ЀЀ, /f "NN jR′\r(؁Jf pdl HzdN >XOp l HzTN .XO/HzN ZPOJf HzN XOR`X/ HzN 6POL XONuH~HlN(XOJgNJfHzlHl4NHxN ;(LO `. fHzdN XOp`8HztHl4NbHxNO |aD.Jg f,RepLNureadprog: got a longjmp readprog: successful return unexpected eof hunk_unithunk_namehunk_codehunk_datahunk_bsshunk_reloc32hunk_reloc16hunk_reloc8hunk_exthunk_symbolhunk_debughunk_endhunk_headerhunk_ILLEGALhunk_overlayhunk_breakIllegal hunk id %ld (0x%lx) ClassExt: GOT A SYMBOL!!! what now? UNKNOWN EXTERNAL SYMBOL TYPE %d ClassOverlay: can't handle overlay h unks yet ClassIllegal: hunkid %ld skiplong: seek error readlong: read error /./ "A 0.Nu/./ e b gp`p.NuHp)@a&..B/aXOJf//HzHl4NOp`& "AX,0 A*p/NXOL NuH./ ,Ѭa, , " l")AR /aXO LNuH./ a~, LNuH./ah,Jga^*/aXO` LNuPH./dHxPHoaPO,Jgx(, JgHSgSgSgr~g$SgSgSg`6aЬ*`aЬ, k o R` L@XNuHz6Hl4NPOpNu/.//HzJHl4NO p .Nu H./(B a,/FHlN/@a,U/@aXO/@HEADg gg rg`~HlHx,HxHoNOr,gHxHlN!POab* RЀ,pdЀc|8FHl/HxHo$NOB7X /rN ",`HxHoaPO"S,JgpprHA,xN:*@ fHxHlN!2POHoaz+@aR+@aXOЯЬ+@ J f /M /M` o /M,S`Jf o )H`F o ( l谨 d"o" o )H`$&H g o "( @ c&@` o & SRC f( /" /ЁB/HlNO `/a ϵBXO Lh NuYOHlHxHxHo NPOYgHxHlN $PO XONu/./ Hx/HlN,O RfHzHl4N~HxHlNO.NuH./*o,HlHx// NOYgHzHl4N8HxHlNOL NuH./*oa8*,g( 䀰b,` B5 / /aPOB5x L Nu/a.Jg /aXO .NuH*l g,&U m JfS R"m,xN."MpN.*K`LhNuH*l g,&U m JfS R"m,xN."MpN.*K`LhNuH*o MJfS Rr,xN:&@ fHxHlN~PO M"K4 f LhNuYOA.g yNXONuYOA.g yNXONuH*o MJfS.` ANJ|JfAN L NuH~K,`p%/f o(R(r@pdg:p gWg[g`D&]`4,Gz rAxSSJjB/` ANjG/ NHXOހ`"Rp/AN`Rp/AN o(R(@fXAN L(Nu0123456789ABCDEFH*l`&UpЭ"M,xN.*K fB`$pЬ, l)h)h,"@ ( ,xN.JfLhNu / oNU"Or NA0Jf fBN]Nu / oINJ,NU"O"AA0f fBN]Nu0123456789abcdef / oQO"O2Af fBPONu / o/JNU"Ol-Dr NA0JffB N]Nu o"oH0 $Hr & +g -fvRH0m n$҂ҁJfҀ`⒀`" SL Nu o/ *H-f0 ,XN +@+@f p )@p`+lXpB Bp*_Nu oH *H&M` pA0g rt `rJf L(Nu / o"/ H66,**HN ( N &@Jfp`+f)|0p`+gHx rNXO+gp " MN 4$@Jf "+$ &,lN*Rg\ `n& $ "+,lNRgB*J"+AT$vNRg*Ap "N $@ f"+$ &,lNRg `,lN|)@0N)@pLllNu / o"/ QOH76,./H$N $ N*@Jf p)@p`-f)|0p)@p`B0&o$"-$ &,lN*RfN|)@0N)@p`lJg-f `\$Kp *f "-vN Bp "N*@JgG` r gRe&o$* p" KN @Jf ` LlPONu /"//o H7*/ ,.N, N*@Jf p)@p`XB0&S"-$,lN"RfN|)@0p)@p`* Jg Sg Sg ` ` І`"-t&,lNL`Nu /H.N NZ*@Jfp`6-f("-,lN-g m N - g @N0BpL`NuYOH/6*o,~|'A)HN<&l`$K|`$K&RR gJf f.pN @&@Jfp `BB f)K``$*,\R\`* MJfS RN '@ fr )Apg)@0`@ M"k fp0JgSg Sg Sg` <0gp`~`~`~/3g/2g/ 2g/2gD" t,lN,g4/ 2g"N k N`/ 2gB/'`2"N/2g." $<,lNTt}(gP,,hFrJ/'g4" $NF`*,<g/ 2g,<" $,lN(g 'G'D `&,lN|)@0 + g @N\ ,0N)@pLlXONuJjDJj Da DNuaDDNuJj DaDNu/HA4f"H@HAHB4g0H@40HB2$Nu/v AdQC AdYC A dUCJAkSC4HBBBHC604HAdSCЁr2HCH@A&$NuH0$&HBHCCHBBBЂL NuHp$g JfB`&HBHBBBւHAH@B@ЃLNu /H.*l`|`2 -Jgf2H  lN`g "-,lN*URF f/NXObL`Nu8H 6&oP ,>"KF`Rr gr gr ggR>$MXr"fVR K$$H`:r*f0Rpr0grg r g `B`T` `R`r"gJfRB`"$`Rgr g r gr fJgB >mV ,>f lT`AFC,/IC lBNJNLl8Nu*NIL: /TH76.| l\(pOo, C'`SdB7h',xN*@ @JgN - @*(8f*-Jg8"A$v ,lN&R h'"A'$,lNp)@pNCp,xN*@Jf p)@pNA')HCEGp"t}Ԃv<,MNS@g p)@pNLAC#xLlTNu** User Abort Requested **CONTINUEABORT*** Break: intuition.library /7}H.B0Jk\m p )@p`"*l``*USJo f f p)@p` L NuYO/pr`,xN0g.0|"lԱg" f p,_XN: lB/Hp oN,_XONu o /"/ SkfSHRJf Nu"o o / "JfS`gSdB Nu"o o / "Joe !Sf`Sf Nu o fNuYH<2",f)|LLB8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 , @f )i` hf!i ),xN.LL2V nn&,g"Cn2", f(EJRkB8*D匰oB8*kEH`&)gf"C`GBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*j ,(",,xN:Jf )| `"@E#l)I#D#l &g(Yg$#CGX5|5E7EC7C`B5|Ds5D XLL|Nu oYO/ g$&@`RpA0f KCN. /&_XONu /H.*l` mN*U fKpUf -g"- mAN M*P f L Nz / o/ "*HRC R  mA r"mAN0B*_Nu / *oB B/MHo//AC N PO / grA"oAN-f-gp` /*_ Nu/ "*HCR R  mArCNB*_NuBBHo//ACN PO /grACAN^p0*gp` Nu oH*H`R,-g@R ,&n" lRr  CCf,,-g$AN`S ANt` ANh~Jf,-g>R ,&n lR ,-gANp `Sp AN` p ANL Nu / oYOH.*H|@rAҁ­f p`, mR R -gr f MN -a,Jg ` L XONu oH*H~ -f r )Ap`n < f MN~Hx -rNXO,Jf<-g"&m*-`r WDHJgS SJf-gܭ ` L(Nu o /"/ H,.*HpAЀg MNH Sf MNDހ|+mB BB- -gp/ -"NjXORfp`pL Nu o /"/ "oQOH .*I&HN*x/H` mRR SR - lJnJo MN -" KN؀ "NL(PONu o /"/ "oQOH *.*I&H/HJgJfp`B "NH*x`C QRSSRJgJ bnJo -" KN|؀ "N\L(PONu oH*H gpAЀf, mC"BB- p"-g`JgD - jr+A - g("- mAN.Rf` g+mB p0f-gpp`$p` ~KJg MaFJg~*U f L Nu oH*H~ g -fp`@-g MN .p fJg mNRB -NRgJgp`pL Nu o"o/o QOH&o$*I/H~,,dzJg KNtp-r+g r6gSg` |r+-WDHH*` zpa-f|prag rg[g$`6JVrA~@ (Ϻ`(JVr`JVrAA`p`/,h/// NHO (Rfp`bJg`0prag rg[g`Hx rN(XO`~`~fK**'D'H'H 'H* L(PONu o"o/o /o"o0 QX(j~DJg E=|-<`"J/:g E=|+<`J/9g E=| <|  JN* /PfJg /Pjr/AP(/Po J "JNdr0 J`Sd*/P܅ Sf/7fJPfB` /Pjp/@P|6p/6f"o0 QX x8` "o0 QX(/$rugZrofJ/8g E=|0<|  JNv`>J/8g|0|x=|  JN'H*/$fA=<;:9876543210/.-,+*)('&%$#"!  _splat:S HEADDBGV01-CD\KH~$H$I,x/H&n"+g A"(4`":t <@d",Ёt&A"<N:JfL` @$@"@ <͙ Sf g I $IS`(I)|@tL)N\JLHdg& @Ь.@ ,/@Ѭt")A8B`p"<0N&nChpN)@?fpd`)kXJg~ k"h r)IhЁ^@)@pH@@"<N:LJfp/g @)@l Sԁ SQ S"  ;- Q"/`JA\NA\N)@`/$@ *$g,l? @"(N)@X"N l`/Hl4 h$)hhNN+"p` /.ld/ ,Pg @NNNJ`g ,l?",XgN,xN|"l`N`,x ,pg"llN."l?Nb ,t"LN. L~Nudos.library H.6,/0*o4plaHxN2XOB,<:B,;zG`$Sp-f/ a^XORXm蜅naHxN2XO  u,T"uHxd/H$/I(N1 XO$@JfHl0Hl@N2HxN2dO B&M` X// N/PO S f// N FXO/@ fHl@Hl@N2HxN2 O JgHHl<:N XOJg:plЀp)@`6p)@`.p)@?`&,Hxp/// / aO,~` FRCx xRJ2xgP m`Fpg:/p/// / a|O,` FRCx xRJ2xg m`p`F mHlJHl@N,PO,<AxB0h`p$fd|`) GRCx hRJ2hg m R//// / aO, mHlhHl@N,PO,<AxB0h`|J2hg`/ // NO (mJz` GRCx XRl m//// / apO.z JE|p/3fR` gF| FR"GR Mx" J2hg m mHlHl@N+POAxB0xpLlNuH4,/0./(&o$*o z`^HHr&g$r6f./B$oF+J,Jg m@r*gr+fB+h*J3Xg8/-// aO +@Rfp*-g -Jo`p`RR` mJf$J3Xf-r*g$-Jo$S `|p`xp*-fB`p+@ -찭m$ m/(// a"O +@Jj>SS`p`2/-// a0O +@Rfp`ܭ m+h` SL N]NuNUH0&o ./$$o(|Hr*]Akuа{fN!`[`|$`d.`T^`F`a`3x*f|`| K/*/*/N$zO Jf,*`x|`tJfp|`lJ3xgf|`b3xr gJfT|`P3xHH/*/aJPOJg8|`4J3xg.3xHH/*/a(POJf|`HlN HxN'PO L N]NuH/&o|J3hg3hfp`R`pLNuNUH0/#/'*/(&o,$o0HxN%XO+@JfHlN HxN' PO mF!E!K!J !m L N]NuNUH#0&o4B~J3xg3xHr*]Ak\{fN\`+`*`[`P$`^`.`3xHHr/ O/ /t///a"O+@" g %@ @!J $@B` K/ /apPO+@Jfp` K/a*XOހ g m%H!J $mB`,SJgp^3hgJ3hgp*3hgp+3hfp`3xHH/ /a,PO` KHm/aPO+@Jfp` -HHr// /B/Hxaa@O"-Sށ+@" g %@ @!J $@B`6Jf3xHHrA0Jgx3xHHA0g3xHHr Ё`3xHH@3xHHA0g3xHHr `3xHH@/ HlaPO+@Jfp`3xHH/aXOJfJf<3xHHrA0Jg&3xHH \1JCr// /B/Hxaa6O+@`, KHm/aPO+@Jfp`H -Sހ m!J g m%H$mJg$j`R`X mJ f `+h `L N]NuNUH0&o$o r\fJ+f HH$p`px+fX+HH/aXOJg2+HH/aXOJgkkB-/ HmaJp`VHlNHxN#PO~ ЀAJ0g( ЀA0+fA0HH$p`R`+HH$pL N]Nu// pAmpFopampfo p0m p9np`p.NuH&o ~J3xgp]3xfp\3xfR` LNuNUH0&o$$o(Bp[g/ Hl6Npp (}`p!+f"~p// /r//Hx!a>O+@` ~p// /r//Hx[aO+@ KHx]Hl>/a,O m!@JoPHl>NBR.N XO+@JfHl`NHxN"$POHl>/-NPO m!m g%H `pL N]NuNUH2&oD$oHz~|J3xgpFop`Jf3xHHrA0Jf3xHr$]Ak°{fN$`".`[`\`*`+`A>0hHHr///B/Hxaa3xHH./+@aOR+@pozA>B0hp///r//HxaHl>+@N m!@RP.NxO m!@Jfp` Hl>/NPO m"m#H!I ,m-I` m"mB+H$ -`Z KHm/alPO( -A>h Sހڄ`A>B0hpoTp///r//HxaHl>+@N6 m!@R.NO m!@fp`Hl>/NPO`$3xHHr///B/HxaaO+@$ -`A>xhRRR`$A>B0hpoRp///r//HxaDHl>+@N m!@R.NO m!@fp`6Hl>/NXPO`$3xHHr///B/HxaaO+@ -LLN]NuNUH/0&o8$o</C|z3hgJg Kp\f.Hm/aPO ER"- g$(+@S܀ -h`p-3hf JoJ3hf ER h`3h3hor\fn Kp\(f8CHm/ al3hHH J./-/+@aO(ܭڄ`43hHH3hHH J///aVO (ڄR` HlxNXOR`B2X3hfJf HlNp` `Hx]HlNpL N]NuH//&o op`z(Rn XRR`B3X LNuH0/&o HH/ /+ Br///a0O$@ fp`J g k !J'J %K L NuH0&o$o|.HHA0XgJA0Xg r0A0Xg r7A0Xg  {rWR3hHH`$ L NuH/G g fp`R`pLNupaYOA.g yNXONuYOA.g yNXONuH*o MJfS.` AN|JfAN! L NuH~K,`p%/f o(R(r@pdg:p gWg[g`D&]`4,Gz rAxSSJjB/` AN G/ NHXOހ`"Rp/AN2`Rp/AN o(R(@fXAN L(Nu0123456789ABCDEFH*l?`&UpЭ"M,xN.*K fB?`$pЬ8 l?)h?)h8"@ ( ,xN.J?!q fLhNu o"o /  H"6&I*HB<)@?Jf plNz)@Jf plNj)@Ho/,Ho@ K"lN lCDNpO J/g lC:NZ lCNN l"Kf JffJXf(",t,l?N)@?f&p)@?)|B8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 ,? @f )i?` hf!i ),xN.LL2V nn&,?g"Cn2",?̲ f(EJRkB8*D匰oB8*kEH`&)gf"C`GBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*j ,(",?,xN:Jf )|/^ ?`"@E#l?)I?#D#l? &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu /H.*l` mN*U fKpUf -g"- mAN\ M*P f L N / o/ "*HRC R  mA r"mANHB*_Nu / *oB B/MHo//AC N PO / grA"oAN-f-gp` /*_ Nu/ "*HCR R  mArCNB*_NuBBHo//ACN 2PO /grACANvp06gp` Nu / oYOH0v_.*H|@rAҁ­f p`"o0 QX(j~DJg E=|-<`"J/:g E=|+<`J/9g E=| <|  JNv* /PfJg /Pjr/AP(/Po J "JNr0 J`Sd*/P܅ Sf/7fJPfB` /Pjp/@P|6p/6f"o0 QX x8` "o0 QX(/$rugZro#5^fJ/8g E=|0<|  JNb`>J/8g|0|x=|  JN~*/$fADHRVXfz ,HV\r*,@F&8Zbhpvz   &"2&2(<)T*^+h,r-|./4FHJKLMNO PQ$S(U*V0X2Y8[:\@^B_HaJ b` cdfpgvhil'9mnp0@F\^p  26HThjrt|(:0 4 6 D FV^l+t269::;@Z]^__a_ishexdig*_strncpy28_stclos@getfnl$@strsfn.@strpbrk1___write&_strterm_strcpy2\_locate @free2_toupperB_are_match ___stpcpy"$_strmfn ___pfA@fclose;__XCEXIT___r);[xead'@freopen;@strcat2(@_XCEXIT_re_match X@fgets8X_freopen;@mainC0@unlink&___stcl_o"@strncpy2D@__io2errnoB__tinyprintf_printf6@__write'_strpbrk1|_lsub8_stptok!_usage@toupperB___strlwr&|@stcgfn#_stcgfn#_fgets8L_dodash@__stcd_i#@stptok!@__strupr&_unlink&*Ci_d#X@__pfA_ccl_len^___lseek(@__stcul_d"@@stcsma"p___chkabort1_sread @fopen=4_stcsma"h_stci_d#P___fpinit@dnext ___stcl_h#$___close)_strlen1h_stpbrk1|_getccl@memmove2x_fprintf5___stcd_i#_strncmp1___io2errnoB@fwrite:<_fopen=,_stcl_d#P@renameBP___strupr&___fpterm-?F_getfa%@fputc6_memmove2l@fgetc8@__halloc3__CXD33+_malloc3@strncmp1@mkdir$D@fflush:_memchr1___chkufb0___open)@strmfe!B_removeB___pfmt=@exit5p_eesc "@_CXBRK/@__exit,_dfindX@__close)$VER: splat 6.00n t br s \\Out of Memory Bad pattern Can't make directory: %s _OSERR =.@ %d Can't find file(s) : %s File access error: file = %s, errno = %d,_OSERR = %d /$$$rCan't open %s for input wCan't open %s for output %s%s%s: No substitutions made splat [-s] [-o | -dPREFIX] regexp string file1 file2 ... %s %s%s Version6.00: Copyright (c) 1988-1992, SAS Institute Inc., Cary, NC, USA -s: show file names mode -o: overwrite target files with new files -dPREFIX: prepend PREFIX to file name and use the result as the outp/A:lNut file name (making a directory if necessary) -v: verbose mode: display only those lines in which substitutions were made on screen Bad option: -%c Warning: -v overrides other options -o and -d flags are incompatible Substitution buffer overflow Substitution buffer overflow Substitution buffer overflow Substitution buffer overflow Internal error in omatch n t br s f \\[ ]$.[Out of space in mkpatnode Improper hex specification Internal e0B%0rror: bad string to getccl: %s Out of space in getccl Bad character class: Empty character class Closing %c not found /@ ((((( H @1C 0x00/auto/close/waitcon:10/10/320/80/  __OSERR<___iob__ONEXITP___fmaskt___stdiowin__SLASH__SIGFPED___base8__SIGINTH_SysBase\__Me2DmHeap?___exitfuncs__MemType?___stdiov37__ONERRL_spchr___sigfunc___stack___curdirX_NULL4_sbufx_dirflag__StackPtrd__ctype___nufbsh__WBenchMsg`___closefunc?_overwrite___ctype___msflag?___ufbsl__MSTEP_verbose__ProgramNameh_casig_errno?_msflag?___fmode3-5'p__ONBREAKT___buffsized_show__FPERR@___top?_DOSBase?_RESLEN@00/auto/close/waitcon:10/10/320/80/  __OSERR<___iob__ONEXITP___fmaskt___stdiowin__SLASH__SIGFPED___base8__SIGINTH_SysBase\__MeE#F}hgfedcba`_^]\[ZYXWVUTSRQPONMLKJIHGF AtbEGCϲH~$H$I,x/H&n"+g A"(4`":t <ldd",dЁt&A"<N:JfL` @$@"@ < Sf g I $IS`(I)|lL)NJLHg& lЬd.@ ,d/@Ѭ")ABp"<0N&nChpN)@fpd`)kJg~ k"h r)IЁ^@)@H@@"<N:LJfp/g @)@ Sԁ SQ S"  Q"/`JA\NA\N)@/$@ *$g,l @"(NEHܽ)@"N l/Hl h$)hNN'p` /.l/ ,g @NNNJg ,l",gN,xN|"lN`,x ,g"lN."lNb ,"LN. L~Nudos.libraryHJg l (g"@" JfS R"A,xN. lJ gx~|`R"l i *h`&U"M ),xN.*K f"l i *h `&U"M ),xN.*K fRp܀ l侨e l ("h ,xN. l (|g @"JfS R"A,xN. l*h `&U -P"M,xN.*K f"l < ,xN.LhNu6.0Snapshot.TBUsage: %s [-axsrvmut] [[TBEIB file] executable file] default TB file is %s -a all (life the universe and everything) -x symbol xref -s stack -r registers -v environment -m free memory -u user data -t trace *** unable to allocate memory TraceDump %s Copyright (c) 1992 SAS Institute Inc. r*** unable to open traceback file %s *** unable to open executable file %s H6.$HCb|/H/Ipo jp?f/HzHHlN, Hz0HzlHlN,HzzHlN,HzHlN+pN+4O(`nprag$r EJ޸g"Sg@[g*Sg Sg(Sg6Sg&Ug `0|`,|`(`"```` `R*jJfXS*j gp-gpf&M`o /j&jARN* < rHA,xN:)@fHz2HlN+,pN*hPO/,Hz:N*o$ MCbN1PO$@Jf/ HzRHlN*pN*0O JNjJfpN* JN0 f l&h g: KCN1*@Jf/ Hz*HlN*O ` MN0JfpN) MN/ Ll N vQOH*HAN6Jgp` MN2 PGTBgHzHlN*HPOp` MN.` MN, MN*U FAILg* gT g$g0 EKiʵg2g`<  Ma@`\  Ma`R  Ma`H  Ma`>  Ma`4  Ma`* ANb/Ho/Hz8HlN)  MNOJnNpL PONuwrong file type *** unknown section type %lx = %s size = %ld incorrect VERS block format incorrect REGS block format *** invalid FAIL data element size *** unable to allocate memory *** invalid STAK block format, type %ld, size %ld ***unable to allocate memory incorrect FMEM block format H,*HN l!@t MN l!@xC| MNWgHzEL+/HlN(  MNPOp l!@pL @NuH.*HpgHzHlN'PO  ML N"l(  MNp l!@$L NuH,*H_"lXNR"lPp MN l"(ҁgHzxHlN'hPO  MLh`N` l (rHA,xN: l!@ fHzbHlN'.pN&jPO|z`0"l&i MNX'X"l&i MNQ'@Rpڀ l伨ep l Lh`NuH(*H|N*SJgSgSg4SgL`f Wf`&l`X nN lBB!DG`: f0 lp!@BG` f lp!@BG`|Jg //HzHlN&8  ML(pN.EM-  M"KL(pNlQOH./H l*h G `&M*S f PrHA,xN:&fHz^HlN%pN%PO S!GC  oLhPNH.*H]gHzBHlN%PO  ML N"l  MNp l!@L NuH*H~AN1~Jgp`"p)@`. Ma6,f WDHHL Nu*** encountered HUNK_EXT: I give up *** Overlays confuse me, I give up *** illegal hunkid $%lx in program file *** code file hunk count does not match traceback *** segment %ld length $%lx != hunk length $%lx *** memory allocatENion failed *** unable to allocate line memory H*HN<.g m l@0;N""0FFFRdlt|R MN MN`t MN xR`h R MN MN b,f`RHzXHlN#zPOp`B Ma`8 Ma`0 Ma4`(HzTHlN#PPOp`/HzdHlN#gagaZgagagaga\.Nu???BusAddressIllegal InstructionDivide by ZeroCHK instructionTRAPV InstructionPrivelige ViolationTraceLine A EmulationLine F EmulationTraceDump Utility: %s; Version %ld, Revision %ld Processor type: 680%c%s 0 with 688810VBlankFreq %d, PowerSupFreq %d CVZNX Registers: D%E Q.d=%08lx%cA%d=%08lx%cPC %06lx %c=%c Program Name: %s; run from %s CLIWorkBenchProgram load map (addresses are APTRs, sizes are in bytes) %06lx $%-5x%cTerminated with GURU number %08lx, %s Error Failed at %lx = %s+$%lxFailed at %lx, hunk %d+$%lx, file %s line %ld+$%lx stack top: %lx, stack pointer: %lx, stack length: $%lx top 4k segment present bottom 4k segment present entire stack, size = $%lx bytes User data section, size = $%lx bytes Memory StatistiE R:ecs Available In-Use Maximum Largest chip%11ld%10ld%10ld%10ld fast%11ld%10ld%10ld%10ld total%10ld%10ld%10ld%10ld called from %lx = %s+$%lx called from %lx = hunk %d+$%lxSymbols for hunk %d %20.20s = %6lx%cH~0 lJpg/(x/(t/(|Hz|N&O lJgT( g~2` ( g~1|( gA`A//HzjNO l/(/( Hz|N O LNuH l.(,J$gHz~N rXO|z rWfp `p l//(0/Hz`NxORXpm|z rWfp `p l//(E SաP/Hz4N@ORXpm l/((Hz"N"PO|Az0hVr0//Hz NO RpmHzNXOLNuHA "lJgA//)HzNO HzNzXO~|`.Wfp `p "l i //(/HzNORp܀*pʀ l侨eWg HznN(XO l ("A/0/HzN: l ((ANO Jgb /g/// l/((HzN`//// l/((HzNO /g// // /HzNO` HzNXOLNu/ l (//(/(HzNO lJg&HzNP"lp@ l"(ANXOET2x lJg.HzN lp"lЩ"Hr@AANdXO l (g0/HzNE R"R )"H Z"(AN*PO$_Nu/ l*h `* -/HzlNA -"HrANPO*U f*_NuH lJgHzZNfXO lC ".////HzzNvO lC ",////HzpNRO lC Шކ"Ҩ&֨////HzZN"OLNuH lJg.(d` l䞨  (ANfJg  lK /g// //-HzN`// // /-HzNO /g/////HzrNO` EU'HzNBXO  l.( l侨ddXL NuH~|`b"l i *hz g4/HzN&PO`&fp `p //-Hm HzNO*UR fg HzNXORp܀ l侨eHzNXOL NuYO"HprANYgHzHlNpAN"PPO XONuunexpected EOF *** unable to allocate memory YO"HprANYgp` XONuH,&I"Hp" KNgHzHlNpAN!POL@NuH.&I"Hp" KNVgHzbHlNTpAN!POLNuH&I*Ha .rHA,xN:&fHz4HlNpNRPO  M"SaV LEVp`hNurNRfHzHlNpAN!&PONurNRfHzHlNpAN!PONu/.pcpe cp`p..Nu%06X: %s H1.pt ^DHH&烖Ѓr0Ёpv^DHH&烖ЃЁ@LNutH4&I*HH~`|x`0A$p3XaT*R rf FR"O$  (*ڄlpm` FR"O$  p$mA$:T| z`E$Rp3HaR(؅lpm O$B0h*/ Ho$/Hz/ NfOrځށ/E m2L,tNuH/@*HGp//H ax*KRp/ aEW[h*KRp/ aXKp/ aHBL(NuQOH4*H(BB ~| l*(/@`"l&i b"+Ҁd*.+GE` R (bC +I$RJfJg+D ` S (bC+I &SJfJ g^(dN + KE.+ |` *bRPo+j +@mrfr o B `B p`Rp܀epL,PONuYOA.g yNXONuYOA.g yNXONuH*o MJfS.` ANf|JfAN L NuH~K,`p%/f o(R(r@pdg:p EXu~gWg[g`D&]`4,Gz rAxSSJjB/` ANjG/ NHXOހ`"Rp/AN`Rp/AN o(R(@fXAN L(Nu0123456789ABCDEFH*l`&UpЭ"M,xN.*K fB`$pЬ l)h)h"@ ( ,xN.JfLhNu / oNU"Or NA0Jf fBN]Nu / oNU"O"AA0f fBN]Nu0123456789abcdef / oQO"O2Af fBPONu / o/JNU"Ol-Dr NA0JffB N]Nu o"oH0 EYs$Hr & +g -fvRH0m n$҂ҁJfҀ`⒀`" SL Nu o/ *H-f0 ,N +@+@f p )@p`+lpB Bp*_Nu oH *H&M` pAa0g rt `rJf L(Nu / o"/ H66,**HN  N &@Jfp`+f)|p`+gHx rNXO+gp " MN $@Jf"+$ &,lN*Rg\ `n& $ "+,lNRgB*J"+AT$vNRg*Ap "N $@ f"+$ &,lNRg `,lN|)@NH)@pLllNu / o"/ QOH76,./H$NEZj  N*@Jf p)@p`-f)|p)@p`B&o$"-$ &,lN*RfN|)@N)@p`lJg-f `\$Kp *f "-vN Bp "N*@JgG` r gRe&o$* p" KN @Jf ` LlPONu /"//o H7*/ ,.N N*@Jf p)@p`XB&S"-$,lN"RfN|)@p)@p`* Jg Sg Sg ` ` І`"-t&,lNL`Nu /H.N N:*@Jfp`6-f("-,lN-g m N - g @NBpL`NuYOH/6*o,~|'A)HNE[-z&l$K|`$K&RR gJf f.pN &@Jfp `BB f)K`$*,R`* MJfS RN'@ fr )Apg)@`@ M"k fp0JgSg Sg Sg` <0gp`~`~`~/3g/2g/ 2g/2gD" t,lN,g4/ 2g"N k N`/ 2gB/'`2"N/2g." $<,lN(gP,,FrJ/'g4" $NF`*,<g/ 2g,<" $,lN(g 'G'D `&,lN|)@ + g @N< ,N)@pLlXONuJjDJj Da DNuaDDNuJj E\5Yy[DaDNu/HA4f"H@HAHB4g0H@40HB2$Nu/v AdQC AdYC A dUCJAkSC4HBBBHC604HAdSCЁr2HCH@A&$NuHp$g JfB`&HBHBBBւHAH@B@ЃLNu /H.*l|`2 -Jgf2H  lN`g "-,lN*URF f/NXOL`Nu8H 6&oP ,"K`Rr gr gr ggR$MXr"fVR K$$H`:r*f0Rpr0grg r g `B`T` `R`r"gJfRB`"$`Rgr g r gr fJgB E]J(Q mV ,f l`AC,/ICB8+B:*E؅XXJjjD7Dk*43HBB7Hש&)f4 , @f )i` hf!i ),xN.LL2V n8n&,g"Cn2",E`s6k f(EJRkB8*D匰oB8*kEH`&)gf"C`GBg<,Yf `0JjjF*7F7E5EzJFk42HBB5H&)#C XLL|Nu*8j ,8(",,xN:Jf )| `"@E#l)I#D#l &g(Yg$#CGX5|5E7EC7C`B5|D5D XLL|Nu /H.*l4` mN*U fKhpUf -g"- mAN M*P f L N o/ *HpN0 @Jf p )@p`!M 4)H4p*_Nu / o/ "*HRC R  mA r"mANtBEa+Z*_Nu / *oB B/MHo//AC N ^PO / grA"oAN*-f-gp` /*_ Nu/ "*HCR R  mArCNB*_NuBBHo//ACN PO /grACANp0gp` Nu / oYOH.*H|@rAҁ­f p`"o0 QX(j~DJg E=|-<`"J/:g E=|+<`J/9g E=| <|  JNn* /PfJg /E f uPjr/AP(/Po J "JNr0 J`Sd*/P܅ Sf/7fJPfB` /Pjp/@P|6p/6f"o0 QX x8` "o0 QX(/$rugZrofJ/8g E=|0<|  JN`>J/8g|0|x=|  JN*/$fAO`FAC~fJff/ /HmHz/ NO`/ /HmHmHz/ NO\&o / HxHmNO JfxHzN\XO/ N$.NLLN]NuUsage: fd2pragma .fd .h rError: Can't open .fd file '%s' wError: Can't open output file '%in}s' /%s*/ ##base _##bias ##public##private##endError: unknown command %s in .fd file0123456789ABCDEFError: Register spec %s unknown SysBase/*pragma syscall %s %x %s*/ /*pragma libcall %s %s %x %s*/ #pragma syscall %s %x %s #pragma libcall %s %s %x %s Warning: no ##end file in .fd file H02,o8 o"o$o &o$ /("/,$/0&/4NLL NuNuNuH0./&o,/ /N|XO$@ fp`6*gHxB/NO // /*NO *Jgp` L NupaH&o KJfS,ioio~Jg.SJm lBRB r` rHl>/N&PO"`Hl>HxNPO LNupaNUH0&m|A +HJgp%fp@dgP@ gW@g[@g`h m$X+H`N m(+HEzJk rASS`B-E` m(+H/HmN $POE/ NXO܀`nRSJm lBRB r`RpHl>/N.PO"`/NPO"` Hl>HxN L N]Nu0123456789ACDEFNUH'0&m$m ~|zp| r+At+BA@@+A+A+Hg,rA gWAgQAgUAfip^-`~`|` z`|R`r0fRAp*f RX+PR`Hm/ N POr.f"Rp*f RX+PR`Hm/ N POrlf |R`rhfRr@APglQAgzA gSAg$A gSAgLWAgUAgWAgN`J-g RX ` RX +@l rD+A -gr-` Jgr+`r ArrgRR/-/-N \PO+@ -Jjr+A -"-Ho4 m///-NO p-"- m`Sd -+@ѭA+HJg0| `&J-g RX ` RX +@`dJ-g RX ` RX +@J-g m0riq1+A+H//-N PO+@`2 -Jjp+@|J-g RX ` RX +@J-g m0xr+A+H//-N PO+@-gHmN`XO` RX"P+IfA+H mJfS+H -Jk&o"+@`p+@ RX @B-`p` -"-lt+B`Jg6Smp m/+H mNXO`SmHp-/ mNXO`Smp-/ mNXO`Smp m/+H mNXO` L N]NuNUH0&m$m +mJg4p%f"fR`/ Hm/ aO +@g$@`p/NXO`L N]NuNUH!2&m lr irbg r gr fR`g",RA$Hr"frR K$+Hr"gPr*f>Rp@Eg@ g` m+H` m +H` m+HR` m+H`R mB+H`N$gr gr g r gR`Jf`B`& ,f l `A)HJf|C$Mx,,,,<"l i$Hx(/(HlxN4O Ax"$<,lTN)@<)@Dr)A@)@L)AH+@,xN m"@#h~+@`*,lTN)@`!itt"" ((((( H ((((( H >/-Hx end then exit(0) end er.se unindent.seng'/* rexx to indent a marked block */ /* Get line of end of block */ 'BM "E"' options results 'GL' end = result options /* goto start of block */ 'BM "B"' 'BL' do forever /* Get line */ options results 'GT' options line = result /* get first char */ num = SUBSTR(line, 1, 3) if num = " " then 'DC DC DC' else if SUBSTR(line, 1, 1) = "09"x then 'DC' 'BL NL' /* check to see if done */ options results 'GL' options if result > end then exit(0) end mdevs.cprU /* Display the Devices in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 350 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(offset(nodebase,10),4)) opencnt = right(c2d(import(offset(nodebase,32),2),2),5) 'd "$'||c2x(nodebase)||nt||pri||opencnt||' \"'||namestr||'\""' nodebase = import(nodebase,4) end mport("00000004"x,4) liboff = 350 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(impog_ints.cprSx/* Display the Interrupts in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 364 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(importw$OM(offset(nodebase,10),4)) 'd "$'||c2x(nodebase)||nt||pri||' \"'||namestr||'\""' nodebase = import(nodebase,4) end n check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 364 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(importdlibs.cprtl/* Display the libraries in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = importN¡(import(offset(nodebase,10),4)) opencnt = right(c2d(import(offset(nodebase,32),2),2),5) 'd "$'||c2x(nodebase)||nt||pri||opencnt||' \"'||namestr||'\""' nodebase = import(nodebase,4) end ort("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import/Z ports.cprw/* Display the Ports in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 392 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(offsrJ!et(nodebase,10),4)) 'd "$'||c2x(nodebase)||nt||pri||' \"'||namestr||'\""' nodebase = import(nodebase,4) end _ints.cpr2ơ^ resources.cpr~"/* Display the Resources in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 336 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(v$U:offset(nodebase,10),4)) 'd "$'||c2x(nodebase)||nt||pri||' \"'||namestr||'\""' nodebase = import(nodebase,4) end n check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 336 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(RS$showprocess.cprR/* Usage: ShowProcess [ | 0xnnnnnnnn] Version 1.01 04-Nov-88 Displays the process structure for the given task. If none is specified, the current task under debugger control is displayed. ShowProcess will verify that the indicated task is a valid process before displaying the information. Note that because of the Amiga Scheduling, ShowProcess may not always be able to find a task specified by name. Output is displayed in the form: -------------------------------- 'RCAW' in wait state at priority 5 Type 13 Flags 00 IDNestCnt 0 TDNestCnt -1 Signal: Alloc 0000FFFF Wait 00000100 Recvd 00000000 Except 00000000 Trap: Data 00000000 Code 00FF47EA Alloc 8000 Able 0000 Except: Data 00000000 Code 00FC2FF0 Stack: Reg 0027368E Lower 00272BFC Upper 002736EC CPURegs: PC 00FC08F4 SR 0010 D: 0023D158 00000000 002721CC 00272778 00000009 00000052 00000057 00272B9C A: 00FF4134 00272B40 00C04EC8 00FF9FF2 00FF4648 00C00240 00C00276 PrFvocess Dependent --------------------------------------------- SegList $00200C6C StackSize $00000AF0 GlobVec $00C04EC8 TaskNum 0 StackBase $00272BFC Result2 0 CurrentDir $00000000 CIS $00000000 COS $00000000 ConsoleTask $0022F264 FileSysTask $00C00ADC CLI $00000000 ReturnAddr $002736E8 PktWait $00000000 */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-3<}0,0) address parse arg name '0x' tsk . NULL = "00000000"x if (name = '?') then do do i = 2 to 11 'd "'||strip(sourceline(i),'T',"0a"x) '"' end exit(0) end else if (name ~= '') then do taskbase = findtask(name) name = "'"||name||"'" end else if (tsk ~= '') then do name = right(tsk,8,'0') taskbase = x2c(name) name = '0x'||name end else do options results 'd a7 %08x' sp = left(result,8) 'tasks' tasklist = result o<=&ptions /* Now figure out where the stack pointer should be */ sp = c2x(offset(x2c(sp),-118)) place = index(tasklist,sp) if (place = 0) then place = 87 name = substr(tasklist, place-33, 8) taskbase = x2c(name) name = '0x'||name end statenm.0 = 'invalid' statenm.1 = 'added' statenm.2 = 'run' statenm.3 = 'ready' statenm.4 = 'wait' statenm.5 = 'except' statenm.6 = 'removed' type = c2d(import(offset(taskbase,8),1)) if (type ~= 13 & type ~= 1) then do 'd |' '"'||name 'is not a valid process"' exit(0) end name = "'"||import(import(offset(taskbase,10),4))||"'" state = c2d(import(offset(taskbase,15),1)) statename = statenm.state pri = c2d(import(offset(taskbase,9),1)) 'd' '"'||name 'in' statename 'state at priority' pri '"' flags = c2x(import(offset(taskbase,14),1)) idnest = c2d(import(offset(taskbase,16),1),1) tdnest = c2d(import(offset(taskbase,17),1),1) 'd' '"Type' type ' Flags' flags ' IDNestCnt' idnest O' TDNestCnt' tdnest '"' sigalloc = c2x(import(offset(taskbase,18),4)) sigwait = c2x(import(offset(taskbase,22),4)) sigrec = c2x(import(offset(taskbase,26),4)) sigexcept = c2x(import(offset(taskbase,30),4)) 'd' '"Signal: Alloc' sigalloc ' Wait ' sigwait ' Recvd' sigrec ' Except' sigexcept '"' trapdata = c2x(import(offset(taskbase,46),4)) trapcode = c2x(import(offset(taskbase,50),4)) trapalloc = c2x(import(offset(taskbase,34),2)) trapable = c2x(import(offset(taskbase,36),2) ) 'd' '"Trap: Data ' trapdata ' Code ' trapcode ' Alloc' trapalloc ' Able' trapable '"' excptdata = c2x(import(offset(taskbase,38),4)) excptcode = c2x(import(offset(taskbase,42),4)) 'd' '"Except: Data ' excptdata ' Code ' excptcode '"' sp = import(offset(taskbase,54),4) spreg = c2x(sp) splower = c2x(import(offset(taskbase,58),4)) spupper = c2x(import(offset(taskbase,62),4)) 'd' '"Stack: Reg ' spreg ' Lower' splower ' Upper' spupper '"' if (state >= 3 & state  [V<= 6) then do pc = c2x(import(sp, 4)) sr = c2x(import(offset(sp,4),2)) 'd' '"CPURegs: PC ' pc ' SR ' sr '"' dregs = c2x(import(offset(sp,6), 32)) dregs = insert(' ', dregs, 56); dregs = insert(' ', dregs, 48); dregs = insert(' ', dregs, 40); dregs = insert(' ', dregs, 32); dregs = insert(' ', dregs, 24); dregs = insert(' ', dregs, 16); dregs = insert(' ', dregs, 8); 'd' '"D:' dregs '"' aregs = c2x(import(offset(sp,38), 28)) aregs = insert(' ', aregs, 48); aregs = insert(' ', ar ձegs, 40); aregs = insert(' ', aregs, 32); aregs = insert(' ', aregs, 24); aregs = insert(' ', aregs, 16); aregs = insert(' ', aregs, 8); 'd' '"A:' aregs '"' end if type = 13 then do 'd' '"Process Dependent ----------------------------------------------"' seglist = "$"||c2x(d2c(c2d(import(offset(taskbase,128),4))*4,4)) stacksize = right(c2d(import(offset(taskbase,132),4)), 9) globvec = "$"||c2x(import(offset(taskbase,136),4)) 'd' '"SegList ' seglist ' StackSize ' stacksize ' { GlobVec ' globvec '"' tasknum = right(c2d(import(offset(taskbase,140),4)), 9) stackbase = "$"||c2x(d2c(c2d(import(offset(taskbase,144),4))*4,4)) result2 = right(c2d(import(offset(taskbase,148),4)), 9) 'd' '"TaskNum ' tasknum ' StackBase ' stackbase ' Result2 ' result2 '"' curdir = "$"||c2x(d2c(c2d(import(offset(taskbase,152),4))*4,4)) cis = "$"||c2x(d2c(c2d(import(offset(taskbase,156),4))*4,4)) cos = "$"||c2x(d2c(c2d(import(offset(taskbase,160),4))*4,4)) 'd' $k '"CurrentDir ' curdir ' CIS ' cis ' COS ' cos '"' contask = "$"||c2x(import(offset(taskbase,164),4)) filesys = "$"||c2x(import(offset(taskbase,168),4)) cli = "$"||c2x(d2c(c2d(import(offset(taskbase,172),4))*4,4)) 'd' '"ConsoleTask' contask ' FileSysTask' filesys ' CLI ' cli '"' retaddr = "$"||c2x(import(offset(taskbase,180),4)) pktwait = "$"||c2x(import(offset(taskbase,184),4)) 'd' '"ReturnAddr ' retaddr ' PktWait ' pktwait '"' end exit 0 /* Locat =Te a task in the system based upon the name */ findtask: parse arg name execbase = import("00000004"x,4) liboff = 420 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) if import(import(offset(nodebase,10),4)) = name then return nodebase nodebase = import(nodebase,4) end liboff = 406 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) if import(import(offset(nodebase,10),4)) = name then return nod\^:ebase nodebase = import(nodebase,4) end 'd' '"Could not find process' name||'"' exit(0) ("00000004"x,4) liboff = 420 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) if import(import(offset(nodebase,10),4)) = name then return nodebase nodebase = import(nodebase,4) end liboff = 406 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) if import(import(offset(nodebase,10),4)) = name then return nodcQ status.cpr8$| /* Show all CLI tasks */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address NULL = "00000000"x dosbase = findlib("dos.library") rootnode = import(offset(dosbase,34),4) tasktable = d2c(c2d(import(rootnode,4))*4,4) taskcount = c2d(import(tasktable,4)) do tasknum = 1 to taskcount proc = import(offset(tasktable,tasknum*4),4) if (proc ~= NULL) then do proc = offset(proc,-92) cv li = d2c(c2d(import(offset(proc,172),4))*4,4) command = 'No command loaded' args = '' if (cli ~= NULL) then do cmdname = d2c(c2d(import(offset(cli,16),4))*4,4) cmdlen = c2d(import(cmdname, 1)) if cmdlen ~= 0 then do command = 'Command:' import(offset(cmdname,1), cmdlen) cis = d2c(c2d(import(offset(cli,32),4))*4,4) cptr = d2c(c2d(import(offset(cis,12),4))*4,4) args = imporDt(cptr,80) args = translate(args,"'"||'0a0a'x,'"'||'0d00'x) y = pos('0a'x, args) if (y ~= 0) then args = left(args,y-1) end end 'd "Process' tasknum||': 0x'||c2x(proc) command args'"' end end exit(0) /* Find a given library in the system */ findlib: parse arg tofind execbase = import("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) namestr = import(5Nimport(offset(nodebase,10),4)) if namestr = tofind then return nodebase nodebase = import(nodebase,4) end 'd "Could not find' tofind||'"' exit(0) 1) end end 'd "Process' tasknum||': 0x'||c2x(proc) command args'"' end end exit(0) /* Find a given library in the system */ findlib: parse arg tofind execbase = import("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) namestr = import(bk  whichis.cprcp/* Usage: Whichis [ | 0xnnnnnn | n] Version 1.00 02-Nov-88 Identifies the CLI process associated with a given command, task number or task address */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg name '0x' tsk . NULL = "00000000"x if (name = '?') then do do i = 2 to 6 'd "'||strip(sourceline(i),'T',"0a"x) '"' end exit(0) end else if (name ~= '') th/ken do if datatype(name, 'W') then do clinum = name name = 'Process' name end else cliname = name end else if (tsk ~= '') then do name = right(tsk,8,'0') taskbase = x2c(name) name = '0x'||name end else do 'd "No task given to locate"' exit(0) end /* Show all CLI tasks */ dosbase = findlib("dos.library") rootnode = import(offset(dosbase,34),4) tasktable = d2c(c2d(import(rootnode,4))*4,4) taskcount = c2d(import(tanil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = importN}(import(offset(nodebase,10),4)) opencnt = right(c2d(import(offset(nodebase,32),2),2),5) 'd "$'||c2x(nodebase)||nt||pri||opencnt||' \"'||namestr||'\""' nodebase = import(nodebase,4) end ort("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import"z` memory.cpr>`/* Display the Memory regions */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address NULL = "00000000"x execbase = import("00000004"x,4) liboff = 322 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) attr = 'attr' c2x(import(offset(nodebase,14),2)) lower = 'lower' c2x(import(offset(nodebase,20),4)) upper = 'upper' c2x(import(offset(nodebase,24),4)) firsx,1t = import(offset(nodebase,16),4) free = 'free' c2d(import(offset(nodebase,28),4))||'.' 'd "'||c2x(nodebase) attr lower upper 'first' c2x(first) free||'"' do while (first ~= NULL) size = import(offset(first,4),4) 'd " ' c2x(first) ' size' c2x(size) '('||c2d(size)||'.)"' first = import(first,4) end nodebase = import(nodebase,4) end exit(0) lower = 'lower' c2x(import(offset(nodebase,20),4)) upper = 'upper' c2x(import(offset(nodebase,24),4)) firsª% makeaptr.cpr%i /* */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg addr if (~datatype(addr,'x')) then do 'd "Invalid hex number' arg '"' exit(0) end 'd "' c2x(d2c(c2d(x2c(addr))*4,4)) '"' exit(0)g makeaptr.cpr\Ԑ devices.cprU /* Display the Devices in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 350 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(offset(nodebase,10),4)) opencnt = right(c2d(import(offset(nodebase,32),2),2),5) 'd "$'||c2x(nodebase)||nt||pri||opencnt||' \"'||namestr||'\""' nodebase = import(nodebase,4) end mport("00000004"x,4) liboff = 350 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Open Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(impoǹ o#  execbase.cprKk/* Execbase: Dump the exec base information in the following form SoftVer 0 ChkSums: Library ??? SysBase ??? LowMem ??? Critical ??? ColdCapture $00000000 CoolCapture $00000000 WarmCapture $00000000 SysStkUpper $00C80000 SysStkLower $00C7E800 MaxLocMem $00080000 DebugEntry $00FC237E DebugData $00000000 AlertData $00000000 ThisTask $002478A0 SysFlags $0000 IdleCount 14183 DispCount 30567 Quantum 16 Elapsed 16 IDNestCnt Ì -1 TDNestCnt -1 TrapCode $00FC2FF0 ExceptCode $00FC2FF0 ExitCode $00FC1D28 SigAlloc $0000FFFF TrapAlloc $8000 */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) softver = c2d(import(offset(execbase,34),2)) 'd "SoftVer ' softver'"' coldcapt = '$'c2x(import(offset(execbase,42),4)) coolcapt = '$'c2x(import(offset(execbase,46),ʔ2.4)) warmcapt = '$'c2x(import(offset(execbase,50),4)) 'd "ColdCapture' coldcapt ' CoolCapture' coolcapt ' WarmCapture' warmcapt'"' stkupr = '$'c2x(import(offset(execbase,54),4)) stklwr = '$'c2x(import(offset(execbase,58),4)) maxmem = '$'c2x(import(offset(execbase,62),4)) 'd "SysStkUpper' stkupr ' SysStkLower' stklwr ' MaxLocMem ' maxmem'"' dbgentr = '$'c2x(import(offset(execbase,66),4)) dbgdata = '$'c2x(import(offset(execbase,70),4)) alrtdata = '$'c2x(import(offset(execbase,74),4))M ' d "DebugEntry ' dbgentr ' DebugData ' dbgdata ' AlertData ' alrtdata'"' thistask = '$'c2x(import(offset(execbase,276),4)) sysflags = '$'c2x(import(offset(execbase,292),2)) 'd "ThisTask ' thistask ' SysFlags ' sysflags'"' idlecnt = right(c2d(import(offset(execbase,280),4)),9) dispcnt = right(c2d(import(offset(execbase,284),4)),9) 'd "IdleCount ' idlecnt ' DispCount ' dispcnt'"' quantum = right(c2d(import(offset(execbase,288),2)),9) elapsed = right(c2d(import(offset(è (xecbase,290),2)),9) 'd "Quantum ' quantum ' Elapsed ' elapsed'"' idnest = right(c2d(import(offset(execbase,294),1),1),9) tdnest = right(c2d(import(offset(execbase,295),1),1),9) 'd "IDNestCnt ' idnest ' TDNestCnt ' tdnest'"' trapcode = '$'c2x(import(offset(execbase,304),4)) excpcode = '$'c2x(import(offset(execbase,308),4)) exitcode = '$'c2x(import(offset(execbase,312),4)) 'd "TrapCode ' trapcode ' ExceptCode ' excpcode ' ExitCode ' exitcode'"' sigaloc = '$'c2x(import(osRffset(execbase,316),4)) trapaloc = '$'c2x(import(offset(execbase,320),2)) 'd "SigAlloc ' sigaloc ' TrapAlloc ' trapaloc'"' attnflg = '$'c2x(import(offset(execbase,296),2)) attnsch = '$'c2x(import(offset(execbase,298),2)) lastalrt = '$'c2x(import(offset(execbase,514),4)) 'd "AttnFlags ' attnflg ' AttnResched ' attnsch ' LastAlert ' lastalrt'"' exit(0)ase,312),4)) 'd "TrapCode ' trapcode ' ExceptCode ' excpcode ' ExitCode ' exitcode'"' sigaloc = '$'c2x(import(o"*E^ rsrcs.cpr~"/* Display the Resources in the system */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 336 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(v$U:yoffset(nodebase,10),4)) 'd "$'||c2x(nodebase)||nt||pri||' \"'||namestr||'\""' nodebase = import(nodebase,4) end n check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 336 nodebase = import(offset(execbase, liboff), 4) 'd " Address NT Pri Name"' do while(import(nodebase,4) ~= "00000000"x) nt = right(c2d(import(offset(nodebase,8),1),1),3) pri = right(c2d(import(offset(nodebase,9),1),1),4) namestr = import(import(\v regions.cprҢTJ /* Display the Memory regions */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) liboff = 322 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= "00000000"x) attr = 'attr' c2x(import(offset(nodebase,14),2)) lower = 'lower' c2x(import(offset(nodebase,20),4)) upper = 'upper' c2x(import(offset(nodebase,24),4)) first = 'first' Suc2x(import(offset(nodebase,16),4)) free = 'free' c2d(import(offset(nodebase,28),4))||'.' 'd "'||c2x(nodebase) attr lower upper first free||'"' nodebase = import(nodebase,4) end exit(0)004"x,4) liboff = 322 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= "00000000"x) attr = 'attr' c2x(import(offset(nodebase,14),2)) lower = 'lower' c2x(import(offset(nodebase,20),4)) upper = 'upper' c2x(import(offset(nodebase,24),4)) first = 'first' cmods.cprlr/* Display system resident modules */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address execbase = import("00000004"x,4) reslist = import(offset(execbase,300),4) 'd "Address Pri Type Name"' do forever mod = import(reslist,4) if mod = "00000000"x then leave priority = right(c2d(import(offset(mod,13),1),1),4) type = right(c2d(import(offset(mod,12),1),1),3) name = import(impo&rt(offset(mod,18),4)) name = strip(translate(name,"0a"x,"0d"x),'t', "0a"x) 'd "$'||c2x(mod) priority type name'"' reslist = offset(reslist,4) end exit(0)address execbase = import("00000004"x,4) reslist = import(offset(execbase,300),4) 'd "Address Pri Type Name"' do forever mod = import(reslist,4) if mod = "00000000"x then leave priority = right(c2d(import(offset(mod,13),1),1),4) type = right(c2d(import(offset(mod,12),1),1),3) name = import(impo- dbstr.cpr'/* DBSTR -- Dump memory as bytes for a given BSTR DBSTR ( |

| ) >dbstr var /* Dumps the BSTR pointed to by var */ >dbstr 0x82034 /* Dumps the BSTR at location 0x002080d0 */ Note that a BSTR is an address shifted right 2 pointing to a buffer with a preceeding length byte. */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg expr if (exprӿ = '?') then do do i = 2 to 7 'd "' strip(sourceline(i),'T', "0a"x) '"' end exit(0) end options failat 3 options results 'd ' expr '"%d"' stat = rc val = strip(result,'T',"0a"x) options if (stat ~= 0) then do 'd "Error: can''t find' expr '"' exit(0) end val = strip(val) say val bptr = d2c(c2d(d2c(val))*4,4) bstr = import(offset(bptr,1),c2d(import(bptr,1))) do forever y = verify(bstr, '"'||'0a0d00'x,'m') if y = 0 then leave c = substr(bstr,y,1) a if c = '"' then bstr = left(bstr,y-1)||'\'||'05'x||substr(bstr,y+1) else bstr = left(bstr,y-1)||'\\'||translate(c,'nr0','0a0d00'x)||substr(bstr,y+1) end bstr = translate(bstr, '"', '05'x) 'd "0x'||c2x(bptr)||': \"'||bstr||'\""' exit(0) ''t find' expr '"' exit(0) end val = strip(val) say val bptr = d2c(c2d(d2c(val))*4,4) bstr = import(offset(bptr,1),c2d(import(bptr,1))) do forever y = verify(bstr, '"'||'0a0d00'x,'m') if y = 0 then leave c = substr(bstr,y,1)  NO showcli.cprM/* Usage: ShowCLI [ | 0xnnnnnn | n] Version 1.00 02-Nov-88 Dumps the CLI structure for a given command, process address or task address */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg name '0x' tsk . NULL = "00000000"x if (name = '?') then do do i = 2 to 6 'd "'||strip(sourceline(i),'T',"0a"x) '"' end exit(0) end else if (name ~= '') then do YCE if datatype(name, 'W') then do clinum = name name = 'Process' name end else cliname = name end else if (tsk ~= '') then do name = right(tsk,8,'0') taskbase = x2c(name) name = '0x'||name end else do options results 'd a7 %08x' sp = left(result,8) 'tasks' tasklist = result options /* Now figure out where the stack pointer should be */ sp = c2x(offset(x2c(sp),-118)) place = index(tasklist,sp) if (plaޤn%:ce = 0) then place = 87 name = substr(tasklist, place-33, 8) taskbase = x2c(name) name = '0x'||name end /* Show all CLI tasks */ dosbase = findlib("dos.library") rootnode = import(offset(dosbase,34),4) tasktable = d2c(c2d(import(rootnode,4))*4,4) taskcount = c2d(import(tasktable,4)) do tasknum = 1 to taskcount proc = import(offset(tasktable,tasknum*4),4) if (proc ~= NULL) then do proc = offset(proc,-92) cli = d2c(c2d(import(offset(proc,172),4))t*4,4) command = 'No command loaded' module = '' if (cli ~= NULL) then do cmdname = d2c(c2d(import(offset(cli,16),4))*4,4) cmdlen = c2d(import(cmdname, 1)) module = import(offset(cmdname,1), cmdlen) if cmdlen ~= 0 then command = 'Loaded as command:' module "0x"||c2x(proc) end if (proc = taskbase | module = cliname | tasknum = clinum) then do 'd "Process' tasknum||':' command '"'n /* Now dump the CLI Structure */ pbstr = d2c(c2d(import(offset(cli,24),4))*4,4) prompt = import(offset(pbstr,1),c2d(import(pbstr,1))) 'd "Prompt : \"' || prompt || '\""' cbstr = d2c(c2d(import(offset(cli,4),4))*4,4) curdir = import(offset(cbstr,1),c2d(import(cbstr,1))) 'd "Currentdir : \"' || curdir || '\""' ebstr = d2c(c2d(import(offset(cli,36),4))*4,4) execfile = import(offset(ebstr,1),c2d(impo zrt(ebstr,1))) 'd "ExecuteFile: \"' || execfile || '\""' rslt2 = right(c2d(import(cli,4)),8) retc = right(c2d(import(offset(cli,12),4)),8) stack = c2d(import(offset(cli,52),4))*4 'd "Result2: ' rslt2 ' ReturnCode: ' retc ' Stack:' stack '"' faillev = right(c2d(import(offset(cli,20),4)),8) interactive = "NONInteractive" if (import(offset(cli,40),4) ~= NULL) then interactive = "Interactive " tyՏpe = "Foreground" if (import(offset(cli,44),4) ~= NULL) then type = "Background" 'd "FailLevel: ' faillev ' ' interactive ' ' type '"' stdin = '$'||c2x(d2c(c2d(import(offset(cli,28),4))*4,4)) curin = '$'||c2x(d2c(c2d(import(offset(cli,32),4))*4,4)) redir = '' if (stdin ~= curin) then redir = ' ' 'd "StdInput: ' stdin ' CurrentInput: ' curin redir'"' stdout = '$'||c2x(d2c(c2d(import(offset(cli,48),4))*4,4)) curout = '$'||c2x(d2c(c2d(import(offset(cli,56),4))*4,4)) redir = '' if (stdin ~= curin) then redir = ' ' 'd "StdOutput:' stdout ' CurrentOutput:' curout redir'"' seglist = '$'||c2x(d2c(c2d(import(offset(cli,60),4))*4,4)) path = '$'||c2x(d2c(c2d(import(offset(cli,8),4))*4,4)) 'd "Seglist: ' seglist ' Path: ' path '"' exit(0) end end end 'd "Unable to wM find' name '"' exit(0) /* Find a given library in the system */ findlib: parse arg tofind execbase = import("00000004"x,4) liboff = 378 nodebase = import(offset(execbase, liboff), 4) do while(import(nodebase,4) ~= NULL) if import(import(offset(nodebase,10),4)) = tofind then return nodebase nodebase = import(nodebase,4) end 'd "Could not find' tofind||'"' exit(0) 'd "Seglist: ' seglist ' Path: ' path '"' exit(0) end end end 'd "Unable to2 dbptr.cpr殌`x/* DBPTR -- Dump memory as bytes for a given BPTR (1 byte hex values with text) DBPTR ( |
| ) >dbptr var /* Dumps 64 bytes pointed to by BPTR var */ >dbptr var l 10 /* Dumps 10 bytes pointed to by BPTR var */ >dbptr 0x82034 /* Dumps 64 bytes from location 0x002080d0 */ >dbptr 0x82034 l 5 /* Dumps 5 bytes from location 0x002080d0 */ Note that a BPTR is an address shifted right 2. */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address parse arg expr ' l ' len ' L ' len2 if (expr = '?') then do do i = 2 to 9 'd "' strip(sourceline(i),'T', "0a"x) '"' end exit(0) end options failat 3 options results 'd ' expr '"%d"' stat = rc val = strip(result,'T',"0a"x) options if (stat ~= 0) then do 'd "Error: can''t find' expr '"' exit(0) end val = strip(val) if (~datatype(val,'x')) then do o2 'd " ^------------should be an ''address''"' exit(0) end lenspec = '' if (len ~= '') then lenspec = 'l' len if (len2 ~= '') then lenspec = 'L' len2 'db 0x'|| c2x(d2c(c2d(x2c(val))*4,4)) lenspec exit(0) T', "0a"x) '"' end exit(0) end options failat 3 options results 'd ' expr '"%d"' stat = rc val = strip(result,'T',"0a"x) options if (stat ~= 0) then do 'd "Error: can''t find' expr '"' exit(0) end val = strip(val) if (~datatype(val,'x')) then do .| avail.cpr<6/* */ address 'COMMAND' 'version >nil: exec.library 36 ' lrc = rc if (rc = 0) then check = addlib('rexxsupport.library',0,-30,0) address 'd "' || storage() 'bytes free"' exit(0) showcli.cprBܖ  Online_HelppXNhelp%+     Ekse.guide!i@database se.hyper Copyright (c) 1992 SAS Institute, Inc, Cary, NC All Rights Reserved @node main "SAS/C Screen Editor Help" @{" Getting Around " link "getting around"} @{" Build Project " link build} .. Rt-Amga-B @{" Block Functions " link block} @{" Opening Windows " link openw} @{" Compile File " link compile} .. F4 Beg of Block .. Ctrl-[ @{" Macro Definitions " link macro} Set Options ..... Ctrl-F4 End of Block .. Ctrl-] @{" Menus " link menuk} Next Error ...... F5 Copy Block .... Rt-Amga c @{" Miscellaneous " link misc} @{" Look Up Symbol " link look} . Keypad ( Delete Block .. Rt-Amga d Beginning of File ........... Ctrl-Home @{" Search " link search} ............... Ctrl-S End of File ................. Ctrl-End @{" Search and Replace " link replace} ... Ctrl-R @{" Go to Line Number " link gotoline} .......... Ctrl-L Search Again .......... Alt-S Exit SE ..................... F3 vҙ@{" Delete/Insert " link delete} @{" Undo Last Change " link undo} ........... Ctrl-U Delete Line ............ Ctrl-Y @{" Open New Shell " link fork} ........... Ctrl-F Delete to End of Line .. Ctrl-E Start/End Macro Definition .. Alt n Restore Deleted Line ... Alt-Y Replay macro number n ....... Alt Fn @{" Configuration Screen " link config} .. Ctrl-M @{" Common Problems with SE " link sc:help/sc_prob.guide/se} @endnode @node "GettiOng Around" Beginning of File ...... Ctrl-Home @{" Opening Windows " link openw} End of File ............ Ctrl-End Open Window ............ Ctrl-O Next Line .............. Down Arrow Change Window .......... Ctrl-F6 Previous Line .......... Up Arrow Cycle through Windows .. F6 Beginning of Line ...... Home Window Front to Back ... F10 End of Line ............ End Next Character ......... Right Arrow @{" Go to Line Number " link gotƿ=oline} ..... Ctrl-L Previous Character ..... Left Arrow Next Word .............. Ctrl-(NUM 6) Previous Word .......... Ctrl-(NUM 4) Next Page .............. Pg Dn Previous Page .......... Pg Up Scroll Up .............. Ctrl-(NUM 8) Scroll Down ............ Ctrl-(NUM 2) Go to Line Number ...... Ctrl-L @endnode @node OpenW "Opening New Windows" When the open a new window command is executed by typing in a Ctrl-o or by selecting Open Window from the Windows pull-down menu, a file requestor is displayed to give you an opportunity to specify a new file to edit. The screen area of the current window is split in half and the window is reframed to insure that the current character position of the active window is displayed. The new window is opened and the cursor is placed at the first character position of the new text. You may have 9 windows open at one time. @endnode @node Macro "Macro Definitions" A macro is a series of keystrokes that may be defined to a single key. You may have up to 10 macros assigned to function keys at any one time. The macros are assigned to keys F1-F10. The macros are assigned by hitting ALT- at the beginning and the end of the assignment, and are invoked by hitting ALT-F. For example, to assign a macro to F1, hit ALT-1. Then you are prompted to enter the key sequence. Hit the keys that you want to be in your macro. When you are finished, hit ALT-1 again to end capturing the macro. To invoke the macro, hit ALT-F1. All of the stored key sequences will then be invoked. If you need more than 10 macros, you may re-assign macros key sequences other than ALT-Fx. This feature essentially gives you the ability to assign as many macros as you like. Macros may be @{" saved " link savem} to a file, and then later @{" read " link loadm} back in. @endnode @node SaveM "Save Macros" The Save Macro command lets you specify a file in which to save your current set o nc7f macros. The default name is SE.MAC which is automatically loaded when SE is started up. There may be 10 macros active at any one time. The default filename extension for a macro is ".MAC". SE will search your current directory for a macro file so that different default macro files may be kept in different directories, if desired. To invoke a keyboard macro, press Alt and the funtion key with the number of the macro (ie Alt-F1 invoke macro 1). To define a macro, press ALT and  6!the number of the macro. @endnode @node LoadM "Load Macros" The load macro command asks you to specify a file that contains a set of macros. The file SE.MAC from the current directory is loaded when SE starts executing. There may be 10 macros active at any one time. The default filename extension for a macro is ".MAC". SE will search your current directory for a macro file so that different default macro files may be kept in different directories, if desired. To invoke a keyboa 6rd macro, press Alt and the funtion key with the number of the macro (ie Alt-F1 invoke macro 1). To define a macro, press ALT and the number of the macro. @endnode @node menu "Menus" The SAS/C editor provides several ways to accomplish many common tasks. The first way is through the pull-down menus located at the top of the se screen. The second way is through "shortcuts", quick-key sequences listed beside the functions in the pull down menus. These shortcuts make it easy to quic qkly accomplish tasks once a user is familiar with the editor. The final way is through menus appearing at the bottom of the screen of the editor. These menus are made up of single characters representing a function. A description of each function is shown below the menu when a menu item is highlighted by the cursor. These menus are intended for novice users who need extra assistance. The menu items may be selected either by moving the cursor to highlight the item and pressing re o3$turn, or by typing in the first letter of the menu item. The following is a list of all of the command line menus: @{" Main Menu " link "Main Menu"} ............. F2 @{" Project Menu " link project} ............. Ctrl-p @{" Block Menu " link block} ............. Ctrl-b @endnode @node "Main Menu" The main menu is invoked with F2. Menu Selection Action Alternate ----------------- ---Mtj--------------------------- --------------- B "Block" Invoke Block Menu (Ctrl-b) C "Compile" Compile the current file (F4) F "Fork" Fork a new shell (Ctrl-f) M "Mode" Invoke Configuration Screen (Ctrl-l) L "Line" Go to line number (Right Amiga-l) O "Open" Open a second window (Ctrl-o) P "Project" Invoke Project Menu (Z^Ctrl-p) R "Replace" Search and Replace (Ctrl-r) S "String" Search (Ctrl-s) Q "Quit" Exit SE and don't save changes (Right Amiga-q) U "Undo" Undo last action (Right Amiga-u) @endnode @node Project "Project Menu" Menu Selection Action Alternate ----------------- --------------------------------------- ------------ Quit Close the c[urrent window. If Only one Rt-Amiga q window is present, exit SE. Save Save the file in the current window and Rt-Amiga s close that window. If only one window is present, exit SE. Continue Save the file in the current window and Rt-Amiga w continue editing Next Save the current file and prompts for Rt-Amiga n a new file. If no new file is specifieEzd, SE will close that window. Open Abandon the current file and prompt for Rt-Amiga o a new file Rename Prompt for a new name for the current file. Insert Insert a file at the cursor Display Display the filenames of all files in memory Macros Go to the Macro menu (Save and Load) @endnode @node Block "Block Menu" The Block Menu is invoked with Ctrl-b. Before using any block command, the blo%ck must be first be marked. Blocks may be marked either with the Ctrl-[ (begin block) and Ctrl-] (end block) commands or by holding down the left mouse button and dragging. The following table describes the functions available in the Block Menu, and it also lists shortcuts where they exist. Menu Selection Action Alternate ----------------- --------------------------------------- ------------ Copy Copy marked block at the cursor d Rt-Amiga c Delete Delete marked block Rt-Amiga d Move Insert marked block at the cursor and Rt-Amiga m delete it from its previous position Print Send the marked block to the PRN: device @{" Read " link bread} Read a file at the cursor @{" Write " link bwrite} Write the marked block to a file Beginning Move the cursor to the beginning of the block E13nd Move the cursor to the end of the block @endnode @node BWrite "Block Write" Write requests the name of a file. It then writes the previously marked block of text to that file. No change is made to the text. @endnode @node BRead "Insert File" Unlike the other block commands, the insert file command, also called the block read command, does not act on a previously marked block. Read requests a filename and then inserts the text of that file into the current text at theVL cursor position. If the file does not exist, an error message is displayed. @endnode @node MISC "Miscellaneous Functions" Context Sensitive Help ... F1 @{" Open Window " link openw}............. Ctrl-O Toggle Insert Mode ....... NUM 0 Change Window ............ Ctrl-F6 Interlace Toggle ......... NUM-ENTER Cycle through Windows .... F6 Escape Character ......... Ctrl-\ Window Front to Back ..... F10 Change Foreground Color .. F7 Toggle DPisplay Size ...... F9 Change Background Color .. F8 Match [], {}, or () ..................... Ctrl-5 Save Current File and Continue .......... Rt-Amiga-w Save Current File and Close Window ...... Rt-Amiga-s Save Current File and Open New file ..... Rt-Amiga-n Abandon Current File and Open New file .. Rt-Amiga-o @endnode @node Build "Build Project" Hitting Right-Amiga B to invoking Build is the same as clicking on the Build icon in a SAS/C Project directory under Workbench. Tt=<;:9876543210/.-,+*)('&%$#"! pk sc_prob.guidef@database sc_prob Copyright (c) 1992 SAS Institute, Inc, Cary, NC All Rights Reserved @master sc:help/sc_prob.guide @node main "Common Problems" This help screen contains information about some of the problems that people frequently have with the compiler. The button "Changes to the Documentation" leads to a help screen which documents last minute changes to functionality, errors in the documentation that we didn't have time to correct, and any other information about the produ)Oct that we think that you should know. Most of this information can also be found in the read.me file on disk 1. THE LAST MINUTE CHANGES HELP SCREEN IS THE ONLY PLACE WHERE THIS INFORMATION CAN BE FOUND. Please review both that screen and this screen carefully before calling technical support. @{" Problems Compiling " link "compile"} @{" Problems Linking " link "link"} @{" Problems using CodePRobe (CPR) " link "cpr"} @{" Problems w[ith Library Functions " link "lib"} @{" Problems using the Editor (SE) " link "se"} @{" Miscellaneous Problems " link "misc"} @{" Changes to the Documentation " link "sc:help/sc_change.guide/main"} @endnode @node compile " Problems Compiling " @{" Problem 1 " link prob1} I have installed my compiler correctly, but I keep getting the message "se not found" or "sc not found" whenever I try to do anything. @{" Problem 2 " linkR4 prob2} After switching to Version 6, my old programs will not compile, or they compile with a lot of warning messages. Why is this happening and how can I fix it? @{" Problem 3 " link prob3} When I compile, the options I requested do not act as expected. @{" Problem 4 " link prob4} During compilation, I get the message "semi-colon expected" in a header file. @{" Problem 5 " link prob5} I keep getting the message "Error 25: Modifiable lvalue Hc; required", but I am declaring all my variables for a function just like it says in the library reference manual. @endnode @node prob1 "Compiler Problem 1" I have installed my compiler correctly, but I keep getting the message "se not found" or "sc not found" whenever I try to do anything. _______________________________________________________________________ Your s:user-startup may not be set up correctly. The installation program places three assign statem|Ϗents and the path statement at the end of your s:user-startup file. If you are invoking any programs that create a new Shell (such as PopCLI) in your s:user-startup file before the path sc:c add statement, sc:c may not be in new shells created by the program. To correct the problem, move the three assign statements and the path statement above any calls to programs that create a new Shell. If you are running under AmigaDOS Version 1.3, you may have a different problem. The instaluc^lation program places the necessary assigns in a file named s:user-startup, which is called from s:startup-sequence. You may have to edit s:startup-sequence and make some changes. See Chapter 1, "Installing Your SAS/C Development System," for information on modifying your startup file. @endnode @node prob2 "Compiler Problem 2" After switching to Version 6, my old programs will not compile, or they compile with a lot of warning messages. Why is this happening and how can I fix it? _______________________________________________________________________ There are two solutions: In Version 6, the compiler assumes that your code will provide prototypes for all functions. (In Version 5, you had to specify the -cf option for the compiler to identify missing prototypes.) If your code does not define prototypes for all functions, the compiler may produce several warning 100, 154, and 161 messages. Specify @{" ignore " link sc:help/sc.guide/ignore} = 100+154+161 t s\o suppress these warnings, or use the @{" genprotos " link sc:help/sc.guide/genproto} option to generate prototypes for your functions and #include the resulting header file. Unlike previous versions, the header files and libraries for Version 6 of the SAS/C Compiler are ANSI-compliant. The ANSI specifications affect both ANSI and non-ANSI functions and data names, so some non-ANSI functions and data names have also changed. Convert your program to use the new ANSI-compliant libra 7"ries and headers. For any functions mentioned in error messages, read the description of the function in the SAS/C Development System Library Reference. This reference manual describes the parameter list, return value, and necessary header files required by each function. Make sure that you are including the correct header for each of the SAS/C or AmigaDOS functions that you are calling. @endnode @node prob3 "Compiler Problem 3" When I compile, the options I requested do not act  ^#1as expected. _______________________________________________________________________ When you compile your program, whether you compile from the Shell or the Workbench screen, the compiler looks for an scoptions file in your current directory. If it does not find one, it looks for the file ENV:sc/scoptions. If it finds either of these files, it uses any additional options specified in the file. You can run the @{" scopts " link sc:help/sc_util.guide/scopts} utility or edit the sc loptions file to review the options specified in these files. If you want to prevent the compiler from reading the options specified in any scoptions file, specify the @{" resetoptions " link sc:help/sc.guide/resetoptions} option as the first option in the sc command. If your program then runs as expected, you have a problem with the options that you have specified. If you specify the @{" verbose " link sc:help/sc.guide/verbose} option, the compiler tells you the location of the sco  "ptions file used. @endnode @node prob4 "Compiler Problem 4" During compilation, I get the message "semi-colon expected" in a header file. _______________________________________________________________________ Check for extra characters at the beginning of your file in front of your #include statements or in one of your header files. You may have accidentally pressed a key while starting the editor. @endnode @node prob5 "Compiler Problem 5" I keep getting the message @{" Error 25!s]: Modifiable lvalue required " link sc:help/scmsg.guide/scm025}, but I am declaring all my variables for a function just like it says in the library reference manual. _______________________________________________________________________ Do not include the const keyword in your declarations. The SAS/C Development System Library Reference contains many variables defined with the const keyword, especially pointers to strings. This keyword is required by the ANSI Standard and indica":tes that these variables will not be modified in the library function to which they are passed. The const keyword is present in the parameter list of the prototype that is found in the associated header file. This prototype, not the declaration you should include in your program, is what is described in the synopsis for each function in the SAS/C Development System Library Reference. Use the synopsis as a guideline for your declarations, but do not include the const keyword. If y#O,ou are not using the const keyword, then it is possible that there is an error in the documentation. If you suspect that this is the case, you can check it yourself by looking at the specified header file, or you may contact Technical Support. If you do discover an error, please contact Technical Support so that the error may be corrected with the next release. @endnode @node link " Problems Linking " @{" Problem 1 " link linkprob1} When I compile and link, I get messages reportin$D+g "Undefined Symbol: _CXnnn" and saying that the proper math library has not been included. @{" Problem 2 " link linkprob2} I am getting BLTN and/or CXERR errors, and I am using math libraries and header files. @{" Problem 3 " link linkprob3} When I link my project, I get undefined symbols. This code worked in Release 5.10. @{" Problem 4 " link linkprob4} I get the message "absolute reference to " from the linker. @endnode @n%Iode linkprob1 "Linker Problem 1 " When I compile and link, I get messages reporting "Undefined Symbol: _CXnnn" and saying that the proper math library has not been included. _______________________________________________________________________ In your program, you have accessed floating-point math routines, but you have not linked with the appropriate math library. Specify the appropriate math option for the library with which you want to link, such as @{" math=standard " link sc& z:help/sc.guide/math}. If you are using the @{" link " link sc:help/sc.guide/link} option to link your program, the compiler links with the correct math library. If you call the linker separately from the compiler, you must specify the correct math library in the slink command after the libs keyword. Refer to SAS/C Development System Library Reference, Version 6.0 for more information about math libraries. @endnode @node linkprob2 "Linker Problem 2 " I am getting BLTN and/or CXERR'TY errors, and I am using math libraries and header files. _______________________________________________________________________ You may be including the math header files for one type of floating-point format and linking with libraries for another type of floating-point format. For example, you may be including m68881.h and linking with scmffp.lib. Different floating-point formats are incompatible and should not be mixed. Make sure that your included header files match the math (mclibrary with which you are linking. If you find no problem with the compatibility between your header files and your math library, contact the Technical Support Division. @endnode @node linkprob3 "Linker Problem 3 " When I link my project, I get undefined symbols. This code worked in Release 5.10. _______________________________________________________________________ Some of the library symbol names have been changed to comply with the ANSI Standard for symbol names. The ANSI S)I'/Ntandard states that any symbols that are not mandated by the Standard must begin with an underscore and a capital letter or two underscores. When you compile your program, the compiler adds an additional underscore to the beginning of any symbols defined in C code. Therefore, a C symbol with two underscores has three underscores when the linker finally sees the symbol. If your code refers to a symbol that has changed names from Version 5 to Version 6, the linker may produce an unde*eFVfined symbol message when you link your program. If you receive this message, first check the SAS/C Development System Library Reference for different versions of the symbols with different numbers of underscores. Remember, the linker reports one more underscore on the symbol than the SAS/C Development System Library Reference shows. Change your C code to refer to the new name for the symbol as described in the SAS/C Development System Library Reference. If this solution is not p+ractical because of the number of references to the symbol, you can solve this problem in one of two other ways: - Use the define option on the sc command or a #define statement in a header file to define the old name to the new name. - Use the define option on the slink command to force all references to one of the names to refer to the other. If you define the item in your code (in other words, you declare it without the extern keyword), you should use ,Hthe define option to define the new name (used by the library) to the old name (used by your code). If you declare the item with the extern keyword and, therefore, use the library definition for the item, use the define option to define the old name (used by your code) to the new name (used by the library). One very common technique used in Version 5 was to declare the main routine of your program as _main instead of main to bypass the overhead required to set u-Zp stdio and argument parsing. You should change this name to __main and add the keyword __stdargs to be compatible with Version 6. If you do not change this name, the linker issues a message saying that the symbol _main is undefined. (Remember, the linker puts in an extra underscore, so the symbol it is really looking for is main). @endnode @node linkprob4 "Linker Problem 4 " I get the message "absolute reference to " from the linker. _______________________________________.Ё{$________________________________ You are linking a resident program with the cres.o startup module, or you are creating a resident library, but the linker detected a reference to an absolute symbol. Make sure that the symbol being referenced is not being modified. If the item is not being modified, then you can ignore the warning message. @endnode @node cpr " Problems using CodePRobe (CPR) " @{" Problem 1 " link cprprob1} I do not get all of the information I exp/vNect out of CodeProbe, or CodeProbe does not know about variables and functions it should know about. @{" Problem 2 " link cprprob2} CodeProbe does not work if I double-click on the Debug icon from the WorkBench screen. @endnode @node cprprob1 "CPR Problem 1 " I do not get all of the information I expect out of CodeProbe, or CodeProbe does not know about variables and functions it should know about. ________________________________________________0:?q _______________________ You may not be compiling with the correct debug option. If you are compiling with @{" nodebug " link sc:help/sc.guide/debug} or @{" debug=line " link sc:help/sc.guide/debug}, try compiling with @{" debug=sf " link sc:help/sc.guide/debug}. For a complete description of each debug option, see Chapter 8, "Compiling and Linking Your Program." @endnode @node cprprob2 "CPR Problem 2 " CodeProbe does not work if I double-click on the Debug icon from the WorkBench1 screen. _______________________________________________________________________ To invoke CodeProbe from the WorkBench screen, click on the Debug icon. Then, hold down the Shift key and double-click on the icon for your program's executable module. @endnode @node lib " Problems with Library Functions " @{" Problem 1 " link libprob1} printf (or sprintf, fprintf, and so on) does not print the correct values. @{" Problem 2 " link libprob2} getchar does no25t work as expected. @{" Problem 3 " link libprob3} My program compiles and links without errors, but I am getting the wrong results from some of my SAS/C function calls. @{" Problem 4 " link libprob4} I am using the asctime function to convert the time to Greenwich Mean Time (GMT) correctly, but the result is exactly an hour (or two or three...) off. @{" Problem 5 " link libprob5} I wrote a replacement function for one of the SAS/C library  3@e routines, but the library routines don't seem to be using my replacement function. @endnode @node libprob1 "Library Problem 1 " printf (or sprintf, fprintf, and so on) does not print the correct values. _______________________________________________________________________ This problem can happen for one or more of the following reasons: - You are asking @{" printf " link sc:help/sc_lib.guide/printf()} to print a variable, but the variable conversion !4 dcharacters are incorrect. For example, you are trying to print a long integer using %d as the conversion character. A long variable requires a %ld if the shortint compiler option is active. Often, if you have one conversion character wrong, the rest of the line you are printing is also incorrect. Check your entire printf (or @{" fprintf " link sc:help/sc_lib.guide/fprintf()}, etc.) format string carefully. - You are trying to print a float or a "5\%double, but you have not linked with the proper math library. You must link with a floating point math library to perform any floating point operations. If you are linking with a floating point library, make sure that it is positioned in your slink command line before sc.lib so that the linker can find the correct version of printf. If you specify the link option in the sc command, the compiler links the libraries in the correct order. If #6you specify the link option, you must still use the @{" math= " link sc:help/sc.guide/math} option to specify a math libary. - You are linking with amiga.lib before the math library and sc.lib. You should specify amiga.lib as the last library in the slink command. @endnode @node libprob2 "Library Problem 2 " getchar does not work as expected. _______________________________________________________________________ Input and output on the Amiga system ar$7؇{e buffered. On most other systems, @{" getchar " link sc:help/sc_lib.guide/getchar()} immediately gets a character from stdin (usually the keyboard). However, the CON: device on the Amiga system buffers its input, so your program does not actually read any characters until you do one of the following: - fill up the console input buffer - press Return - enter the Amiga End-of-File character, Ctrl-\. The SAS/C Development System libraries include two fun%8;N[ctions that you can use to deal with this problem: @{" getch " link sc:help/sc_lib.guide/getch()} gets a character from the console in RAW mode. The character is returned as soon as the user types it. @{" rawcon " link sc:help/sc_lib.guide/rawcon()} turns RAW mode on and off. rawcon(1) sets the console into RAW mode. rawcon(0) restores the console to non- RAW mode. When the console is in RAW mode, any characters typed by the us&9w*Uer are passed immediately to the application. getch returns a single character from stdin just like getchar, but getch gets the character in RAW mode. If your console is not in RAW mode, using getch is equivalent to the following sequence: rawcon(1); c = getchar(); rawcon(0); If your console is in RAW mode, getch is equivalent to getchar . For more information about getchar, refer to SAS/C Development System Library Reference':8I . @endnode @node libprob3 "Library Problem 3 " My program compiles and links without errors, but I am getting the wrong results from some of my SAS/C function calls. _______________________________________________________________________ You can get incorrect results from a function if you do not include the correct header files for the function you are calling. The header files contain prototypes for each of the SAS/C functions, as well as definitions for many common data struct(;FOFures required by these functions. By including the correct header file, you are providing the compiler with a prototype for the SAS/C functions you call. The ANSI Standard requires that the compiler assume that functions that are called without the previous inclusion of a prototype return an int. For example, this means that if you call atof, which returns a double, without including math.h, the compiler assumes that atof returns an int and allocates only 4 bytes for the return valu)wjo not contain the necessary prototypes and data declarations. For example, you may be including dos/stdio.h instead of stdio.h. Do not substitute header files from the include:dos directory for standard headers. - You may be including header files from the proto directory instead of those in the root level include: directory. Although the files in the proto directory do contain prototypes for many of the SAS/C functions, these files are int,?8;ended to be included in addition to the standard header files, not in place of them. Do not use header files in include: subdirectories as substitutes for the root level header files. @endnode @node libprob4 "Library Problem 4 " I am using the asctime function to convert the time to Greenwich Mean Time (GMT) correctly, but the result is exactly an hour (or two or three...) off. _______________________________________________________________________ Your machine is-@K probably in the default time zone, Central Standard Time (CST), and has not been reset to your actual time zone. To correct the problem, reset your machine's time zone environment variable to your actual time zone with the following AmigaDOS command: setenv TZ= your-time-zone For your-time-zone, enter your zone's standard three letter abbreviation followed by the number of hours difference between your time zone and Greenwich Mean Time. For example, for Eastern S.A,R-tandard Time, the command would be as follows: setenv TZ=EST5 You can also initialize the _TZ variable as described in the SAS/C Development System Library Reference. Initialize the _TZ variable with the same time zone data as you would enter with the AmigaDOS command described above (for example, EST5). NOTE: The AmigaDOS environment variable does not have a leading underscore that the SAS/C data name has. @endnode @node libprob5 "Library Problem 5 " I wrote a /B/*freplacement function for one of the SAS/C library routines, but the library routines don't seem to be using my replacement function. _______________________________________________________________________ If you write a function that has the same name as a library function, you need to add the __regargs keyword to your function or compile with the @{" parms=both " link sc:help/sc.guide/parms} or @{" parms=register " link sc:help/sc.guide/parms} option. For example, you may want to 0CX"replace the SAS/C library function malloc with your own version of malloc. If you compile with the @{" parms=stack " link sc:help/sc.guide/parms} option or define your version of malloc with the __stdargs keyword, then two versions of malloc are linked into your executable. If you use other SAS/C library functions that call malloc, these functions use the version of malloc in the SAS/C libraries. However, your functions that call malloc use your version of malloc. To make sure th1DM%ݫat all calls to malloc are using your version of malloc, define your version with __regargs or compile with the parms=both or parms=register option. @endnode @node se " Problems using the Editor (SE) " @{" Problem 1 " link seprob1} When I am in SE, I can't get the configuration screen to come up. What is wrong? @endnode @node seprob1 "SE Problem 1" When I am in SE, I can't get the configuration screen to come up. What is wrong? ________________________2En________________________________________________ You did not install the extra utilities when you ran the installer for SAS/C. The utility sekeymap.library must exist in sc:libs in order for se to bring up the configuration screen. To correct the problem, you should run the installer and install the extra utilities. @endnode @node misc " Miscellaneous Problems " @{" Problem 1 " link miscprob1} How can I turn off all of the informational messages the compiler and linker 3Faproduce every time I compile and link? @{" Problem 2 " link miscprob2} An annoying window opens when I run my program from the Workbench screen. How do I get rid of this window? @{" Problem 3 " link miscprob3} My program compiled and linked without any errors, but when I run it, my machine crashes. What am I doing wrong? @endnode @node miscprob1 "Miscellaneous Problem 1 " How can I turn off all of the informational messages the compiler and linker produc4G6fe every time I compile and link? _______________________________________________________________________ You can specify the following options on the sc command line: sc @{" nover " link sc:help/sc.guide/verbose} @{" link " link sc:help/sc.guide/link} filename.c The compiler option nover automatically turns on the linker option quiet if you also specify the link option. @endnode @node miscprob2 "Miscellaneous Problem 2 " An annoying window opens when I run my 5HQMsprogram from the Workbench screen. How do I get rid of this window? _______________________________________________________________________ The SAS/C startup code opens the window to allow programs that are run from the Workbench screen to access stdin, stdout, and stderr. You can eliminate this window or change its attributes. For information on managing this window, see Chapter 9, "Running Your Program from the Workbench Screen." @endnode @node miscprob3 "Miscellaneous Problem6I} 3 " My program compiled and linked without any errors, but when I run it, my machine crashes. What am I doing wrong? _______________________________________________________________________ The following list contains some of the more common errors that crash programs. Most of these errors are caused when your program accesses memory that it is not supposed to access. - You have declared a pointer to an array or structure for which you have not allocated memory. This m7JOR'istake is especially easy to make when calling functions that fill the array or structure with information, such as the fstat, lstat, and stat functions. To correct this problem, call malloc or calloc to allocate the appropriate amount of memory for the array or structure. - You have assigned an inappropriate value to a pointer, so the pointer no longer points to a valid memory space. This type of error can be quite difficult to track down. 8K  You may want to run the CodeProbe, the Enforcer, or the Mungwall program if you think these types of errors may occur. Enforcer and Mungwall are programs that detect memory errors. They are available from Commodore Applications and Technical Support (CATS) and are shipped with Version 6. - You have specified the @{" nostackcheck " link sc:help/sc.guide/stackcheck} option and are overwriting your stack. Do not specify nostackcheck until you9Lo2r program is completely debugged. The stackcheck option is the default unless you are creating a shared library using the @{" libcode " link sc:help/sc.guide/libcode} option. @endnode @node HELP "HELP" You have reached this Help window by either clicking on the Help button or by hitting the Help key within the SAS/C Help utility. Unlike other help topics present in the SAS/C Help utility, the Help help topic opens its own window. You must close this window by clicking :MLon the close gadget or hitting escape before returning to the SAS/C help utility. You cannot hit the Retrace button to return. To quit the SAS/C Help utility, select Quit from the Project menu or click on the close gadget. You may also hit escape. Most help screens will display one or more buttons as part of the text. Clicking on these buttons will provide further information on the topic listed on the button. You can also reach these help topics through the main Contents screen;oPD or one of its sub-screens. In addition, double-clicking in the help window will bring up a help screen for the word under the mouse cursor, if such a help screen exists. While in the SAS/C Help utility, you may retrace your steps through the help screens you have selected by clicking on the Retrace button. The Browse buttons will move you forward and backwards between help screens. The help screens are usually arranged alphabetically by command or topic. @endnode ntents screenN1OS~}|{zyxwvutsrqponmlkjihgfedcba`_^]\[ZYXWVUTSRQPO])sc_change.guideNPB@database sc_change Copyright (c) 1992 SAS Institute, Inc, Cary, NC All Rights Reserved @node main "Changes to the Documentation" @{" General Notes " link general} @{" Changes to Volume 1: Introduction, Editor, Compiler " link vol1} @{" Changes to Volume 2: Debugger, Utilities Assembler " link vol2} @{" Changes to the LibraNQry Reference " link lib} @{" Changes to the SAS/C Help System " link help_ch} @endnode @node general "General Notes" 1. Since the compiler's executables are now AmigaDOS shared libraries, they remain in memory after your compile finishes. They will be automatically flushed out of memory if they are not in use and some other program needs the memory. However, if you run out of fast memory, the operatiNR2:ng system starts using chip memory before flushing the libraries. Chip memory is much slower than fast memory on Amigas with faster processors, so this may slow down your program. If you think this is happening to you, and you are running AmigaDOS 2.0, use the AVAIL command as follows to flush any shared libraries before running your program: avail flush 2. New option -nommu The -nommu option can be specified forNS CPR and CPRK. It tells CPR not to use the MMU for any reason. This option is only relevant for users with a 68020 or greater CPU. If your machine is running Enforcer and is 68020- or 68030-based, CPR will try to use the MMU by default to stop references to illegal memory. For these machines, the -nommu option tells CPR not to verify memory in the MMU tables before trying to access it. However, if Enforcer is running, you still wilNT0?l not be able to display illegal memory. On 68040 machines, CPR doesn't use the MMU tables, but rather uses the TypeOfMem() call to determine if memory exists at that location. CPR was modified to act this way because reading illegal memory on a 68040 may cause the machine to crash. Unfortunatly, this method does not allow you to display ROM. For the 68040, the -nommu option removes this restriction, allowing you to display ROM. HNUqowever, care should be taken in what memory is de-referenced or you could crash your machine. 3. The format of bitfields has changed in version 6.0. If you have a program that ran under version 5.10 or earlier that depends on the order of bitfields, it will no longer work. 4. Several additional help files have been added to the SAS/C Amigaguide help system. All SAS/C help files are located in sc:help. 5. You may find the example prNVktmogram schelp in the sc:help/examples/cback directory useful to compile and use. schelp is a background process which will allow you to hit control-Help to pop up the main help window for the SAS/C Amigaguide help system. Read the read.me file in that directory for more information. 6. By default, when you include the file proto/exec.h you get "syscall" pragmas for all exec.library functions. Another set of pragmas exists for exec that use NW_wthe "libcall" method via the library base SysBase. Either set of pragmas will work. The "syscall" pragmas find the address of exec.library by looking at memory location 4. The "libcall" pragmas find it by looking at the external variable "SysBase". On Amigas with 68020 and higher processors, it is significantly faster to use the "libcall" pragmas. To do this, define the preprocessor symbol "__USE_SYSBASE" on the command line or by using a #defN X'ine statement. If you do this, make sure you include the file rather than . If you do this and you are not using one of the SAS/C supplied startup modules, you will have to initialize the variable SysBase yourself as follows: struct ExecBase *SysBase = *(struct ExecBase **)4; 7. Two rexx macros were added after the documentation was completed. They are sc:rexx/man.se and sc:rexx/man.cpr. To use theN Y3se macros: In CPR, type man where is any valid SAS/C library function. This will automatically display a help screen from the sc_lib.guide help file for that function. In SE, place the cursor on the name of any valid SAS/C library function and hit shift-help. This will automatically display a help screen from the sc_lib.guide help file for that function. @endnode @node vol1 "Changes to Volume 1" 1. Add the followinN Z0g to the end of the "Changes and Enhancements" list on page xxviii, and to the description of the __interrupt keyword on page 153: Unlike previous versions of the compiler, the __interrupt keyword does not imply that the function will be called with stack arguments. If you use PARMS=REG and the function must receive its parameters on the stack, add the __stdargs keyword to its definition and prototype. 2. On page 257, tN [khe following line should be added to the explanation for Error 625: If you are specifying the link option, you need to include the math= option to specify which math library with which you want to link. If you are linking explicitly, you need to link with a math library as well as sc.lib. 3. In the description of the OPTCOMPLEXITY, OPTDEPTH and OPTRDEPTH options on pages 106-108, the default values for the three N \uCoptions are given as 3. The defaults are actually 0. This means that by default the global optimizer will not inline any functions unless they have been explicitly declared with the __inline keyword. This change also needs to be made on page 83 in Table 8.1, Summary of Compiler Options. 4. On page 258, Warning 156 should not have been included in the table. It is on by default. @endnode @node vol2 "Changes to Volume 2" 1. On liN]`tne 10 in the list of cpr options, change the second occurrence of "-cli" to "-.". 2. On page 41, the first example of the "go" command reads >go 4 when (i == 7) this should read >go 24 when(i == 7) 3. On page 43, in the second listing of example code, the 4 on the third and fourth lines should be 24, as follows: > go 24 when (i ==7) sort:\Work:examples/sort.c\sort 24 4. On page 50 uUnder "AN^Pttaching actions to breakpoints": the text discusses setting a breakpoint at line 25 while the example sets the break at line 26. 5. On page 51, in the bottom example, the definition of the breakpoint starting on the second line spans 2 input lines. You must place a backslash (\) at the end of the first line. > break sort 26 when (i > 5) {dump p L 4; \ break sort 26 when (i == 8) trace; blist} 6. On pN_2age 76, the text mentions the fact that CPR will by default open its own public screen, but it does not give the name of this screen. Unless otherwise specified with the -SCREEN option, CPR opens a public screen called "SC_CPR.1". 7. On page 92 in the example alias commands, the second example should read "alias enter `set" instead of "alias enter `et". 8. On page 133 in the synopsis, "be[enable]" should be "be[nable]". 9. OnN`mG page 167, the description of the RESTART debugger command states that watch breaks on static and external data items will be retained after a RESTART. This does not work if the program being debugged was linked with the "cres" or "catchres" startup modules and the watch break is set on an item in the near data section. 10. On page 207, add a semicolon at the end of "void *to". 11. On page 216, underscores are missing from two bulleted list items Nanear the middle of the page and from item 2 near the bottom. These lines should read: * The main routine must be called main rather than __main because covutil.o replaces __main with an enhanced version. * Your program must end by calling exit or by falling through the end of main. (Do not call _XCEXIT or abort, for example.) 2. ...The covutil.o file Nbgo 4 when (i == 7) this should read >go 24 when(i == 7) 3. On page 76, the text mentions the fact that CPR will by default open its own public screen, but it does not give the name of this screen. Unless otherwise specified with the -SCREEN option, CPR opens a public screen called "SC_CPR.1". 4. On page 167, the description of the RESTART debugger command states that watch breaks on static and external data N)xJitems will be retained after a RESTART. This does not work if the program being debugged was linked with the "cres" or "catchres" startup modules and the watch break is set on an item in the near data section. 5. A rexx macro, sc:rexx/man.cpr, was added after the documentation was completed. In CPR, type man where is any valid SAS/C library function. This will automatically display a help screen from the sc_libN*yu2.guide help file for that function. @endnode @node scmsg "SCMSG Changes" 1. On page 247, in the description of the SCMSG command, it states that SCMSG will be automatically invoked when the compiler produces diagnostics. You must specify the ERRORREXX option to tell the compiler to do this. If you do not specify ERRORREXX, the SCMSG utility will not be invoked. @endnode @node scsetup "SCSETUP Changes" 1. On page 258, the SCSETUP utility is docN+z umented. Two new options have been added to this utility, FORCE and NOSTARTER. If FORCE is specified, SCSETUP copies icons and files into the directory whether or not they already exist. Use this option if you have a directory already set up for Version 5.10 of the compiler. The NOSTARTER option tells SCSETUP not to copy the contents of the drawer SC:STARTER_PROJECT to the directory being set up. Use this option to create icons for N,{ files in a directory based on their extension when you do not want the SCOptions, Edit, Debug and Build icons copied into the directory. @endnode @node cover "Cover Changes" 1. On page 216, the bulleted restrictions are unnecessary. The file covutil.o uses auto-initialization to initialize and write the coverage data to disk. The only restriction for using "cover" is that you must link with a startup file, ie c.o, cres.o, etc. @endnode @node smaN-|S@ke "SMAKE Changes" 1. On pages 276 and 278, in the example smakefiles, data=absolute should be data=far. @endnode @node sc "Compiler Changes" 1. Since the compiler's executables are now AmigaDOS shared libraries, they remain in memory after your compile finishes. They will be automatically flushed out of memory if they are not in use and some other program needs the memory. However, if you run out of fast memory, the operating systeN.}B|m starts using chip memory before flushing the libraries. Chip memory is much slower than fast memory on Amigas with faster processors, so this may slow down your program. If you think this is happening to you, and you are running AmigaDOS 2.0, use the AVAIL command as follows to flush any shared libraries before running your program: avail flush 2. The format of bitfields has changed in version 6.0. If you have a N/~_F program that ran under version 5.10 or earlier that depends on the order of bitfields, it will no longer work. @endnode @node HELP "HELP" You have reached this Help window by either clicking on the Help button or by hitting the Help key within the SAS/C Help utility. Unlike other help topics present in the SAS/C Help utility, the Help help topic opens its own window. You must close this window by clicking on the close gadget or hitting escape before returning to the SN0`ǸAS/C help utility. You cannot hit the Retrace button to return. To quit the SAS/C Help utility, select Quit from the Project menu or click on the close gadget. You may also hit escape. Most help screens will display one or more buttons as part of the text. Clicking on these buttons will provide further information on the topic listed on the button. You can also reach these help topics through the main Contents screen or one of its sub-screens. In addition, double-clicking inN1Y the help window will bring up a help screen for the word under the mouse cursor, if such a help screen exists. While in the SAS/C Help utility, you may retrace your steps through the help screens you have selected by clicking on the Retrace button. The Browse buttons will move you forward and backwards between help screens. The help screens are usually arranged alphabetically by command or topic. @endnode een or one of its sub-screens. In addition, double-clicking inH  sc_lib.guideJ@database "sc_lib" Copyright (c) 1992 SAS Institute, Inc, Cary, NC All Rights Reserved @master "sc_lib.guide" @Remark $VER: sc_lib.guide 6.00 (20.7.92) @Remark AmigaGuide database for the SAS/C Development System Libraries @Node Main "sc_lib.guide" @{" Common Problems" link sc:help/sc_prob.guide/lib} @{" Alphabetical list of all functions and data items " Link "AlphaList"} @{" Character Type Macros and Functions " Link "CharFuncs"} @{" String Functi.ons " Link "StringFuncs"} @{" Conversion Functions " Link "ConvFuncs"} @{" Mathematical Macros and Functions " Link "MathFuncs"} @{" Varying-Length Argument List Macros " Link "VarArgFuncs"} @{" General Utility Macros and Functions " Link "GeneralFuncs"} @{" Sorting Functions " Link "SortFuncs"} @{" Random Number Generation Functiouns " Link "RandFuncs"} @{" Program Control Functions " Link "ProgFuncs"} @{" Memory Allocation Functions " Link "AllocFuncs"} @{" Memory Manipulation Functions " Link "MemoryFuncs"} @{" Diagnostic Control Functions " Link "DiagFuncs"} @{" Time Functions " Link "TimeFuncs"} @{" I/O Functions " Linłk "IOFuncs"} @{" File Management Functions " Link "FileManFuncs"} @{" System Interface Functions " Link "SysFuncs"} @{" Directory Functions " Link "DirFuncs"} @{" Localization Functions " Link "LocalFuncs"} @{" Multibyte Character Functions " Link "MultiFuncs"} @{" Functions User Can Replace, But Not Call " Link "NoCallFuncs"} @{" Builtin Functions " Link "BltinFuncs"} @{" Useful Tables " Link "UsefulTables"} @{" Glossary " Link "Glossary"} @EndNode @Node "AlphaList" @{" abort() - __daylight " Link "AlphaList abort() - __daylight"} @{" __daytbl - fputs() " Link "AlphaList __daytbl - fputs()"} @{" fqsort() - isgraph() " Link "AlphaList fqsort() - isgraph()"} @{" islower() - __montbl "Gc Link "AlphaList islower() - __montbl"} @{" __months - rmdir() " Link "AlphaList __months - rmdir()"} @{" rstmem() - stcl_o() " Link "AlphaList rstmem() - stcl_o()"} @{" stco_i() - strset() " Link "AlphaList stco_i() - strset()"} @{" strsfn() - vfprintf() " Link "AlphaList strsfn() - vfprintf()"} @{" vprintf() - _XCEXIT() " Link "AlphaList vprintf() - _XCEXIT()"} @EndNode @Node "AlphaList abort() - __daylight" @{" abort() " Link "abort()"} @{" abs()  " Link "abs()"} @{" access() " Link "access()"} @{" acos() " Link "acos()"} @{" argopt() " Link "argopt()"} @{" asctime() " Link "asctime()"} @{" asin() " Link "asin()"} @{" assert() " Link "assert()"} @{" astcsma() " Link "astcsma()"} @{" atan() " Link "atan()"} @{" atan2() " Link "atan2()"} @{" atexit() " Link "atexit()"} @{" atof() " Link "atof()"} ڐsT @{" atoi() " Link "atoi()"} @{" atol() " Link "atol()"} @{" _BackGroundIO " Link "_BackGroundIO"} @{" _Backstdout " Link "_Backstdout"} @{" bldmem() " Link "bldmem()"} @{" bsearch() " Link "bsearch()"} @{" __buffsize " Link "__buffsize"} @{" calloc() " Link "calloc()"} @{" ceil() " Link "ceil()"} @{" chdir() " Link "chdir()"} @{" chgclk() " Link "chgclk()"} @{" chk abort() " Link "chkabort()"} @{" chkml() " Link "chkml()"} @{" chkufb() " Link "chkufb()"} @{" Chk_abort() " Link "chkabort()"} @{" chmod() " Link "chmod()"} @{" clearerr() " Link "clearerr()"} @{" clock() " Link "clock()"} @{" close() " Link "close()"} @{" closedir() " Link "closedir()"} @{" clrerr() " Link "clrerr()"} @{" cos() " Link "cos()"} @{" cosh()  k9 " Link "cosh()"} @{" cot() " Link "cot()"} @{" creat() " Link "creat()"} @{" ctime() " Link "ctime()"} @{" __ctype " Link "__ctype"} @{" _CXBRK() " Link "_CXBRK()"} @{" _CXFERR() " Link "_CXFERR()"} @{" _CXOVF() " Link "_CXOVF()"} @{" datecmp() " Link "datecmp()"} @{" __daylight " Link "__daylight"} @EndNode @Node "AlphaList __daytbl - fputs()" @{" __daytbl " Link "__daytbl"} ; @{" dfind() " Link "dfind()"} @{" difftime() " Link "difftime()"} @{" DiskfontBase " Link "DiskfontBase"} @{" div() " Link "div()"} @{" dnext() " Link "dnext()"} @{" DOSBase " Link "DOSBase"} @{" dqsort() " Link "dqsort()"} @{" drand48() " Link "drand48()"} @{" ecvt() " Link "ecvt()"} @{" __emit() " Link "__emit()"} @{" erand48() " Link "erand48()"} @{" errn ׈Do " Link "errno"} @{" except() " Link "except()"} @{" exit() " Link "exit()"} @{" __exit() " Link "__exit()"} @{" exp() " Link "exp()"} @{" fabs() " Link "fabs()"} @{" fclose() " Link "fclose()"} @{" fcloseall() " Link "fcloseall()"} @{" fcvt() " Link "fcvt()"} @{" fdopen() " Link "fdopen()"} @{" feof() " Link "feof()"} @{" ferror() " Link "fe -rror()"} @{" fflush() " Link "fflush()"} @{" fgetc() " Link "fgetc()"} @{" fgetchar() " Link "fgetchar()"} @{" fgetpos() " Link "fgetpos()"} @{" fgets() " Link "fgets()"} @{" fileno() " Link "fileno()"} @{" findpath() " Link "findpath()"} @{" floor() " Link "floor()"} @{" flushall() " Link "flushall()"} @{" __fmask " Link "__fmask"} @{" fmod() " Link "fmod()"} o @{" fmode() " Link "fmode()"} @{" __fmode " Link "__fmode"} @{" fopen() " Link "fopen()"} @{" forkl() " Link "forkl()"} @{" forkv() " Link "forkv()"} @{" _FPERR " Link "_FPERR"} @{" fprintf() " Link "fprintf()"} @{" fputc() " Link "fputc()"} @{" fputchar() " Link "fputchar()"} @{" fputs() " Link "fputs()"} @EndNode @Node "AlphaList fqsort() - isgraph()" @{" fqsort() " InrLink "fqsort()"} @{" fread() " Link "fread()"} @{" free() " Link "free()"} @{" freopen() " Link "freopen()"} @{" frexp() " Link "frexp()"} @{" fscanf() " Link "fscanf()"} @{" fseek() " Link "fseek()"} @{" fsetpos() " Link "fsetpos()"} @{" fstat() " Link "fstat()"} @{" ftell() " Link "ftell()"} @{" fwrite() " Link "fwrite()"} @{" gcvt() " Link "gcvt()"}>! @{" geta4() " Link "geta4()"} @{" getasn() " Link "getasn()"} @{" getc() " Link "getc()"} @{" getcd() " Link "getcd()"} @{" getch() " Link "getch()"} @{" getchar() " Link "getchar()"} @{" getclk() " Link "getclk()"} @{" getcwd() " Link "getcwd()"} @{" getdfs() " Link "getdfs()"} @{" getenv() " Link "getenv()"} @{" getfa() " Link "getfa()"} @{" getfnl() f* " Link "getfnl()"} @{" getft() " Link "getft()"} @{" getmem() " Link "getmem()"} @{" getml() " Link "getml()"} @{" getpath() " Link "getpath()"} @{" getreg() " Link "getreg()"} @{" gets() " Link "gets()"} @{" GfxBase " Link "GfxBase"} @{" gmtime() " Link "gmtime()"} @{" halloc() " Link "halloc()"} @{" iabs() " Link "iabs()"} @{" IntuitionBase " Link "IntuitionBa|se"} @{" iomode() " Link "iomode()"} @{" isalnum() " Link "isalnum()"} @{" isalpha() " Link "islpha()"} @{" isascii() " Link "isascii()"} @{" isatty() " Link "isatty()"} @{" iscntrl() " Link "iscntrl()"} @{" iscsym() " Link "iscsym()"} @{" iscsymf() " Link "iscsymf()"} @{" isdigit() " Link "isdigit()"} @{" isgraph() " Link "isgraph()"} @EndNode @Node "AlphaList islower() - __mon~tbl" @{" islower() " Link "islower()"} @{" isprint() " Link "isprint()"} @{" ispunct() " Link "ispunct()"} @{" isspace() " Link "isspace()"} @{" isupper() " Link "isupper()"} @{" isxdigit() " Link "isxdigit()"} @{" jrand48() " Link "jrand48()"} @{" labs() " Link "labs()"} @{" lcong48() " Link "lcong48()"} @{" ldexp() " Link "ldexp()"} @{" ldiv() " Link "ldiv()"} c0@{" localeconv() " Link "localeconv()"} @{" localtime() " Link "localtime()"} @{" log() " Link "log()"} @{" log10() " Link "log10()"} @{" longjmp() " Link "longjmp()"} @{" lqsort() " Link "lqsort()"} @{" lrand48() " Link "lrand48()"} @{" lsbrk() " Link "lsbrk()"} @{" lseek() " Link "lseek()"} @{" lstat() " Link "lstat()"} @{" main() " Link "main()"} @{" __main() " Link "__main()"} @{" malloc() " Link "malloc()"} @{" MathBase " Link "MathBase"} @{" __matherr() " Link "__matherr()"} @{" MathTransBase " Link "MathTransBase"} @{" max() " Link "max()"} @{" mblen() " Link "mblen()"} @{" mbstowcs() " Link "mbstowcs()"} @{" mbtowc() " Link "mbtowc()"} @{" memccpy() " Link "memccpy()"} @{" memchr() " Link "memchr()"} @{" _MemCleanup() " Link "_Me)mCleanup()"} @{" memcmp() " Link "memcmp()"} @{" memcpy() " Link "memcpy()"} @{" memmove() " Link "memmove()"} @{" memset() " Link "memset()"} @{" _MemType " Link "_MemType"} @{" min() " Link "min()"} @{" mkdir() " Link "mkdir()"} @{" mktime() " Link "mktime()"} @{" _MNEED " Link "_MNEED"} @{" modf() " Link "modf()"} @{" __montbl " Link "__montbl"} @EnSҢdNode @Node "AlphaList __months - rmdir()" @{" __months " Link "__months"} @{" movmem() " Link "movmem()"} @{" mrand48() " Link "mrand48()"} @{" __msflag " Link "__msflag"} @{" _MSTEP " Link "_MSTEP"} @{" nrand48() " Link "nrand48()"} @{" __nufbs " Link "__nufbs"} @{" offsetof() " Link "offsetof()"} @{" onbreak() " Link "onbreak()"} @{" onexit() " Link "onexit()"} @{" open(N) " Link "open()"} @{" opendir() " Link "opendir()"} @{" _OSERR " Link "_OSERR"} @{" __os_errlist " Link "__os_errlist"} @{" __os_nerr " Link "__os_nerr"} @{" ovlyMgr() " Link "ovlyMgr()"} @{" perror() " Link "perror()"} @{" poserr() " Link "poserr()"} @{" pow() " Link "pow()"} @{" pow2() " Link "pow2()"} @{" printf() " Link "printf()"} @{" _priority " Link "_prtiority"} @{" _procname " Link "_procname"} @{" putc() " Link "putc()"} @{" putchar() " Link "putchar()"} @{" putenv() " Link "putenv()"} @{" putreg() " Link "putreg()"} @{" puts() " Link "puts()"} @{" qsort() " Link "qsort()"} @{" raise() " Link "raise()"} @{" rand() " Link "rand()"} @{" rawcon() " Link "rawcon()"} @{" rbrk() " Link "rbrk()"} @{" readIͼ() " Link "read()"} @{" readdir() " Link "readdir()"} @{" readlocale() " Link "readlocale()"} @{" realloc() " Link "realloc()"} @{" remove() " Link "remove()"} @{" rename() " Link "rename()"} @{" repmem() " Link "repmem()"} @{" rewind() " Link "rewind()"} @{" rewinddir() " Link "rewinddir()"} @{" rlsmem() " Link "rlsmem()"} @{" rlsml() " Link "rlsml()"} @{" rmdir()E " Link "rmdir()"} @EndNode @Node "AlphaList rstmem() - stcl_o()" @{" rstmem() " Link "rstmem()"} @{" sbrk() " Link "sbrk()"} @{" scanf() " Link "scanf()"} @{" seed48() " Link "seed48()"} @{" seekdir() " Link "seekdir()"} @{" setbuf() " Link "setbuf()"} @{" setjmp() " Link "setjmp()"} @{" setlocale() " Link "setlocale()"} @{" setmem() " Link "setmem()"} @{" setnbf() " Link "s}etnbf()"} @{" setvbuf() " Link "setvbuf()"} @{" __sigfunc() " Link "__sigfunc()"} @{" signal() " Link "signal()"} @{" sin() " Link "sin()"} @{" sinh() " Link "sinh()"} @{" sizmem() " Link "sizmem()"} @{" _SLASH " Link "_SLASH"} @{" sprintf() " Link "sprintf()"} @{" sqrt() " Link "sqrt()"} @{" sqsort() " Link "sqsort()"} @{" srand() " Link "srand()"} @{" msrand48() " Link "srand48()"} @{" sscanf() " Link "sscanf()"} @{" __stack " Link "__stack"} @{" stacksize() " Link "stacksize()"} @{" stackused() " Link "stackused()"} @{" stat() " Link "stat()"} @{" stcarg() " Link "stcarg()"} @{" stccpy() " Link "stccpy()"} @{" stcd_i() " Link "stcd_i()"} @{" stcd_l() " Link "stcd_l()"} @{" stcgfe() " Link "stcgfe()"} @{" stcgf3 n() " Link "stcgfn()"} @{" stcgfp() " Link "stcgfp()"} @{" stch_i() " Link "stch_i()"} @{" stch_l() " Link "stch_l()"} @{" stcis() " Link "stcis()"} @{" stcisn() " Link "stcisn()"} @{" stci_d() " Link "stci_d()"} @{" stci_h() " Link "stci_h()"} @{" stci_o() " Link "stci_o()"} @{" stclen() " Link "stclen()"} @{" stcl_d() " Link "stcl_d()"} @{" stcl_h() " Link "stcl_h()"} @{" stcl_o() " Link "stcl_o()"} @EndNode @Node "AlphaList stco_i() - strset()" @{" stco_i() " Link "stco_i()"} @{" stco_l() " Link "stco_l()"} @{" stcpm() " Link "stcpm()"} @{" stcpma() " Link "stcpma()"} @{" stcsma() " Link "stcsma()"} @{" stcul_d() " Link "stcul_d()"} @{" stcu_d() " Link "stcu_d()"} @{" stpblk() " Link "stpblk()"} @{" stpbrk() " Link "stpbrk()" +} @{" stpchr() " Link "stpchr()"} @{" stpchrn() " Link "stpchrn()"} @{" stpcpy() " Link "stpcpy()"} @{" stpdate() " Link "stpdate()"} @{" stpsym() " Link "stpsym()"} @{" stptime() " Link "stptime()"} @{" stptok() " Link "stptok()"} @{" strbpl() " Link "strbpl()"} @{" strcat() " Link "strcat()"} @{" strchr() " Link "strchr()"} @{" strcmp() " Link "strcmp()"} @{" !x,strcmpi() " Link "strcmpi()"} @{" strcoll() " Link "strcoll()"} @{" strcpy() " Link "strcpy()"} @{" strcspn() " Link "strcspn()"} @{" strdup() " Link "strdup()"} @{" strerror() " Link "strerror()"} @{" strftime() " Link "strftime()"} @{" stricmp() " Link "stricmp()"} @{" _STRICT_ANSI " Link "_STRICT_ANSI"} @{" strins() " Link "strins()"} @{" strlen() " Link "strlen()"} @{" strlwr"QQ() " Link "strlwr()"} @{" strmfe() " Link "strmfe()"} @{" strmfn() " Link "strmfn()"} @{" strmfp() " Link "strmfp()"} @{" strmid() " Link "strmid()"} @{" strncat() " Link "strncat()"} @{" strncmp() " Link "strncmp()"} @{" strncpy() " Link "strncpy()"} @{" strnicmp() " Link "strnicmp()"} @{" strnset() " Link "strnset()"} @{" strpbrk() " Link "strpbrk()"} @{" strrchr() " L#Pink "strrchr()"} @{" strrev() " Link "strrev()"} @{" strset() " Link "strset()"} @EndNode @Node "AlphaList strsfn() - vfprintf()" @{" strsfn() " Link "strsfn()"} @{" strspn() " Link "strspn()"} @{" strsrt() " Link "strsrt()"} @{" strstr() " Link "strstr()"} @{" strtod() " Link "strtod()"} @{" strtok() " Link "strtok()"} @{" strtol() " Link "strtol()"} @{" strtoul() " Link $ZN"strtoul()"} @{" strupr() " Link "strupr()"} @{" strxfrm() " Link "strxfrm()"} @{" stspfp() " Link "stspfp()"} @{" _stub() " Link "_stub()"} @{" swmem() " Link "swmem()"} @{" __sys_errlist " Link "__sys_errlist"} @{" __sys_nerr " Link "__sys_nerr"} @{" system() " Link "system()"} @{" tan() " Link "tan()"} @{" tanh() " Link "tanh()"} @{" tell() " Link "tell()"} %5 @{" telldir() " Link "telldir()"} @{" time() " Link "time()"} @{" __timecvt() " Link "__timecvt()"} @{" timer() " Link "timer()"} @{" __timezone " Link "__timezone"} @{" __tinymain() " Link "__tinymain()"} @{" tmpfile() " Link "tmpfile()"} @{" tmpnam() " Link "tmpnam()"} @{" toascii() " Link "toascii()"} @{" tolower() " Link "tolower()"} @{" toupper() " Link "toupper()"} @{" &{3 tqsort() " Link "tqsort()"} @{" _TZ " Link "_TZ"} @{" __tzdtn " Link "__tzdtn"} @{" __tzname " Link "__tzname"} @{" __tzset() " Link "__tzset()"} @{" __tzstn " Link "__tzstn"} @{" __ufbs " Link "__ufbs"} @{" ungetc() " Link "ungetc()"} @{" unlink() " Link "unlink()"} @{" utpack() " Link "utpack()"} @{" utunpk() " Link "utunpk()"} @{" va_arg() " L'M ink "va_arg()"} @{" va_end() " Link "va_end()"} @{" va_start() " Link "va_start()"} @{" vfprintf() " Link "vfprintf()"} @EndNode @Node "AlphaList vprintf() - _XCEXIT()" @{" vprintf() " Link "vprintf()"} @{" vsprintf() " Link "vsprintf()"} @{" wait() " Link "wait()"} @{" waitm() " Link "waitm()"} @{" wcstombs() " Link "wcstombs()"} @{" wctomb() " Link "wctomb()"} @{" write() " Link "wri(s"te()"} @{" _XCEXIT() " Link "_XCEXIT()"} @EndNode @Node "CharFuncs" @{" isalnum() " Link "isalnum()"} Check if character is alphanumeric @{" isalpha() " Link "isalpha()"} Check if character is alphabetic @{" isascii() " Link "isascii()"} Check if character is ASCII @{" iscntrl() " Link "iscntrl()"} Check if character is a control character @{" iscsym() " Link "iscsym()"} Check if character is a C symbol character @{" iscsymf() " Link ") iscsymf()"} Check if character is a C symbol lead character @{" isdigit() " Link "isdigit()"} Check if character is a decimal digit (0-9) @{" isgraph() " Link "isgraph()"} Check if character is a graphic character @{" islower() " Link "islower()"} Check if character is lower case @{" isprint() " Link "isprint()"} Check if character is printable @{" ispunct() " Link "ispunct()"} Check if character is a punctuation character @{" isspace() " Link "iss**ygpace()"} Check if character is a space @{" isupper() " Link "isupper()"} Check if character is upper case @{" isxdigit() " Link "isxdigit()"} Check if character is a hex character (0-9, A-F, a-f) @{" toascii() " Link "toascii()"} Convert character to ASCII @{" tolower() " Link "tolower()"} Convert character to lower case @{" toupper() " Link "toupper()"} Convert character to upper case @EndNode @Node "StringFuncs" See also "Memory Manipulation Function+ĥs" @{" astcsma() " Link "astcsma()"} AmigaDOS string pattern match (anchored) @{" stcpm() " Link "stcpm()"} Unanchored pattern match @{" stcpma() " Link "stcpma()"} Anchored pattern match @{" stcsma() " Link "stcsma()"} @{" UNIX " Link "Glossary - UNIX"} string pattern match (anchored) @{" stccpy() " Link "stccpy()"} Copy one string to another @{" stpcpy() " Link "stpcpy()"} Copy one string to another @{" strcpy() " Link "strcpy()"} Co,py one string to another @{" strncpy() " Link "strncpy()"} Copy string, length-limited @{" stcis() " Link "stcis()"} Measure span of characters in set @{" stcisn() " Link "stcisn()"} Measure span of characters not in set @{" strcspn() " Link "strcspn()"} Measure span of characters not in set @{" stclen() " Link "stclen()"} Measure length of a string @{" strlen() " Link "strlen()"} Measure length of a string @{" strspn() " Link "strspn()"}-H0 Measure span of characters in set @{" stpbrk() " Link "stpbrk()"} Find break character in string @{" stpchr() " Link "stpchr()"} Find character in string @{" strchr() " Link "strchr()"} Find character in string @{" stpchrn() " Link "stpchrn()"} Find character not in string @{" strrchr() " Link "strrchr()"} Find character not in string @{" strpbrk() " Link "strpbrk()"} Find break character in string @{" strcat() " Link "strcat()"} Conca.܏{tenate strings @{" strncat() " Link "strncat()"} Concatenate strings, length-limited @{" strcmp() " Link "strcmp()"} Compare strings @{" strcmpi() " Link "strcmpi()"} Compare strings, case-insensitive @{" stricmp() " Link "stricmp()"} Compare strings, case-insensitive @{" strncmp() " Link "strncmp()"} Compare strings, length-limited @{" strnicmp() " Link "strnicmp()"} Compare strings, case-insensitive, length-limited @{" strnset() " Link "strns/Det()"} Set string to value, length-limited @{" strset() " Link "strset()"} Set string to value @{" strtok() " Link "strtok()"} Get a token @{" stcarg() " Link "stcarg()"} Get an argument @{" stpsym() " Link "stpsym()"} Get next symbol from a string @{" stptok() " Link "stptok()"} Get next token from a string @{" stpblk() " Link "stpblk()"} Skip blanks @{" strbpl() " Link "strbpl()"} Build string pointer list @{" strdup() " Link 0>< "strdup()"} Duplicate a string @{" strins() " Link "strins()"} Insert a string @{" strrev() " Link "strrev()"} Reverse a character string @{" strmid() " Link "strmid()"} Return a substring from a string @{" strstr() " Link "strstr()"} Locate a sub-string inside of a string @EndNode @Node "ConvFuncs" @{" atof() " Link "atof()"} Convert ASCII to float @{" atoi() " Link "atoi()"} Convert ASCII to integer @{" atol() " Link "atol(12q)"} Convert ASCII to long integer @{" stcd_i() " Link "stcd_i()"} Convert decimal string to integer @{" stcd_l() " Link "stcd_l()"} Convert decimal string to long integer @{" ecvt() " Link "ecvt()"} Convert double to string @{" fcvt() " Link "fcvt()"} Convert float to string @{" gcvt() " Link "gcvt()"} Convert float to string @{" stch_i() " Link "stch_i()"} Convert hexadecimal string to integer @{" stch_l() " Link "stch_l(2/Ks)"} Convert hexadecimal string to long integer @{" stci_d() " Link "stci_d()"} Convert integer to decimal string @{" stci_h() " Link "stci_h()"} Convert integer to hexadecimal string @{" stci_o() " Link "stci_o()"} Convert integer to octal string @{" stcl_d() " Link "stcl_d()"} Convert long integer to decimal string @{" stcl_h() " Link "stcl_h()"} Convert long integer to hexadecimal string @{" stcl_o() " Link "stcl_o()"} Convert long 3integer to octal string @{" stco_i() " Link "stco_i()"} Convert octal string to integer @{" stco_l() " Link "stco_l()"} Convert octal string to long integer @{" stcu_d() " Link "stcu_d()"} Convert unsigned integer to decimal string @{" stcul_d() " Link "stcul_d()"} Convert unsigned long to decimal string @{" strlwr() " Link "strlwr()"} Convert string to lower case @{" strtod() " Link "strtod()"} Convert string to double @{" strtol() 4 -- " Link "strtol()"} Convert string to long integer @{" strtoul() " Link "strtoul()"} Convert string to unsigned long integer @{" toascii() " Link "toascii()"} Convert character to ASCII @{" tolower() " Link "tolower()"} Convert character to lower case @{" toupper() " Link "toupper()"} Convert character to upper case @{" mbstowcs() " Link "mbstowcs()"} Convert multibyte string to wide character string @{" wcstombs() " Link "wcstombs()"} Conve5,WDrt a wide-character string to a multibyte string @{" stpdate() " Link "stpdate()"} Convert date array to string @{" stptime() " Link "stptime()"} Convert time array to string @{" mktime() " Link "mktime()"} Convert broken down time to time_t value @{" __timecvt() " Link "__timecvt()"} Convert time_t value to AmigaDOS DateStamp @{" utpack() " Link "utpack()"} Pack @{" UNIX " Link "Glossary - UNIX"} time @{" utunpk() " Link "utunpk()"} Unpack 6@{" UNIX " Link "Glossary - UNIX"} time @EndNode @Node "MathFuncs" @{" abs() " Link "abs()"} absolute value @{" acos() " Link "acos()"} Arccosine function @{" asin() " Link "asin()"} Arcsine function @{" atan() " Link "atan()"} Arctangent function @{" atan2() " Link "atan2()"} Arctangent of x/y @{" ceil() " Link "ceil()"} Get floating point limits @{" cos() " Link "cos()"} cosine function @{" cosh() " Link "cosh()"} Hyperbolic cosine 7Cfunction @{" cot() " Link "cot()"} cotangent function @{" div() " Link "div()"} Return quotient and remainder for divide @{" exp() " Link "exp()"} exponential function @{" fabs() " Link "fabs()"} Float/double absolute value @{" floor() " Link "floor()"} Get floor of a real number @{" fmod() " Link "fmod()"} Float modulus operations @{" frexp() " Link "frexp()"} Split float value @{" iabs() " Link "iabs()"} Integer absolute value @{"8a, labs() " Link "labs()"} Long integer absolute value @{" ldexp() " Link "ldexp()"} Combine float value @{" ldiv() " Link "ldiv()"} Return long quotient and remainder for divide @{" log() " Link "log()"} Natural logarithm function @{" log10() " Link "log10()"} Base 10 logarithm function @{" max() " Link "max()"} Compute maximum of two values @{" min() " Link "min()"} Compute miminum of two values @{" modf() " Link "modf()"} Split floating 9point value @{" pow() " Link "pow()"} raise a number to a power @{" pow2() " Link "pow2()"} raise 2 to a power @{" sin() " Link "sin()"} sine function @{" sinh() " Link "sinh()"} Hyperbolic sine function @{" sqrt() " Link "sqrt()"} Square root function @{" tan() " Link "tan()"} tangent function @{" tanh() " Link "tanh()"} Hyperbolic tangent function @EndNode @Node "VarArgFuncs" @{" va_arg() " Link "va_arg()"} Get next argument from:PhF list @{" va_end() " Link "va_end()"} Terminate access to argument list @{" va_start() " Link "va_start()"} Initiate access to argument list @EndNode @Node "GeneralFuncs" @{" __emit() " Link "__emit()"} Emit 68000 instruction word @{" getreg() " Link "getreg()"} Get 68000-specific registers @{" putreg() " Link "putreg()"} Set up 68000-specific registers @{" geta4() " Link "geta4()"} Establish addressability to the global data area @{" isat;ty() " Link "isatty()"} Test file descriptor for terminal @{" ovlyMgr() " Link "ovlyMgr()"} Overlay manager call point @{" offsetof() " Link "offsetof()"} Get offset of structure member @EndNode @Node "SortFuncs" @{" bsearch() " Link "bsearch()"} Perform a binary search @{" dqsort() " Link "dqsort()"} Sort an array of doubles @{" fqsort() " Link "fqsort()"} Sort an array of floats @{" lqsort() " Link "lqsort()"} Sort an array of long integers <?E @{" qsort() " Link "qsort()"} Sort a data array @{" sqsort() " Link "sqsort()"} Sort an array of short integers @{" strsrt() " Link "strsrt()"} Sort string pointer list @{" tqsort() " Link "tqsort()"} Sort an array of text pointers @EndNode @Node "RandFuncs" @{" drand48() " Link "drand48()"} Generate random double (internal seed) @{" erand48() " Link "erand48()"} Generate random double (external seed) @{" mrand48() " Link "mrand48()"} Generate r=_andom long (internal seed) @{" jrand48() " Link "jrand48()"} Generate random long (external seed) @{" lrand48() " Link "lrand48()"} Generate random positive long (internal seed) @{" nrand48() " Link "nrand48()"} Generate random positive long (external seed) @{" rand() " Link "rand()"} Generate a random number @{" seed48() " Link "seed48()"} Set all 48 bits of internal seed @{" srand() " Link "srand()"} Set seed for rand() function @{" srand48() >[" Link "srand48()"} Set high 32 bits of internal seed @{" lcong48() " Link "lcong48()"} Set linear congruence parameters @EndNode @Node "ProgFuncs" @{" abort() " Link "abort()"} abort the current process @{" atexit() " Link "atexit()"} Set an exit trap @{" chkabort() " Link "chkabort()"} Check for break character @{" Chk_abort() " Link "chkabort()"} Check for break character @{" _CXBRK() " Link "_CXBRK()"} Default signal handler for SIGINT ?sh @{" exit() " Link "exit()"} Terminate program execution @{" __exit() " Link "__exit()"} Terminate program execution with no clean-up @{" onexit() " Link "onexit()"} Set an exit trap @{" _XCEXIT() " Link "_XCEXIT()"} Terminate program and close files @{" forkl() " Link "forkl()"} create a child process with argument list @{" forkv() " Link "forkv()"} create a child process with argument vector @{" longjmp() " Link "longjmp()"} @+Perform long jump @{" setjmp() " Link "setjmp()"} Set long jump parameters @{" onbreak() " Link "onbreak()"} Plant break trap @{" wait() " Link "wait()"} wait for a single child process to complete @{" waitm() " Link "waitm()"} wait for multiple child processes to complete @{" raise() " Link "raise()"} Generate a signal @{" signal() " Link "signal()"} Establish event traps @EndNode @Node "AllocFuncs" @{" bldmem() " Link "bldAWmem()"} Build a memory pool of specified size @{" rstmem() " Link "rstmem()"} Reset memory pool @{" sizmem() " Link "sizmem()"} Get memory pool size @{" chkml() " Link "chkml()"} Check for largest memory block @{" getmem() " Link "getmem()"} Get memory block (short) @{" getml() " Link "getml()"} Get memory block (long) @{" halloc() " Link "halloc()"} Allocate a huge memory block @{" lsbrk() " Link "lsbrk()"} ABm2ժllocate memory @{" sbrk() " Link "sbrk()"} Allocate memory @{" calloc() " Link "calloc()"} Allocate and clear memory @{" malloc() " Link "malloc()"} Allocate memory @{" realloc() " Link "realloc()"} reallocate memory @{" free() " Link "free()"} free memory @{" _MemCleanup() " Link "_MemCleanup()"} Deallocate all allocated memory @{" rbrk() " Link "rbrk()"} Release memory @{" rlsmem() " Link "rlsmem()"} ReCUYlease a memory block @{" rlsml() " Link "rlsml()"} Release a memory block @EndNode @Node "MemoryFuncs" @{" memchr() " Link "memchr()"} Find a character in a memory block @{" memcmp() " Link "memcmp()"} Compare two memory blocks @{" memcpy() " Link "memcpy()"} Copy a memory block @{" memccpy() " Link "memccpy()"} Copy a memory block up to a char @{" memmove() " Link "memmove()"} Copy bytes in memory @{" memset() " Link "memset()"} Set a meD4mory block to a value @{" movmem() " Link "movmem()"} Move a memory block @{" repmem() " Link "repmem()"} Replicate values through a block @{" setmem() " Link "setmem()"} Set a memory block to a value @{" swmem() " Link "swmem()"} Swap two memory blocks @EndNode @Node "DiagFuncs" @{" assert() " Link "assert()"} assert program validity @{" except() " Link "except()"} Call math error handler @{" __matherr() " Link "__matherr()"} Math errorEtM. handler @{" perror() " Link "perror()"} Print error message @{" poserr() " Link "poserr()"} Print AmigaDOS error message @{" strerror() " Link "strerror()"} Print text for a given error number @EndNode @Node "TimeFuncs" @{" asctime() " Link "asctime()"} Generate ASCII time string @{" clock() " Link "clock()"} Measure program processor time @{" datecmp() " Link "datecmp()"} Compare two AmigaDOS dates @{" difftime() " Link "difftime()"F!} Compute difference between two time_t values @{" gmtime() " Link "gmtime()"} Unpack Greenwich Mean Time (GMT) @{" localtime() " Link "localtime()"} Unpack local time @{" mktime() " Link "mktime()"} Convert broken down time to time_t value @{" strftime() " Link "strftime()"} Format time string @{" time() " Link "time()"} Get system time in seconds @{" __timecvt() " Link "__timecvt()"} Convert time_t value to AmigaDOS DateStamp @{" timerGop&d() " Link "timer()"} Get system clock with microseconds @{" __tzset() " Link "__tzset()"} Set time zone variable @{" utpack() " Link "utpack()"} Pack @{" UNIX " Link "Glossary - UNIX"} time @{" utunpk() " Link "utunpk()"} Unpack @{" UNIX " Link "Glossary - UNIX"} time @EndNode @Node "IOFuncs" @{" Standard I/O Functions " Link "StdIOFuncs"} @{" Character I/O Functions " Link "CharIOFuncs"} @{" String I/O Functions " Link "StringIOFunH޶cs"} @{" Block I/O Functions " Link "BlockIOFuncs"} @{" Formatted I/O Functions " Link "FmtIOFuncs"} @{" Error Handling Functions " Link "ErrFuncs"} @{" File Control Functions " Link "FileContFuncs"} @{" File Positioning Functions " Link "FilePosFuncs"} @EndNode @Node "StdIOFuncs" Do not use these functions with the NOSTDIO option. @{" getch() " Link "getch()"} Get a character from stdin immediately @{" getchar() " Link "getchar()"} Get HV3210/.-,+*)('&%$#"!  4I:a character from stdin @{" fgetchar() " Link "fgetchar()"} Get a character from stdin @{" fputchar() " Link "fputchar()"} Put a character to stdout @{" putchar() " Link "putchar()"} Put a character to stdout @{" gets() " Link "gets()"} Get string from stdin @{" puts() " Link "puts()"} Put string to stdout @{" printf() " Link "printf()"} Formatted print to stdout @{" scanf() " Link "scanf()"} Formatted input conversions @{" vprintf()J4JM " Link "vprintf()"} Varargs formatted write to standard output @EndNode @Node "CharIOFuncs" @{" fgetc() " Link "fgetc()"} Get a character from a file @{" getc() " Link "getc()"} Get a character from a file @{" ungetc() " Link "ungetc()"} Push input character back @{" getch() " Link "getch()"} Get a character from stdin immediately @{" getchar() " Link "getchar()"} Get a character from stdin @{" fgetchar() " Link "fgetchar()"} Get a charKN[4acter from stdin @{" fputc() " Link "fputc()"} Put a character to a level 2 file @{" fputchar() " Link "fputchar()"} Put a character to stdout @{" putc() " Link "putc()"} Put a character to a level 2 file @{" putchar() " Link "putchar()"} Put a character to stdout @EndNode @Node "StringIOFuncs" @{" fgets() " Link "fgets()"} Get string from a level 2 file @{" gets() " Link "gets()"} Get string from stdin @{" fputs() " Link "fputs()"} Put stLgӪring to level 2 file @{" puts() " Link "puts()"} Put string to stdout @EndNode @Node "BlockIOFuncs" @{" fread() " Link "fread()"} read and write blocks @{" fwrite() " Link "fwrite()"} write blocks to a level 2 file @{" read() " Link "read()"} read from a level 1 file @{" write() " Link "write()"} write to level 1 file @EndNode @Node "FmtIOFuncs" @{" fprintf() " Link "fprintf()"} Formatted print @{" printf() " Link "printf()"} Formatted priM[ynt to stdout @{" sprintf() " Link "sprintf()"} Formatted print to a string @{" fscanf() " Link "fscanf()"} Formatted input conversions @{" scanf() " Link "scanf()"} Formatted input conversions @{" sscanf() " Link "sscanf()"} Formatted input conversions @{" vfprintf() " Link "vfprintf()"} Varargs formatted write to a file @{" vprintf() " Link "vprintf()"} Varargs formatted write to standard output @{" vsprintf() " Link "vsprintf()"} Varargs NK5Cformatted write to string @EndNode @Node "ErrFuncs" @{" feof() " Link "feof()"} Check for level 2 end-of-file @{" ferror() " Link "ferror()"} Check for level 2 error @{" clearerr() " Link "clearerr()"} Clear level 2 I/O error flag @{" clrerr() " Link "clrerr()"} Clear level 2 I/O error flag @EndNode @Node "FileContFuncs" @{" close() " Link "close()"} close a level 1 file @{" fclose() " Link "fclose()"} close a level 2 file @{" fcloseaO620ll() " Link "fcloseall()"} close all level 2 files @{" tmpnam() " Link "tmpnam()"} create a temporary file name @{" creat() " Link "creat()"} create a level 1 file @{" fdopen() " Link "fdopen()"} Attach level 1 file to level 2 @{" fileno() " Link "fileno()"} Get file number for a level 2 file @{" fmode() " Link "fmode()"} Change mode of level 2 file @{" iomode() " Link "iomode()"} Change mode of level 1 file @{" open() " LinPek "open()"} open a level 1 file @{" fopen() " Link "fopen()"} open a level 2 file @{" tmpfile() " Link "tmpfile()"} open a temporary file stream @{" freopen() " Link "freopen()"} Reopen a level 2 file @{" fflush() " Link "fflush()"} Flush level 2 output buffer @{" flushall() " Link "flushall()"} Flush all level 2 output buffers @{" setbuf() " Link "setbuf()"} Set buffer mode for a level 2 file @{" setnbf() " Link "setnbf()"} Set Qӡ8 non-buffer mode for level 2 file @{" setvbuf() " Link "setvbuf()"} Set variable buffer for level 2 file @EndNode @Node "FilePosFuncs" @{" fseek() " Link "fseek()"} Set level 2 file position @{" lseek() " Link "lseek()"} Set level 1 file position @{" fgetpos() " Link "fgetpos()"} Store current file position @{" fsetpos() " Link "fsetpos()"} Reposition a file @{" ftell() " Link "ftell()"} Get level 2 file position @{" tell() " Link "tell()"}RX Get level 1 file position @{" rewind() " Link "rewind()"} Reset level 2 file position to first byte @EndNode @Node "FileManFuncs" @{" access() " Link "access()"} Check file accessibility @{" chkufb() " Link "chkufb()"} Check level 1 file handle @{" fileno() " Link "fileno()"} Get file number for a level 2 file @{" chmod() " Link "chmod()"} Change file protection mode @{" fmode() " Link "fmode()"} Change mode of level 2 file @{" iomode() "S-h Link "iomode()"} Change mode of level 1 file @{" fstat() " Link "fstat()"} Get information on a level 2 file @{" getfa() " Link "getfa()"} Get file attribute @{" getft() " Link "getft()"} Get file time() @{" stat() " Link "stat()"} Get information on a file @{" stcgfe() " Link "stcgfe()"} Get file name extension @{" stcgfn() " Link "stcgfn()"} Get file node @{" stcgfp() " Link "stcgfp()"} Get file path @{" strmfe() " Link "strmfe(Tw.)"} Make file name with extension @{" strmfn() " Link "strmfn()"} Make file name from components @{" strmfp() " Link "strmfp()"} Make file name from path/node @{" strsfn() " Link "strsfn()"} Split the file name @{" unlink() " Link "unlink()"} remove a file @{" remove() " Link "remove()"} remove a file @{" rename() " Link "rename()"} rename a file @{" setbuf() " Link "setbuf()"} Set buffer mode for a level 2 file @{" setnbf() " Link "setUטWKInbf()"} Set non-buffer mode for level 2 file @{" setvbuf() " Link "setvbuf()"} Set variable buffer for level 2 file @EndNode @Node "SysFuncs" @{" argopt() " Link "argopt()"} Get options from argument list @{" chgclk() " Link "chgclk()"} Change system clock @{" getclk() " Link "getclk()"} Get or change system clock @{" getasn() " Link "getasn()"} Search for device or assigned name @{" getdfs() " Link "getdfs()"} Get disk free space @{V)E7" getenv() " Link "getenv()"} Get environment variable @{" putenv() " Link "putenv()"} Put string into environment @{" rawcon() " Link "rawcon()"} Set/unset raw console input @{" stacksize() " Link "stacksize()"} Get the current stack size @{" stackused() " Link "stackused()"} Get the amount of stack used @{" system() " Link "system()"} Call system command processor @EndNode @Node "DirFuncs" @{" chdir() " Link "chdir()"} Change current W٧,directory @{" closedir() " Link "closedir()"} Terminate directory operation @{" dfind() " Link "dfind()"} Find directory entry @{" dnext() " Link "dnext()"} Find next directory entry @{" findpath() " Link "findpath()"} Locate file in the current path @{" getcd() " Link "getcd()"} Get current directory @{" getcwd() " Link "getcwd()"} Get current working directory @{" getfnl() " Link "getfnl()"} Get filename list @{" getpath() " Link X$"getpath()"} Get the path for a specific directory/file @{" mkdir() " Link "mkdir()"} Make a new directory @{" opendir() " Link "opendir()"} Initiate directory operation @{" readdir() " Link "readdir()"} read directory element @{" rmdir() " Link "rmdir()"} remove a directory @{" seekdir() " Link "seekdir()"} Reposition directory operation @{" telldir() " Link "telldir()"} Get directory position @EndNode @Node "LocalFuncs" @{" localeconv()Y7 " Link "localeconv()"} Return info on locale formatting conventions @{" readlocale() " Link "readlocale()"} read and initialize a new locale @{" setlocale() " Link "setlocale()"} Set locale information for program @{" strcoll() " Link "strcoll()"} Compare strings based on locale @{" strxfrm() " Link "strxfrm()"} Transform a string @EndNode @Node "MultiFuncs" @{" mblen() " Link "mblen()"} Determine length of multibyte character @{" mbstowcs() Zܰ>ل" Link "mbstowcs()"} Convert multibyte string to wide character string @{" mbtowc() " Link "mbtowc()"} Maps a multibyte character to a wide character @{" wcstombs() " Link "wcstombs()"} Convert a wide-character string to a multibyte string @{" wctomb() " Link "wctomb()"} Map wide character to multibyte character @EndNode @Node "NoCallFuncs" @{" _CXFERR() " Link "_CXFERR()"} Low-level float error @{" _CXOVF() " Link "_CXOVF()"} Default stack overflow h[붩zandler @EndNode @Node "BltinFuncs" @{" strcpy() " Link "strcpy()"} Copy one string to another @{" strlen() " Link "strlen()"} Measure length of a string @{" strcmp() " Link "strcmp()"} Compare strings @{" memcmp() " Link "memcmp()"} Compare two memory blocks @{" memcpy() " Link "memcpy()"} Copy a memory block @{" memset() " Link "memset()"} Set a memory block to a value @{" abs() " Link "abs()"} absolute value @{" max() " Link "max()"} C\M void abort(void); Portability @{" ANSI " Link "Glossary - ANSI"} See Also @{" exit() " Link "exit()"} , @{" __exit() " Link "__exit()"} , @{" raise() " Link "raise()"} , @{" _XCEXIT() " Link "_XCEXIT()"} @EndNode @Node "abs()" abs()-absolute valu^=Ye Synopsis #include ax = abs(x); type x; type ax; Portability @{" ANSI " Link "Glossary - ANSI"} Returns The return value is the absolute value of the argument. See Also @{" fabs() " Link "fabs()"} , @{" iabs() " Link "iabs()"} , @{" labs() " Link "labs()"} @EndNode @Node "access()" access()-Check file accessibility Synopsis #include ret = access(name,mode); int ret; /* return code */ const char *name; /