X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=ckcplm.txt;h=e00edde746a0c17c0a5fe30dfbef5a60fb4c1689;hb=refs%2Fheads%2Fpatches%2F020_man-hyphen-quoting;hp=fc7595aedd91f68a8300316b868b435787b8e698;hpb=af31aedfbbaa6cb3897ecb795593629203a086b1;p=ckermit.git diff --git a/ckcplm.txt b/ckcplm.txt index fc7595a..e00edde 100644 --- a/ckcplm.txt +++ b/ckcplm.txt @@ -231,7 +231,7 @@ foo(x,y) int x, y; { be selected by defining a symbol, which, if not defined, leaves the program exactly as it was before the changes. * Although it might be possible to "clean up" the "#ifdef mess", - nobody has accesss to all the hundreds of platforms served by the + nobody has access to all the hundreds of platforms served by the #ifdefs to check the results. And to answer the second-most-oft-repeated question: "Why don't you @@ -961,7 +961,7 @@ foo(x,y) int x, y; { calling and return conventions, and has the same type. The Group E modules contain both functions and global variables that - are accesssed by modules in the other groups. These are now described. + are accessed by modules in the other groups. These are now described. (By the way, I got this list by linking all the C-Kermit modules together except ckutio and ckufio. These are the symbols that ld @@ -1082,7 +1082,7 @@ foo(x,y) int x, y; { char *dftty; Default communication device. Set by Group E module. Used in - many places. This variable should be initialized the the symbol + many places. This variable should be initialized the symbol CTTNAM, which is defined in ckcdeb.h, e.g. as "/dev/tty" for UNIX, "TT:" for VMS, etc. Example: char *dftty = CTTNAM; @@ -1147,7 +1147,7 @@ foo(x,y) int x, y; { #define ZSYSFN 8 /* Input from a system function (pipe) */ #define ZRFILE 9 /* Local file for READ command */ (NEW) #define ZWFILE 10 /* Local file for WRITE command */ (NEW) - #define ZMFILE 11 /* Auxilliary file for internal use */ (NEW) + #define ZMFILE 11 /* Auxiliary file for internal use */ (NEW) #define ZNFILS 12 /* How many defined file numbers */ In the descriptions below, fn refers to a filename, and n refers to one @@ -1244,8 +1244,7 @@ foo(x,y) int x, y; { Check to see if file with name fn is a regular, readable, existing file, suitable for Kermit to send -- not a directory, not a symbolic link, etc. Returns: - -3: if file exists but is not accesssible (e.g. - read-protected); + -3: if file exists but is not accessible (e.g. read-protected); -2: if file exists but is not of a readable type (e.g. a directory); -1: on error (e.g. file does not exist, or fn is garbage); @@ -1261,7 +1260,7 @@ foo(x,y) int x, y; { long zgetfs(fn) char *fn; - Gets the size of the given file, regardless of accesssibility. + Gets the size of the given file, regardless of accessibility. Used for directory listings. Unlike zchki(), should return the size of any kind of file, even a directory. zgetfs() also should serve as a mini "get file info" function that can be used until @@ -1384,9 +1383,9 @@ foo(x,y) int x, y; { int zsetroot(char * dir) - Sets the root for the user's file accesss, like Unix chroot(), + Sets the root for the user's file access, like Unix chroot(), but does not require privilege. In Unix, this must be - implemented entirely by Kermit's own file accesss routines. + implemented entirely by Kermit's own file access routines. Returns: 1: Success -1: Invalid argument @@ -1741,7 +1740,7 @@ foo(x,y) int x, y; { int zxcmd(n,s) char *s; - Runs a system command so its output can be accesssed as if it + Runs a system command so its output can be accessed as if it were file n. The command is run in ordinary, unprivileged user mode. If n is ZSTDIO or ZCTERM, returns -1. @@ -1813,7 +1812,7 @@ foo(x,y) int x, y; { isn't. Makes any appropriate system log entries (IKSD logins, failed login attempts, etc). If password is valid, logs the user in as herself (if real user), or sets up restricted anonymous - accesss if user is guest (e.g. changes file-system root to + access if user is guest (e.g. changes file-system root to anonroot and sets isguest = 1). VOID @@ -1835,14 +1834,14 @@ foo(x,y) int x, y; { installed to prevent such security breaches by turning off the program's special privileges at all times except when they are needed. - In UNIX, the only need Kermit has for privileged status is accesss to + In UNIX, the only need Kermit has for privileged status is access to the UUCP lockfile directory, in order to read, create, and destroy lockfiles, and to open communication devices that are normally protected against the user (see the [133]Unix C-Kermit Installation Instructions for discussion). Therefore, privileges should only be enabled for these operations and disabled at all other times. This relieves the programmer of the responsibility of putting expensive and - unreliable accesss checks around every file accesss and subprocess + unreliable access checks around every file access and subprocess creation. Strictly speaking, these functions are not required in all C-Kermit @@ -1889,7 +1888,7 @@ foo(x,y) int x, y; { Attempts to turns privileges off in such a way that they can be turned on again later. Then checks to make sure that they were really turned off. If they were not really turned off, then they - are cancelled permanently. Returns: + are canceled permanently. Returns: 0 on success nonzero on failure @@ -2061,9 +2060,9 @@ foo(x,y) int x, y; { int ttclos() Closes the communication device (tty or network). If there were - any kind of exclusive accesss locks connected with the tty, - these are released. If the tty has a modem connection, it is - hung up. For true tty devices, the original tty device modes are + any kind of exclusive access locks connected with the tty, these + are released. If the tty has a modem connection, it is hung up. + For true tty devices, the original tty device modes are restored. Returns: -1: on failure. 0: on success. @@ -2267,9 +2266,9 @@ foo(x,y) int x, y; { <=0: no timer, wait forever (e.g. for incoming call). For real tty devices, ttopen() attempts to gain - exclusive accesss to the tty device, for example in + exclusive access to the tty device, for example in UNIX by creating a "lockfile" (in other operating - systems, like VMS, exclusive accesss probably + systems, like VMS, exclusive access probably requires no special action). Side effects: @@ -2283,8 +2282,8 @@ foo(x,y) int x, y; { Returns: 0: on success -5: if device is in use - -4: if accesss to device is denied - -3: if accesss to lock mechanism denied + -4: if access to device is denied + -3: if access to lock mechanism denied -2: upon timeout waiting for device to open -1: on other error @@ -2880,7 +2879,7 @@ I.1. Format of System-Dependent File Permissions in A-Packets For UNIX (System ID = U1), it's the familiar 3-digit octal number, the low-order 9 bits of the filemode: Owner, Group, World, e.g. 660 = - read/write accesss for owner and group, none for world, recorded as a + read/write access for owner and group, none for world, recorded as a 3-digit octal string. High-order UNIX permission bits are not transmitted.