Chapter 4. Bugs
cole developers have done their best effort to fix all the bugs of cole. But may be some of the are still hidden in the code. If you found one (or many!), please send a report to the maintainer (<arturo@directmail.org>). When sending a report, please:
Describe with detail the behavior of cole and why you think it's a bug.
Configure cole using the argument --enable-verbose and send the output showing the bug.
Send the content of the variables cole_version and cole_host_info that the cole release you are using have. You wil have to write a little program to do this, but it will help much. =)
If you can, send the most small source code that shows the bug in action. May be you want to send the Structured Storage file you have been processing.
You can send the files config.log and config.cache (which were created by configure) if you want.
Thank you very much.
Following is the BUGS file for this release.
Report bugs to the maintainer (see the file `AUTHORS' for details). Please, along with your detailed report, send the cole's output when compiled using `--enable-verbose' (see the files `README' and `INSTALL' for details). Current bugs: ************** None. Fixed bugs: ************ Reported that cole can't read files biggers that 8Mb. UPDATE: oledecod.c is changed now to read additional blocks to the bbd. This fixes the bug. Reported strange bug in cole 0.1.0 using Solaris using `../demo sprsheet.xls' in examples directory. We need more test there! UPDATE: Seems to be fixed in cole 1.0.0 with the endianess care code. Possible bugs: ************** * cole is not reentrant safe (it's in TODO): What happend if, in any program, one user tries to decode and/or code two files (the same or diferent)? Because static vars, will it get broke? I think yes, mmmh... |
API
Synopsis
#include <cole/cole.h> #define COLE_MAJOR_VERSION #define COLE_MINOR_VERSION #define COLE_MICRO_VERSION extern int cole_major_version; extern int cole_minor_version; extern int cole_micro_version; extern char *cole_version; extern char *cole_host_info; enum COLERRNO; void cole_perror (const char *s, COLERRNO colerrno); struct COLEFS; struct COLEDIR; struct COLEDIRENT; struct COLEFILE; COLEFS* cole_mount (char *filename, COLERRNO *colerrno); int cole_umount (COLEFS *colefilesystem, COLERRNO *colerrno); int cole_print_tree (COLEFS *colefilesystem, COLERRNO *colerrno); int cole_locate_filename (COLEFS *colefilesystem, char *filename, void *info, COLE_LOCATE_ACTION_FUNC *action, COLERRNO *colerrno); int cole_recurse_tree (COLEFS *colefilesystem, void *info, COLE_RECURSE_DIR_FUNC *inroot, COLE_RECURSE_DIRENT_FUNC *indirentry, COLE_RECURSE_DIR_FUNC *indir, COLE_RECURSE_DIR_FUNC *outdir, COLE_RECURSE_VISIT_DIR_FUNC *visitdir, COLERRNO *colerrno); COLEFILE* cole_fopen (COLEFS *colefilesystem, char *filename, COLERRNO *colerrno); COLEFILE* cole_fopen_direntry (COLEDIRENT *coledirentry, COLERRNO *colerrno); int cole_fclose (COLEFILE *colefile, COLERRNO *colerrno); size_t cole_fread (COLEFILE *colefile, void *ptr, size_t size, COLERRNO *colerrno); int cole_feof (COLEFILE *colefile); size_t cole_fsize (COLEFILE *colefile); size_t cole_ftell (COLEFILE *colefile); int cole_fseek (COLEFILE *colefile, size_t delta, COLE_SEEK_FLAG direction, COLERRNO *colerrno); int cole_frewind (COLEFILE *colefile, COLERRNO *colerrno); COLEDIR* cole_opendir_rootdir (COLEFS *colefilesystem, COLERRNO *colerrno); COLEDIR* cole_opendir_direntry (COLEDIRENT *coledirentry, COLERRNO *colerrno); int cole_closedir (COLEDIR *coledir, COLERRNO *colerrno); COLEDIRENT* cole_visiteddirentry (COLEDIR *coledir); COLEDIRENT* cole_nextdirentry (COLEDIR *coledir); int cole_direntry_isdir (COLEDIRENT *coledirentry); int cole_direntry_isfile (COLEDIRENT *coledirentry); char* cole_dir_getname (COLEDIR *coledir); size_t cole_dir_getsize (COLEDIR *coledir); long cole_dir_getsec1 (COLEDIR *coledir); long cole_dir_getsec2 (COLEDIR *coledir); long cole_dir_getdays1 (COLEDIR *coledir); long cole_dir_getdays2 (COLEDIR *coledir); char* cole_direntry_getname (COLEDIRENT *coledirentry); size_t cole_direntry_getsize (COLEDIRENT *coledirentry); long cole_direntry_getdays1 (COLEDIRENT *coledirentry); long cole_direntry_getsec1 (COLEDIRENT *coledirentry); long cole_direntry_getdays2 (COLEDIRENT *coledirentry); long cole_direntry_getsec2 (COLEDIRENT *coledirentry); |
Description
Note: The separator character for filename components is '/'. So, a filename argument can be something like "/Macros/VB/Project1".
Details
enum COLERRNO
enum COLERRNO {
/* & = means that you can use perror(3) call to print an error message */
/* you can always use cole_perror to print an error message */
COLE_EFIRST, /* Leave this at first place */
/*&*/ COLE_EMEMORY, /* Failed malloc(3) or realloc(3) */
/*&*/ COLE_EOPENFILE, /* Failed fopen(3) */
/*&*/ COLE_ECLOSEFILE, /* Failed fclose(3) */
/*&*/ COLE_EREAD, /* Failed fread(3) */
/*&*/ COLE_EWRITE, /* Failed fwrite(3) */
/*&*/ COLE_EREMOVE, /* Failed remove(3) */
/*&*/ COLE_ETMPNAM, /* Failed tmpnam(3) */
/*&*/ COLE_ESEEK, /* Failed fseek(3) */
/*&*/ COLE_EERRNO, /* Some system call failed */
COLE_ENOFILESYSTEM, /* File is not a filesystem */
COLE_EINVALIDFILESYSTEM,/* Filesystem is broken, it's invalid */
COLE_EISNOTDIR, /* Directory entry is not a directory */
COLE_EISNOTFILE, /* Directory entry is not a file */
COLE_EFILENOTFOUND, /* Doesn't exist a file with the given name */
COLE_EOF, /* End of file has been reached */
COLE_EMEMBERISNOTDIR, /* A member of the filename is not
a directory */
COLE_EBROKENFILENAME, /* The filename is not right written */
COLE_EFILENAMEISNOTFILE,/* Filename is not a file */
COLE_EFSEEKDELTA, /* Delta argument is not valid */
COLE_EFSEEKFLAG, /* Flag argument is not valid */
COLE_EUNKNOWN, /* An unknown error ocurred, can be a bug */
COLE_ELAST /* Leave this at last place */
}; |
cole_perror ()
void cole_perror (const char *s,
COLERRNO colerrno); |
Prints a message on the standard error output, describing the error colerrno, preceding it with the string s, a semicolon and a space. It handles COLE_EERRNO value too, calling perror(3).
| s : | string to print before the error message. It can be NULL. |
| colerrno : | error value of which a message will be printed. |
struct COLEFS
struct COLEFS {
/* This structure is for internal use only, not for the public API */
pps_entry *tree;
U32 root; /* entry root, root pps_entry */
U8 *BDepot;
U8 *SDepot;
FILE *sbfile;
char *sbfilename;
FILE *file; /* actual file (the filesystem) */
}; |
struct COLEDIR
struct COLEDIR {
/* This structure is for internal use only, not for the public API */
U32 entry;
struct _COLEDIRENT visited_entry;
struct _COLEFS *fs; /* father */
}; |
struct COLEDIRENT
struct COLEDIRENT {
/* This structure is for internal use only, not for the public API */
U32 entry;
struct _COLEDIR *dir; /* father */
}; |
struct COLEFILE
struct COLEFILE {
/* This structure is for internal use only, not for the public API */
U32 entry;
FILE *file; /* actual extracted file */
char *filename; /* actual extracted file's name */
U32 filesize; /* actual extracted file size */
struct _COLEFS *fs; /* father */
U32 pos; /* file pointer position */
}; |
cole_mount ()
COLEFS* cole_mount (char *filename, COLERRNO *colerrno); |
Mounts the filesystem which is in filename.
| filename : | name of the file with the filesystem. |
| colerrno : | error value (COLE_EMEMORY, COLE_EOPENFILE, COLE_ENOFILESYSTEM, COLE_EINVALIDFILESYSTEM, COLE_EUNKNOWN). |
| Returns : | a filesystem in success, or NULL in other case. |
cole_umount ()
int cole_umount (COLEFS *colefilesystem, COLERRNO *colerrno); |
Umounts the filesystem colefilesystem.
| colefilesystem : | filesystem to umount. |
| colerrno : | error value (COLE_ECLOSEFILE, COLE_EREMOVE). |
| Returns : | zero in success, no zero in other case. |
cole_print_tree ()
int cole_print_tree (COLEFS *colefilesystem, COLERRNO *colerrno); |
Prints on the standard output the tree of files and directories contained in colefilesystem. Currently this call always success.
| colefilesystem : | filesystem of which the tree will be printed. |
| colerrno : | error value (errors from call cole_recurse_tree()). |
| Returns : | zero in success, no zero in other case. |
cole_locate_filename ()
int cole_locate_filename (COLEFS *colefilesystem, char *filename, void *info, COLE_LOCATE_ACTION_FUNC *action, COLERRNO *colerrno); |
Locate the filename in the filesystem colefilesystem, calling action when it's found. info is arbitrary pointer passed to action. Currently, filename must begin with a '/' character, it means filename is the absolute filename.
| colefilesystem : | filesystem where to locate filename. |
| filename : | name of the file or directory to be located. |
| info : | arbitrary pointer passed to action. |
| action : | pointer to the function that is called when founding filename. |
| colerrno : | error value (COLE_EUNKNOWN, COLE_EMEMBERISNOTDIR, COLE_EFILENOTFOUND, COLE_EBROKENFILENAME, errors from call cole_recurse_tree()). |
| Returns : | zero in success, 1 in other case. |
cole_recurse_tree ()
int cole_recurse_tree (COLEFS *colefilesystem, void *info, COLE_RECURSE_DIR_FUNC *inroot, COLE_RECURSE_DIRENT_FUNC *indirentry, COLE_RECURSE_DIR_FUNC *indir, COLE_RECURSE_DIR_FUNC *outdir, COLE_RECURSE_VISIT_DIR_FUNC *visitdir, COLERRNO *colerrno); |
Recurse the filesystem colefilesystem, calling the functions pointed by inroot, indirentry, indir and outdirectory when start visiting root directory, start visiting any directory entry (file or directory), start visiting a directory or end visiting a directory, respectively. If visitdir returns no zero or it's NULL, the directory is visited, otherwise is not visited. info is a arbitrary pointer which is passed to the functions pointed by inroot, indirentry, indir and outdirectory: it may be used to share arbitrary information between them.
| colefilesystem : | filesystem to recurse. |
| info : | arbitrary pointer passed to the functions. |
| inroot : | pointer to the function that is called when start visiting root directory. It can be NULL. |
| indirentry : | pointer to the function that is called when start visiting any directory entry (file or directory). It can be NULL. |
| indir : | pointer to the function that is called when start visiting a directory. It can be NULL. |
| outdir : | pointer to the function that is called when end visiting a directory. It can be NULL. |
| visitdir : | pointer to the function that is called to know if visit a directory. It can be NULL. |
| colerrno : | error value (errors from calls cole_opendir_rootdir(), cole_opendir_direntry(), cole_closedir() and inroot, indirentry, indir, and outdir functions). |
| Returns : | zero if recursed all the tree, no zero in other case. |
cole_fopen ()
COLEFILE* cole_fopen (COLEFS *colefilesystem, char *filename, COLERRNO *colerrno); |
Opens the file with the name filename in the filesystem colefilesystem. Currently, filename must begin with a '/' character, it means filename is the absolute filename.
| colefilesystem : | filesystem in which filename is in. |
| filename : | name of the file to open. |
| colerrno : | error value (COLE_EFILENOTFOUND, errors from calls cole_opendir_rootdir(), cole_fopen_direntry() and cole_locate_filename()). |
| Returns : | a file in success, or NULL in other case. |
cole_fopen_direntry ()
COLEFILE* cole_fopen_direntry (COLEDIRENT *coledirentry, COLERRNO *colerrno); |
Opens a directory entry as file.
| coledirentry : | directory entry to be opened as file. |
| colerrno : | error value (COLE_EISNOTFILE, COLE_EMEMORY, COLE_ETMPNAM, COLE_EOPENFILE, COLE_EINVALIDFILESYSTEM, COLE_EREAD, COLE_EWRITE, COLE_EUNKNOWN). |
| Returns : | a file in success, or NULL in other case. |
cole_fclose ()
int cole_fclose (COLEFILE *colefile, COLERRNO *colerrno); |
Closes the file colefile.
| colefile : | file to be closed. |
| colerrno : | error value (COLE_ECLOSEFILE, CLOSE_EREMOVE). |
| Returns : | zero in sucess, no zero in other case. |
cole_fread ()
size_t cole_fread (COLEFILE *colefile, void *ptr, size_t size, COLERRNO *colerrno); |
Reads size bytes from colefile and store them in the location given by ptr. If not success, the file position indicator is not changed.
| colefile : | file to be read. |
| ptr : | memory location where the bytes will be stored. |
| size : | how many bytes will be read. |
| colerrno : | error value (COLE_EOF, COLE_EREAD, COLE_ESEEK). |
| Returns : | in sucess the number of bytes actually readed (maximum size) or zero in other case. |
cole_feof ()
int cole_feof (COLEFILE *colefile); |
Tests if the end of file has been reached in colefile.
| colefile : | file to be tested. |
| Returns : | no zero if the end of file has been reached, zero in other case. |
cole_fsize ()
size_t cole_fsize (COLEFILE *colefile); |
| colefile : | file of which its size will be returned. |
| Returns : | the size in bytes of the file colefile. |
cole_ftell ()
size_t cole_ftell (COLEFILE *colefile); |
Get the current value of the file position indicator for the file colefile.
| colefile : | file of which the file position indicator will be get. |
| Returns : | The file position. |
cole_fseek ()
int cole_fseek (COLEFILE *colefile, size_t delta, COLE_SEEK_FLAG direction, COLERRNO *colerrno); |
Sets the value of the file position indicator for the file colefile delta bytes from the beginning of the file, forward from the current position, backward from the current position, or from the end of the file, if direction is COLE_SEEK_SET, COLE_SEEK_BACKWARD, COLE_SEEK_FORWARD or COLE_SEEK_END, respectively. The file position indicator will always be <= colefile->filesize. If you delta is such that the previous line would not true, cole_fseek fails.
| colefile : | file of which its file position indicator will be set. |
| delta : | number of bytes that the file position indicator will be moved. |
| direction : | from where start to count the delta bytes. |
| colerrno : | error value (COLE_EFSEEKDELTA). |
| Returns : | zero in success, no zero in other case. |
cole_frewind ()
int cole_frewind (COLEFILE *colefile, COLERRNO *colerrno); |
Sets the value of the file position indicator for the file colefile in the beginning of the file.
| colefile : | file of which its file position indicator will be rewind. |
| colerrno : | error value (error from call cole_fseek()). |
| Returns : | zero in success, no zero in other case. |
cole_opendir_rootdir ()
COLEDIR* cole_opendir_rootdir (COLEFS *colefilesystem, COLERRNO *colerrno); |
Opens the root directory of the filesystem colefilesystem as directory.
| colefilesystem : | filesystem of which the root directory will be opened. |
| colerrno : | error value (COLE_EMEMORY). |
| Returns : | a directory in success, or NULL in other case. |
cole_opendir_direntry ()
COLEDIR* cole_opendir_direntry (COLEDIRENT *coledirentry, COLERRNO *colerrno); |
Opens a directory entry as directory.
| coledirentry : | directory entry to be opened as directory. |
| colerrno : | error value (COLE_EISNOTDIR, COLE_EMEMORY). |
| Returns : | a directory in success, or NULL in other case. |
cole_closedir ()
int cole_closedir (COLEDIR *coledir, COLERRNO *colerrno); |
Closes the directory coledir. Currently this call always success.
| coledir : | directory to be closed. |
| colerrno : | error value(). |
| Returns : | zero in success, no zero in other case. |
cole_direntry_isdir ()
int cole_direntry_isdir (COLEDIRENT *coledirentry); |
Tests if the directory entry coledirentry is a directory.
| coledirentry : | directory entry to be tested. |
| Returns : | no zero if it is a directory, zero in other case. |
cole_direntry_isfile ()
int cole_direntry_isfile (COLEDIRENT *coledirentry); |
Tests if the directory entry coledirentry is a file.
| coledirentry : | directory entry to be tested. |
| Returns : | no zero if it is a directory, zero in other case. |
cole_direntry_getname ()
char* cole_direntry_getname (COLEDIRENT *coledirentry); |
| coledirentry : | |
| Returns : |
cole_direntry_getsize ()
size_t cole_direntry_getsize (COLEDIRENT *coledirentry); |
| coledirentry : | |
| Returns : |
cole_direntry_getdays1 ()
long cole_direntry_getdays1 (COLEDIRENT *coledirentry); |
| coledirentry : | |
| Returns : |
cole_direntry_getsec1 ()
long cole_direntry_getsec1 (COLEDIRENT *coledirentry); |
| coledirentry : | |
| Returns : |
cole_direntry_getdays2 ()
long cole_direntry_getdays2 (COLEDIRENT *coledirentry); |
| coledirentry : | |
| Returns : |
cole_direntry_getsec2 ()
long cole_direntry_getsec2 (COLEDIRENT *coledirentry); |
| coledirentry : | |
| Returns : |
Internals
Synopsis
struct COLEFS; struct COLEDIRENT; struct COLEDIR; struct COLEFILE; #define F32 #define F64 #define U8 #define U16 #define U32 U16 fil_sreadU16 (U8 *in); U32 fil_sreadU32 (U8 *in); F64 fil_sreadF64 (U8 *in); void fil_swriteU16 (U8 *dest, U16 *src); void fil_swriteU32 (U8 *dest, U32 *src); #define verbose_return () #define test (t,retval) #define test_exitf (t,retval,func) #define test_call (t,typeretval) #define test_call_exitf (t,typeretval,func) #define report_bug (prog) #define assert_return (prog,t,retval) #define verbose_d (n) #define verbose (s) #define verbose_wonl (s) #define verboseU8 (expr) #define verboseU16 (expr) #define verboseU32 (expr) #define verboseS (expr) #define verboseS_wonl (expr) #define warning (t) #define verboseU32Array (array,len) #define verboseU8Array_force (rec,len,reclen) #define verboseU8Array (rec,len,reclen) |
Details
struct COLEFS
struct COLEFS {
/* This structure is for internal use only, not for the public API */
pps_entry *tree;
U32 root; /* entry root, root pps_entry */
U8 *BDepot;
U8 *SDepot;
FILE *sbfile;
char *sbfilename;
FILE *file; /* actual file (the filesystem) */
}; |
struct COLEDIRENT
struct COLEDIRENT {
/* This structure is for internal use only, not for the public API */
U32 entry;
struct _COLEDIR *dir; /* father */
}; |
struct COLEDIR
struct COLEDIR {
/* This structure is for internal use only, not for the public API */
U32 entry;
struct _COLEDIRENT visited_entry;
struct _COLEFS *fs; /* father */
}; |
struct COLEFILE
struct COLEFILE {
/* This structure is for internal use only, not for the public API */
U32 entry;
FILE *file; /* actual extracted file */
char *filename; /* actual extracted file's name */
U32 filesize; /* actual extracted file size */
struct _COLEFS *fs; /* father */
U32 pos; /* file pointer position */
}; |
Copyright and disclaimer
This document is copyright 1999 by Roberto Arturo Tena Sánchez. This document is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This document is provided as is without any express or implied warranties. While every effort has been taken to ensure the accuracy of the information contained in this document, the author/maintainer/contributors assume(s) no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.
Features
cole 2.x release series:
Can open Structured Storage files generated with programs from Microsoft, StarDivision and FlashPix.
Is written in C, for better performance.
Should compile in UNIX-like systems with ANSI C libraries and a ANSI C compiler.
Has a new good-looking API, modelled after ANSI C stdio.h routines.
Uses standard automake, autoconf and libtool generated files.
Provides a standard configure script.
Builds shared (dynamic) libraries if the plattform and libtool support it.
Provides standard targets in the Makefile (ie. install, clean, etc).
Can use (thanks to the configure script) plattform dependent system calls for better performance.
| cole Library Reference Manual | ||
|---|---|---|
| Prev | Chapter 6. GNU GENERAL PUBLIC LICENSE | |
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found.
one line to give the program's name and a brief idea of what it does. Copyright (C) year name of author This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. |
The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. signature of Ty Coon, 1 April 1989 Ty Coon, President of Vice |
This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License.
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.
You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.
c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
Thus, it's not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program.
In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.
3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.
If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License.
7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.
It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it's up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.
This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.
10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
Chapter 6. GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it's not allowed.
Preamble
The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too.
When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.
Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and modification follow.
| Prev | Home | Next |
| Copyright and disclaimer | TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION |
Chapter 2. How to compile cole
The file INSTALL in the source code gives detailed instructions on how to configure, compile and install cole.
Briefly, you need to run the GNU standard configure script, with the arguments you want. To see the arguments that configure accepts, run ./configure --help. The most usual argument is --prefix=PREFIX, which tells configure to install cole in the directory PREFIX. After that, you need to run make to compile cole, and make install to install it.
The configure script accepts, besides the standard arguments, the following flags:
| --enable-osf-check. Turn on short align for OSF compiler. If you have errors while compiling under OSF1, enable this flag. |
| --enable-verbose. Turn on verbose. It is useful if you want to send a bug report. It is useful for cole developers too. |
| --enable-debug Turn on GNU CC debug flags. It is useful for cole developers, so may be you don't want to use it. |
A tipical session is shown below.
$ ls cole-2.0.0.tar.gz $ gzip -d cole-2.0.0.tar.gz $ tar -xf cole-2.0.0.tar $ ls cole-2.0.0.tar cole-2.0.0/ $ cd cole-2.0.0 $ ./configure --prefix=/opt ... Configured cole release 2.0.0 $ make ... $ make install ... $ make clean ... |
When installing, a shell script named cole-config will be installed in PREFIX/bin if you used the the --prefix=PREFIX argument, or in /usr/local/bin if you didn't. That directory must be listed in the content of the enviroment variable PATH when configuring another program that uses cole.
If you system support it, will be compiled and installed shared libraries, to minimize size of the executables. By this reason, is important to include the directory PREFIX/bin or /usr/local/bin (which appropiate) in the file that your system command ldconfig reads in order to regenerate the list of shared libraries (in some systems, you can list the directory in the content of the enviroment variable LD_LIBRARY_PATH instead).
- Table of Contents
- 1. Introduction
- 2. How to compile cole
- 3. cole Library
- 4. Bugs
- 5. Legal issues
- 6. GNU GENERAL PUBLIC LICENSE
| Next | ||
| Introduction |
Chapter 1. Introduction
- Table of Contents
- What is cole?
- Features
- Requirements to compile
What is cole?
cole is a free C OLE library.
cole is distributed under the terms of the GNU General Public License (GPL) to give an impulse to the Free Software. cole distribution license is compatible with the Open Source definition.
Using cole, you can access Microsoft' Structured Storage files. The most popular Microsoft's programs generate Structured Storage files, incluiding the Microsoft' suite for offices. StarDivision' suite (StarOffice) generate Structured Storage files too. FlashPix file format is Structured Storage too.
What is a Structured Storage file? Inside a Structured Storage file there is a filesystem, with directories and files, which Microsoft calls containers and streams. Using cole you can travel through such filesystem and access the files.
cole doesn't know about internal structure of a stream, it only reads the raw data. You can use the Microsoft's documentation available at http://msdn.microsoft.com or the information available at http://www.wotsit.org to know the binary file format of the streams. If you know anything in the side of StarDivision email me. FlashPix file format is well documented.
cole was developed using the information available at http://wwwwbs.cs.tu-berlin.de/~schwartz/pmh/guide.html and the OLE::Storage Perl module from the same site, and no information from any other source (incluiding Microsoft) has been used.
Chapter 5. Legal issues
- Table of Contents
- Distribution and Freedom
- Trademarks
- Copyright and disclaimer
Distribution and Freedom
cole is Free Software, which means is distributed under a license that protect your freedom. cole distribution license is compatible with the Open Source definition.
cole is distributed under the terms of the GNU General Public License (GPL). A copy of the license is in the file COPYING in the source code and in this document. Particulary, this means at least two things:
All the code statically or dinamically linked against cole must be distributed under the terms of a license compatible with GPL.
If you change the cole source code and you want to distribute a compiled version, you must release the changed cole source code too.
Chapter 3. cole Library
This is the documentation autogenerated from the source code. It have the cole API for this release, and some internal structures and internal calls.
Note: what Microsoft calls stream is called file in this project, storage is called directory and docfile (a Structured Storage file) is called filesystem.
The files in the subdirectory examples in the source code show the complete public API in action. Briefly, if you know how to use the stdio.h ANSI C calls, cole API will be very easy for you.
If you use autoconf in your own proyect, the included file cole.m4 may be useful for you. It contains the m4 macro AM_PATH_COLE that detect the presense or ausence of the cole library in the system being configured. To use it:
If cole is not installed in your system (i.e. aclocal can't find cole.m4), add the content of cole.m4 to your own acinclude.m4 file (create it in case you haven't one).
Add a line like AM_PATH_COLE(2.0.0, [LIBS="$LIBS $COLE_LIBS" CFLAGS="$CFLAGS $COLE_CFLAGS"]) to your configure.in file. Here we are requesting for cole release 2.0.0, and adding the necessary flags to LIBS and CFLAGS.
Run aclocal to generate the file aclocal.m4. This file will have many m4 macros, incluiding the cole m4 macro, and
Run autoconf to generate the script configure.
Many API calls take an argument at the end called colerrno. If it's not NULL and the call failed, it store the error code for fail, if any (if the call was successfully ended, its value is not modified).
Requirements to compile
To have a system with ANSI C libraries, a ANSI C compiler, a make program and the shell /bin/sh.
Trademarks
"Microsoft Word", "Microsoft Excel", "Microsoft Publisher" and "Microsoft Power Point" are trademarks of Microsoft Corporation.
"StarOffice" may be is a trademark of StarDivision.
"FlashPix" may be is a trademark.
"UNIX" is a trademark.
"Free Software" is not trademark of anyone, but it's an important term in the Free Software community, and for the Free Software Foundation.
All other trademarks are the property of their respective owners.
If another trademark is mentioned in this document and it needs to be listed above, please email to the maintainer (<arturo@directmail.org>).
\n"); } else if (ccount == 1) { cinstance |= (buf[0]<<8); cversion = cinstance &0x000F; cinstance = (cinstance>>4); } else if (ccount == 2) ctype = (unsigned)buf[0]; else if (ccount == 3) ctype |= (buf[0]<<8)&0x00000FFFL; else if (ccount == 4) clength = (unsigned)buf[0]; else if (ccount == 5) clength |= (buf[0]<<8); else if (ccount == 6) clength |= (buf[0]<<16); else if (ccount == 7) { clength |= (buf[0]<<24); ctarget = clength; if (cversion == 0x0F) { printf("Container"); ccount = -1; } else printf("Atom"); printf(" - Version:%02X Instance:%02X, Type:%03X, Length:%08X - ", (int)cversion, (int)cinstance, (int)ctype, (int)clength); output_type_string(ctype); puts("
\n"); } if (ccount > 7) { /* Here is where we want to process the data */ /* based on the opcode... */ /* process_atom(buf[0]); */ if (isprint(buf[0])) putc(buf[0], stdout); } if (ccount == (ctarget+7)) ccount = 0; else ccount++; } else /* mode >= 1 */ { printf("%02x %02x %02x %02x %02x %02x %02x %02x ", (unsigned)buf[0], (unsigned)buf[1], (unsigned)buf[2], (unsigned)buf[3], (unsigned)buf[4], (unsigned)buf[5], (unsigned)buf[6], (unsigned)buf[7]); putchar(buf[0]); putchar(buf[1]); putchar(buf[2]); putchar(buf[3]); putchar(buf[4]); putchar(buf[5]); putchar(buf[6]); putchar(buf[7]); printf("
"); } } /* Output Tail */ printf("\n"); cole_fclose(cf, &err); } static void output_type_string(int type) { switch (type) { case 0x0001: puts("SubContainerCompleted"); break; case 0x0002: puts("IRRAtom"); break; case 0x0003: puts("PSS"); break; case 0x0004: puts("SubContainerException"); break; case 0x0006: puts("ClientSignal1"); break; case 0x0007: puts("ClientSignal2"); break; case 0x000A: puts("PowerPointStateAtom"); break; case 0x03E8: puts("Document"); break; case 0x03E9: puts("Document Atom"); break; case 0x03EA: puts("End Document"); break; case 0x03EB: puts("Slide Persist"); break; case 0x03EC: puts("SlideBase"); break; case 0x03ED: puts("SlideBase Atom"); break; case 0x03EE: puts("Slide"); break; case 0x03EF: puts("Slide Atom"); break; case 0x03F0: puts("Notes"); break; case 0x03F1: puts("Notes Atom"); break; case 0x03F2: puts("Environment"); break; case 0x03F3: puts("SlidePersistAtom"); break; case 0x03F4: puts("Scheme"); break; case 0x03F5: puts("Scheme Atom"); break; case 0x03F6: puts("DocViewInfo"); break; case 0x03F7: puts("SlideLayout Atom"); break; case 0x03F8: puts("MainMaster"); break; case 0x03F9: puts("SlideInfo Atom"); break; case 0x03FA: puts("SlideViewInfo"); break; case 0x03FB: puts("Guide Atom"); break; case 0x03FC: puts("ViewInfo"); break; case 0x03FD: puts("ViewInfo Atom"); break; case 0x03FE: puts("SlideViewInfo Atom"); break; case 0x03FF: puts("VBAInfo"); break; case 0x0400: puts("VBAInfo Atom"); break; case 0x0401: puts("SSDocInfo Atom"); break; case 0x0402: puts("Summary"); break; case 0x0403: puts("Texture"); break; case 0x0404: puts("VBASlideInfo"); break; case 0x0405: puts("VBASlideInfo Atom"); break; case 0x0406: puts("DocRoutingSlip"); break; case 0x0407: puts("OutlineViewInfo"); break; case 0x0408: puts("SorterViewInfo"); break; case 0x0409: puts("ExObjList"); break; case 0x040A: puts("ExObjList Atom"); break; case 0x040B: puts("PPDrawingGroup"); break; case 0x040C: puts("PPDrawing"); break; case 0x0410: puts("NamedShows - Several"); break; case 0x0411: puts("NamedShow - One"); break; case 0x0412: puts("NamedShowSlides"); break; case 0x07D0: puts("List"); break; case 0x07D5: puts("Font Collection"); break; case 0x07E1: puts("ListPlaceHolder"); break; case 0x07E3: puts("BookMarkCollection"); break; case 0x07E4: puts("SoundCollection"); break; case 0x07E5: puts("SoundColl Atom"); break; case 0x07E6: puts("Sound"); break; case 0x07E7: puts("SoundData"); break; case 0x07E9: puts("BookMarkSeed Atom"); break; case 0x07EA: puts("GuideList"); break; case 0x07EB: puts("RunArray"); break; case 0x07EC: puts("RunArray Atom"); break; case 0x07ED: puts("ArrayElement Atom"); break; case 0x07EE: puts("Int4Array Atom"); break; case 0x07EF: puts("ColorScheme Atom"); break; case 0x07F0: puts("ColorSchemeAtom"); break; case 0x0BC0: puts("OEShape"); break; case 0x0BC1: puts("ExObjRef Atom"); break; case 0x0BC3: puts("OEPlaceholder Atom"); break; case 0x0BCC: puts("GrColor"); break; case 0x0BD1: puts("Grect Atom"); break; case 0x0BD7: puts("GRatio Atom"); break; case 0x0BD8: puts("GScaling"); break; case 0x0BDA: puts("GPoint Atom"); break; case 0x0BDB: puts("OEShape Atom"); break; case 0x0F9E: puts("OutlineTextRef Atom"); break; case 0x0F9F: puts("TextHeader Atom"); break; case 0x0FA0: puts("TextChars Atom"); break; case 0x0FA1: puts("StyleTextProp Atom"); break; case 0x0FA2: puts("BaseTextProp Atom"); break; case 0x0FA3: puts("TxMasterStyle Atom"); break; case 0x0FA4: puts("TxCFStyle Atom"); break; case 0x0FA5: puts("TxPFStyle Atom"); break; case 0x0FA6: puts("TextRuler Atom"); break; case 0x0FA7: puts("TextBookMark Atom"); break; case 0x0FA8: puts("TextBytes Atom"); break; case 0x0FA9: puts("TxSiStyle Atom"); break; case 0x0FAA: puts("TextSpecInfo"); break; case 0x0FAB: puts("DefaultRuler Atom"); break; case 0x0FB7: puts("FontEntity Atom"); break; case 0x0FB8: puts("FontEmbedData"); break; case 0x0FB9: puts("TypeFace"); break; case 0x0FBA: puts("CString"); break; case 0x0FBB: puts("ExternalObject"); break; case 0x0FC1: puts("MetaFile"); break; case 0x0FC2: puts("ExOleObj"); break; case 0x0FC3: puts("ExOleObj Atom"); break; case 0x0FE9: puts("ExQuickTime"); break; case 0x0FD9: puts("HeadersFooters"); break; case 0x0FDA: puts("HeadersFooters Atom"); break; case 0x0FF0: puts("SlideListWithText"); break; case 0x0FF1: puts("AnimationInfoAtom"); break; case 0x0FF2: puts("InteractiveInfo"); break; case 0x0FF5: puts("UserEditAtom"); break; case 0x0FF6: puts("CurrentUserAtom"); break; case 0x0FF7: puts("DateTimeMCAtom "); break; default: puts("Unknown Type"); break; } } xlhtml/ppthtml/ppthtml.1 0100644 0000764 0000764 00000002753 07446125634 016007 0 ustar jackshck jackshck .TH ppthtml 1 "October 13, 2001" "ppthtml" .SH NAME ppthtml \- A program for converting Microsoft Power Point Files .ppt .SH SYNOPSIS .B ppthtml .RI Filename .br .SH DESCRIPTION This manual page explains the .B ppthtml program. The program .B ppthtml is used to convert Microsoft Power Point files into either html or tab delimitted ASCII. The program can be interfaced with helper scripts for viewing email attachments. Most use of this program is through the helper scripts and one would probably rarely resort to using the commandline interface. .SH NOTES To interface to Netscape Navigator: first locate the help scripts nspptview & nsopen. Go into the Edit Preferences dialog box. Click on the Navigator Category and hilight the Applications menu item. Look for Microsoft Excel Worksheet. If you don't see it create one. The MIME type should be: application/vnd.ms-powerpoint The suffixes should be: ppt,ppa,pps,pot,pwz In the handled by section of the dialog box, check the Application checkbox and set the path to wherever the nspptview helper script is located and pass a %s argument. For example, if nspptview is located in /usr/local/bin, then you would put: /usr/local/bin/nspptview %s in the Application path box.. (As a side note, make sure the nspptview script can find the ppthtml program or it won't work.) Click on the OK and you are done. You should be able to use the Test.ppt file that is distributed with the program to verify its configured correctly. .SH AUTHOR Charles N Wyble xlhtml/ppthtml/ppthtml.c 0100644 0000764 0000764 00000023056 07470757344 016076 0 ustar jackshck jackshck /* pptHtml - Format a PowerPoint Presentation into Html Copyright 2002 Charles N Wyble
"); printf("
\n"); /* Output Credit */ printf("
Created with pptHtml
\n" ); /* Output Tail */ printf("\n"); cole_fclose(cf, &err); } static void container_processor(int type) { if (type == 0x03EE) { if (past_first_slide) printf("
\n"); else past_first_slide = 1; } switch (type) { case 0x000D: if (last_container == 0x11) /* suppress notes info */ output_this_container = 0; else output_this_container = 1; break; case 0x0FF0: output_this_container = 1; break; default: /* printf("Cont:%x|\n", type); */ output_this_container = 0; break; } last_container = type; } static void atom_processor(int type, int count, int buf_last, unsigned char data) { if ((buf_idx >= WORK_SIZE)||(output_this_container == 0)) return; if (count == 0) { memset(working_buffer, 0, WORK_SIZE); buf_idx = 0; } switch (type) { case 0x0FA0: /* Text String in unicode */ working_buffer[buf_idx++] = data; if (count == buf_last) { /* printf("Atom:%x|\n", type); */ /* working_buffer[buf_idx++] = 0; */ /* printf("%s
\n", working_buffer); */ print_unicode(working_buffer, buf_idx); printf("
\n"); } break; case 0x0FA8: /* Text String in ASCII */ working_buffer[buf_idx++] = data; if (count == buf_last) { int i; /* working_buffer[buf_idx++] = 0; */ /* printf("Atom:%x|\n", type); */ for (i=0;i
\n"); } break; case 0x0FBA: /* CString - unicode... */ working_buffer[buf_idx++] = data; if (count == buf_last) { /* working_buffer[buf_idx++] = 0; */ /* printf("%s
\n", working_buffer); */ /* printf("Atom:%x|\n", type); */ print_unicode(working_buffer, buf_idx); printf("
\n"); } break; default: break; } } static void print_unicode(unsigned char *ucs, int len) { int i; for (i = 0; i < len; i += 2) print_utf8(ucs[i] | (ucs[i+1] << 8)); } static void OutputCharCorrected(unsigned char c) { switch (c) { /* Special char handlers here... */ case '\r': printf("
\n"); break; case 0x3C: printf("<"); break; case 0x3E: printf(">"); break; case 0x26: printf("&"); break; case 0x22: printf("""); break; /* Also need to cover 128-159 since MS uses this area... */ case 0x80: /* Euro Symbol */ printf("€"); break; case 0x82: /* baseline single quote */ printf("‚"); break; case 0x83: /* florin */ printf("ƒ"); break; case 0x84: /* baseline double quote */ printf("„"); break; case 0x85: /* ellipsis */ printf("…"); break; case 0x86: /* dagger */ printf("†"); break; case 0x87: /* double dagger */ printf("‡"); break; case 0x88: /* circumflex accent */ printf("ˆ"); break; case 0x89: /* permile */ printf("‰"); break; case 0x8A: /* S Hacek */ printf("Š"); break; case 0x8B: /* left single guillemet */ printf("‹"); break; case 0x8C: /* OE ligature */ printf("Œ"); break; case 0x8E: /* #LATIN CAPITAL LETTER Z WITH CARON */ printf("Ž"); break; case 0x91: /* left single quote ? */ printf("‘"); break; case 0x92: /* right single quote ? */ printf("’"); break; case 0x93: /* left double quote */ printf("“"); break; case 0x94: /* right double quote */ printf("”"); break; case 0x95: /* bullet */ printf("•"); break; case 0x96: /* endash */ printf("–"); break; case 0x97: /* emdash */ printf("—"); break; case 0x98: /* tilde accent */ printf("˜"); break; case 0x99: /* trademark ligature */ printf("™"); break; case 0x9A: /* s Haceks Hacek */ printf("š"); break; case 0x9B: /* right single guillemet */ printf("›"); break; case 0x9C: /* oe ligature */ printf("œ"); break; case 0x9F: /* Y Dieresis */ printf("Ÿ"); break; default: putchar(c); break; } } static void print_utf8(unsigned short c) { if (c == 0) return; if (c < 0x80) OutputCharCorrected(c); else if (c < 0x800) { putchar(0xC0 | (c >> 6)); put_utf8(c); } else { putchar(0xE0 | (c >> 12)); put_utf8(c >> 6); put_utf8(c); } } static void put_utf8(unsigned short c) { putchar(0x0080 | ((short)c & 0x003F)); } xlhtml/xlhtml/ 0040755 0000764 0000764 00000000000 07500147312 014035 5 ustar jackshck jackshck xlhtml/xlhtml/CVS/ 0040755 0000764 0000764 00000000000 07473177127 014510 5 ustar jackshck jackshck xlhtml/xlhtml/CVS/Root 0100644 0000764 0000764 00000000063 07473177126 015351 0 ustar jackshck jackshck :ext:slidedraw@cvs.chicago.sf.net:/cvsroot/chicago xlhtml/xlhtml/CVS/Repository 0100644 0000764 0000764 00000000016 07473177126 016603 0 ustar jackshck jackshck xlhtml/xlhtml xlhtml/xlhtml/CVS/Entries 0100644 0000764 0000764 00000001772 07473177127 016050 0 ustar jackshck jackshck /ChangeLog/1.9/Thu May 16 15:20:20 2002// /Makefile.am/1.9/Wed May 15 01:58:35 2002// /Makefile.in/1.14/Wed May 15 01:58:35 2002// /README/1.2/Thu May 16 16:31:32 2002// /THANKS/1.1.1.1/Wed Mar 20 15:32:47 2002// /TODO/1.2/Wed May 15 01:58:35 2002// /Test.xls/1.1.1.1/Wed Mar 20 15:32:49 2002/-kb/ /ascii.c/1.6/Thu May 16 16:31:32 2002// /doxygen.conf/1.2/Wed May 15 01:58:35 2002// /gpdemo/1.1.1.1/Wed Mar 20 15:32:50 2002// /html.c/1.9/Thu May 16 16:31:32 2002// /nsopen/1.1.1.1/Wed Mar 20 15:32:50 2002// /nsxlview/1.1.1.1/Wed Mar 20 15:32:50 2002// /support.c/1.7/Thu May 16 16:31:32 2002// /support.h/1.2/Thu May 16 16:17:56 2002// /tuneable.h/1.3/Thu May 16 16:31:32 2002// /version.h/1.3/Thu Apr 11 04:01:05 2002// /xlcdump.c/1.2/Thu May 16 16:31:32 2002// /xldump.c/1.3/Thu May 16 16:31:32 2002// /xlhtml.1/1.2/Thu May 16 15:20:20 2002// /xlhtml.c/1.21/Thu May 16 16:31:32 2002// /xlhtml.h/1.11/Thu May 16 16:31:32 2002// /xls-handler/1.1.1.1/Wed Mar 20 15:32:59 2002// /xml.c/1.8/Thu May 16 16:31:32 2002// D xlhtml/xlhtml/CVS/Entries.Log 0100644 0000764 0000764 00000000020 07473177127 016551 0 ustar jackshck jackshck A D/contrib//// xlhtml/xlhtml/contrib/ 0040755 0000764 0000764 00000000000 07473177127 015515 5 ustar jackshck jackshck xlhtml/xlhtml/contrib/CVS/ 0040755 0000764 0000764 00000000000 07473177127 016150 5 ustar jackshck jackshck xlhtml/xlhtml/contrib/CVS/Root 0100644 0000764 0000764 00000000063 07473177127 017012 0 ustar jackshck jackshck :ext:slidedraw@cvs.chicago.sf.net:/cvsroot/chicago xlhtml/xlhtml/contrib/CVS/Repository 0100644 0000764 0000764 00000000026 07473177127 020245 0 ustar jackshck jackshck xlhtml/xlhtml/contrib xlhtml/xlhtml/contrib/CVS/Entries 0100644 0000764 0000764 00000001101 07473177127 017472 0 ustar jackshck jackshck /convertXLS.cgi/1.1.1.1/Wed Mar 20 15:33:02 2002// /convertXLS.html/1.1.1.1/Wed Mar 20 15:33:02 2002// /convertXLS.txt/1.1.1.1/Wed Mar 20 15:33:02 2002// /excel2text/1.1.1.1/Wed Mar 20 15:33:02 2002// /excel2text.txt/1.1.1.1/Wed Mar 20 15:33:02 2002// /nsopen/1.1.1.1/Wed Mar 20 15:33:02 2002// /nsxlview/1.1.1.1/Wed Mar 20 15:33:02 2002// /uploader.pl/1.1.1.1/Wed Mar 20 15:33:03 2002// /uploader.txt/1.1.1.1/Wed Mar 20 15:33:03 2002// /xlhtml.dtd/1.1.1.1/Wed Mar 20 15:33:03 2002// /xlhtml.dtd.txt/1.1.1.1/Wed Mar 20 15:33:03 2002// /xlv/1.1.1.1/Wed Mar 20 15:33:03 2002// D xlhtml/xlhtml/contrib/convertXLS.cgi 0100755 0000764 0000764 00000033606 07446125656 020260 0 ustar jackshck jackshck #!/usr/bin/perl # # File Upload Script, slightly modified by Caolan.McNamara@ul.ie to # serve as a msword to html gateway. # original notice follows # # modify lines 89 & 401 for your own configuration. # # # # # File Upload Script Version 6.00 # Created by Jeff Carnahan jeffc@terminalp.com # Created on: 4/8/95 Last Modified on: 01/23/98 23:06 # Scripts Archive: http://www.terminalp.com/scripts/ # # --------------------------------------------------------------------- # # Copyright (C) 1996 Jeffrey D. Carnahan # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or (at # your option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # A full copy of the GNU General Public License can be retrieved from # http://www.terminalp.com/scripts/license.shtml # # - Jeff Carnahan
|
Bad Directory
The directory you specified:
\$SAVE_DIRECTORY = "$SAVE_DIRECTORY"; is invalid. This problem is caused by one of the three following reasons:
|
|
|
Filename ProblemYou attempted to upload a file that isn't properly formatted. The system administrator has decided that you can't upload files that begin with the word 'index'. Please rename the file on your computer, and try uploading it again.
|
|
|
Filename ProblemYou attempted to upload a file that isn't properly formatted. The file in question is $FILENAME_IN_QUESTION Please rename the file on your computer, and attempt to upload it again. Files may not have forward or backward slashes in their names. Also, they may not be prefixed with one (or more) periods.
|
|
|
Limit ReachedYou have reached your upload limit. You attempted to upload $FILES_UPLOADED files, totalling $TOTAL_BYTES. This exceeds the maximum limit of $MAXIMUM_UPLOAD bytes, set by the system administrator. None of your files were successfully saved. Please try again.
|
__END_OF_HTML_CODE__ exit; } # --------------------------------------------------------------------- # EOF xlhtml/xlhtml/contrib/convertXLS.html 0100644 0000764 0000764 00000002373 07446125656 020454 0 ustar jackshck jackshck
An Excel Sheet converter Web Gateway
To use this tool, press the Browse button below, and select the MS Excel XLS document you want to convert. Then Press the Upload File button to send it here for conversion.
xlhtml/xlhtml/contrib/convertXLS.txt 0100644 0000764 0000764 00000001072 07446125656 020322 0 ustar jackshck jackshck convertXLS is a cgi-bin script that allows you to set up a file conversion server. There are no restrictions on file size. To set it up on Apache: 1) copy convertXLS.html to /home/httpd/html 2) copy convertXLS.cgi to /home/httpd/cgi-bin 3) Change to the cgi-bin directory in step 2 and open the convertXLS.cgi file with an editor. Find line 388 and change the path to where you installed xlhtml. To Test: 1) start Netscape and goto http://localhost/convertXLS.html 2) Browse to xlhtml directory and chose Test.xls if you don't have an Excel file. xlhtml/xlhtml/contrib/excel2text 0100755 0000764 0000764 00000000604 07446125656 017527 0 ustar jackshck jackshck #!/bin/sh # excel2text - convert MS Excel files to ASCII text # # Written by Gary Johnson, Agilent Technologies
Error $_[0] BLAM exit } flock LOG,LOCK_EX; seek(LOG,0,2); print LOG scalar(localtime)," $ENV{'REMOTE_ADDR'} $0 $$;$S\n"; print <<"FOO"; Content-Type: text/html FOO foreach $C (split(';',$ENV{'HTTP_COOKIE'})){ $C =~ m/^(\w+)=(.*)$/ and $Cookies{$1} = $2; }; &ReadParsearoni; =pod $in{'filename'} is the file name. while(my ($k,$v) = each %in){ print "$k --> $v
\n"; }; =cut # adjust path to your xlhtml executable in the next line print `/opt/bin/xlhtml -a $in{'filename'}`; unlink $in{'filename'}; # comment out to keep uploaded files exit; sub PrintForm(){ print <