diff options
author | Aaron Griffin <aaron@archlinux.org> | 2006-10-15 21:06:08 +0000 |
---|---|---|
committer | Aaron Griffin <aaron@archlinux.org> | 2006-10-15 21:06:08 +0000 |
commit | db769f667d93d9127b570570564589337c793fbe (patch) | |
tree | 94f90c61fcf2e988f2a718b06925e0df20a29332 | |
parent | e037328e219697f8453dc25df2b8f0d25bbc1acc (diff) |
Added alpm function docs along
pacman.c : Removed link to frugalware wiki
sync.c : do not display Uncompressed size if 0 (archlinux has no USIZE)
57 files changed, 1066 insertions, 40 deletions
diff --git a/doc/man3/alpm_conflict_getinfo.3 b/doc/man3/alpm_conflict_getinfo.3 new file mode 100644 index 00000000..8bfc6275 --- /dev/null +++ b/doc/man3/alpm_conflict_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_dep.3 diff --git a/doc/man3/alpm_databases.3 b/doc/man3/alpm_databases.3 new file mode 100644 index 00000000..84eda8c5 --- /dev/null +++ b/doc/man3/alpm_databases.3 @@ -0,0 +1,211 @@ +.TH "Database Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Database Functions \- Frunctions to query and manipulate the database of libalpm. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "pmdb_t * \fBalpm_db_register\fP (char *treename, alpm_cb_db_register callback)" +.br +.ti -1c +.RI "int \fBalpm_db_unregister\fP (pmdb_t *db)" +.br +.ti -1c +.RI "void * \fBalpm_db_getinfo\fP (PM_DB *db, unsigned char parm)" +.br +.ti -1c +.RI "int \fBalpm_db_setserver\fP (pmdb_t *db, char *url)" +.br +.ti -1c +.RI "int \fBalpm_db_update\fP (int level, PM_DB *db)" +.br +.ti -1c +.RI "pmpkg_t * \fBalpm_db_readpkg\fP (pmdb_t *db, char *name)" +.br +.ti -1c +.RI "PMList * \fBalpm_db_getpkgcache\fP (pmdb_t *db)" +.br +.ti -1c +.RI "PMList * \fBalpm_db_whatprovides\fP (pmdb_t *db, char *name)" +.br +.ti -1c +.RI "pmgrp_t * \fBalpm_db_readgrp\fP (pmdb_t *db, char *name)" +.br +.ti -1c +.RI "PMList * \fBalpm_db_getgrpcache\fP (pmdb_t *db)" +.br +.in -1c +.SH "Detailed Description" +.PP +Frunctions to query and manipulate the database of libalpm. +.PP +.SH "Function Documentation" +.PP +.SS "PMList* alpm_db_getgrpcache (pmdb_t * db)" +.PP +Get the group cache of a package database +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to get the group from +.RE +.PP +\fBReturns:\fP +.RS 4 +the list of groups on success, NULL on error +.RE +.PP + +.SS "void* alpm_db_getinfo (PM_DB * db, unsigned char parm)" +.PP +Get informations about a database. +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP database pointer +.br +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a void* on success (the value), NULL on error +.RE +.PP + +.SS "PMList* alpm_db_getpkgcache (pmdb_t * db)" +.PP +Get the package cache of a package database +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to get the package from +.RE +.PP +\fBReturns:\fP +.RS 4 +the list of packages on success, NULL on error +.RE +.PP + +.SS "pmgrp_t* alpm_db_readgrp (pmdb_t * db, char * name)" +.PP +Get a group entry from a package database +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to get the group from +.br +\fIname\fP of the group +.RE +.PP +\fBReturns:\fP +.RS 4 +the groups entry on success, NULL on error +.RE +.PP + +.SS "pmpkg_t* alpm_db_readpkg (pmdb_t * db, char * name)" +.PP +Get a package entry from a package database +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to get the package from +.br +\fIname\fP of the package +.RE +.PP +\fBReturns:\fP +.RS 4 +the package entry on success, NULL on error +.RE +.PP + +.SS "pmdb_t* alpm_db_register (char * treename, alpm_cb_db_register callback)" +.PP +Register a package database +.PP +\fBParameters:\fP +.RS 4 +\fItreename\fP the name of the repository +.br +\fIcallback\fP a function to be called upon new database creation +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_db_setserver (pmdb_t * db, char * url)" +.PP +Set the serverlist of a database. +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP database pointer +.br +\fIurl\fP url of the server +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_db_unregister (pmdb_t * db)" +.PP +Unregister a package database +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to unregister +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_db_update (int level, PM_DB * db)" +.PP +Update a package database +.PP +\fBParameters:\fP +.RS 4 +\fIlevel\fP control for checking lastupdate time +.br +\fIdb\fP pointer to the package database to update +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, > 0 on error (pm_errno is set accordingly), < 0 if up to date +.RE +.PP + +.SS "PMList* alpm_db_whatprovides (pmdb_t * db, char * name)" +.PP +Get the list of packages that a package provides +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to get the package from +.br +\fIname\fP name of the package +.RE +.PP +\fBReturns:\fP +.RS 4 +the list of packages on success, NULL on error +.RE +.PP + diff --git a/doc/man3/alpm_db_getgrpcache.3 b/doc/man3/alpm_db_getgrpcache.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_getgrpcache.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_getinfo.3 b/doc/man3/alpm_db_getinfo.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_getpkgcache.3 b/doc/man3/alpm_db_getpkgcache.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_getpkgcache.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_readgrp.3 b/doc/man3/alpm_db_readgrp.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_readgrp.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_readpkg.3 b/doc/man3/alpm_db_readpkg.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_readpkg.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_register.3 b/doc/man3/alpm_db_register.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_register.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_search.3 b/doc/man3/alpm_db_search.3 new file mode 100644 index 00000000..e26f34ce --- /dev/null +++ b/doc/man3/alpm_db_search.3 @@ -0,0 +1 @@ +.so man3/alpm_sync.3 diff --git a/doc/man3/alpm_db_setserver.3 b/doc/man3/alpm_db_setserver.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_setserver.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_unregister.3 b/doc/man3/alpm_db_unregister.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_unregister.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_update.3 b/doc/man3/alpm_db_update.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_update.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_db_whatprovides.3 b/doc/man3/alpm_db_whatprovides.3 new file mode 100644 index 00000000..01b2bdc9 --- /dev/null +++ b/doc/man3/alpm_db_whatprovides.3 @@ -0,0 +1 @@ +.so man3/alpm_databases.3 diff --git a/doc/man3/alpm_dep.3 b/doc/man3/alpm_dep.3 new file mode 100644 index 00000000..49eaf0a1 --- /dev/null +++ b/doc/man3/alpm_dep.3 @@ -0,0 +1,57 @@ +.TH "Dependency Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Dependency Functions \- Functions to get informations about a libalpm dependency. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "void * \fBalpm_dep_getinfo\fP (pmdepmissing_t *miss, unsigned char parm)" +.br +.ti -1c +.RI "void * \fBalpm_conflict_getinfo\fP (pmconflict_t *conflict, unsigned char parm)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to get informations about a libalpm dependency. +.PP +.SH "Function Documentation" +.PP +.SS "void* alpm_conflict_getinfo (pmconflict_t * conflict, unsigned char parm)" +.PP +Get informations about a file conflict. +.PP +\fBParameters:\fP +.RS 4 +\fIconflict\fP database conflict structure +.br +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a char* on success (the value), NULL on error +.RE +.PP + +.SS "void* alpm_dep_getinfo (pmdepmissing_t * miss, unsigned char parm)" +.PP +Get informations about a dependency. +.PP +\fBParameters:\fP +.RS 4 +\fImiss\fP dependency pointer +.br +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a char* on success (the value), NULL on error +.RE +.PP + diff --git a/doc/man3/alpm_dep_getinfo.3 b/doc/man3/alpm_dep_getinfo.3 new file mode 100644 index 00000000..8bfc6275 --- /dev/null +++ b/doc/man3/alpm_dep_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_dep.3 diff --git a/doc/man3/alpm_fetch_pkgurl.3 b/doc/man3/alpm_fetch_pkgurl.3 new file mode 100644 index 00000000..5c237ae4 --- /dev/null +++ b/doc/man3/alpm_fetch_pkgurl.3 @@ -0,0 +1 @@ +.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_get_md5sum.3 b/doc/man3/alpm_get_md5sum.3 new file mode 100644 index 00000000..5c237ae4 --- /dev/null +++ b/doc/man3/alpm_get_md5sum.3 @@ -0,0 +1 @@ +.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_get_option.3 b/doc/man3/alpm_get_option.3 new file mode 100644 index 00000000..695ff9fd --- /dev/null +++ b/doc/man3/alpm_get_option.3 @@ -0,0 +1 @@ +.so man3/alpm_options.3 diff --git a/doc/man3/alpm_get_sha1sum.3 b/doc/man3/alpm_get_sha1sum.3 new file mode 100644 index 00000000..5c237ae4 --- /dev/null +++ b/doc/man3/alpm_get_sha1sum.3 @@ -0,0 +1 @@ +.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_groups.3 b/doc/man3/alpm_groups.3 new file mode 100644 index 00000000..77fb4b71 --- /dev/null +++ b/doc/man3/alpm_groups.3 @@ -0,0 +1,37 @@ +.TH "Group Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Group Functions \- Functions to get informations about libalpm groups. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "void * \fBalpm_grp_getinfo\fP (pmgrp_t *grp, unsigned char parm)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to get informations about libalpm groups. +.PP +.SH "Function Documentation" +.PP +.SS "void* alpm_grp_getinfo (pmgrp_t * grp, unsigned char parm)" +.PP +Get informations about a group. +.PP +\fBParameters:\fP +.RS 4 +\fIgrp\fP group pointer +.br +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a char* on success (the value), NULL on error +.RE +.PP + diff --git a/doc/man3/alpm_grp_getinfo.3 b/doc/man3/alpm_grp_getinfo.3 new file mode 100644 index 00000000..a85dd83a --- /dev/null +++ b/doc/man3/alpm_grp_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_groups.3 diff --git a/doc/man3/alpm_initialize.3 b/doc/man3/alpm_initialize.3 new file mode 100644 index 00000000..bca122ef --- /dev/null +++ b/doc/man3/alpm_initialize.3 @@ -0,0 +1 @@ +.so man3/alpm_interface.3 diff --git a/doc/man3/alpm_interface.3 b/doc/man3/alpm_interface.3 new file mode 100644 index 00000000..a4b5443a --- /dev/null +++ b/doc/man3/alpm_interface.3 @@ -0,0 +1,48 @@ +.TH "Interface Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Interface Functions \- Function to initialize and release libalpm. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "int \fBalpm_initialize\fP (char *root)" +.br +.ti -1c +.RI "int \fBalpm_release\fP ()" +.br +.in -1c +.SH "Detailed Description" +.PP +Function to initialize and release libalpm. +.PP +.SH "Function Documentation" +.PP +.SS "int alpm_initialize (char * root)" +.PP +Initializes the library. This must be called before any other functions are called. +.PP +\fBParameters:\fP +.RS 4 +\fIroot\fP the full path of the root we'll be installing to (usually /) +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_release ()" +.PP +Release the library. This should be the last alpm call you make. +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + diff --git a/doc/man3/alpm_list.3 b/doc/man3/alpm_list.3 new file mode 100644 index 00000000..18c48014 --- /dev/null +++ b/doc/man3/alpm_list.3 @@ -0,0 +1,107 @@ +.TH "List Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +List Functions \- Functions to manipulate libalpm linked lists. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "PMList * \fBalpm_list_first\fP (PMList *list)" +.br +.ti -1c +.RI "PMList * \fBalpm_list_next\fP (PMList *entry)" +.br +.ti -1c +.RI "void * \fBalpm_list_getdata\fP (PMList *entry)" +.br +.ti -1c +.RI "int \fBalpm_list_free\fP (PMList *entry)" +.br +.ti -1c +.RI "int \fBalpm_list_count\fP (PMList *list)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to manipulate libalpm linked lists. +.PP +.SH "Function Documentation" +.PP +.SS "int alpm_list_count (PMList * list)" +.PP +Count the entries in a list. +.PP +\fBParameters:\fP +.RS 4 +\fIlist\fP the list to count +.RE +.PP +\fBReturns:\fP +.RS 4 +number of entries on success, NULL on error +.RE +.PP + +.SS "PMList* alpm_list_first (PMList * list)" +.PP +Get the first element of a list. +.PP +\fBParameters:\fP +.RS 4 +\fIlist\fP the list +.RE +.PP +\fBReturns:\fP +.RS 4 +the first element +.RE +.PP + +.SS "int alpm_list_free (PMList * entry)" +.PP +Free a list. +.PP +\fBParameters:\fP +.RS 4 +\fIentry\fP list to free +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error +.RE +.PP + +.SS "void* alpm_list_getdata (PMList * entry)" +.PP +Get the data of a list entry. +.PP +\fBParameters:\fP +.RS 4 +\fIentry\fP the list entry +.RE +.PP +\fBReturns:\fP +.RS 4 +the data on success, NULL on error +.RE +.PP + +.SS "PMList* alpm_list_next (PMList * entry)" +.PP +Get the next element of a list. +.PP +\fBParameters:\fP +.RS 4 +\fIentry\fP the list entry +.RE +.PP +\fBReturns:\fP +.RS 4 +the next element on success, NULL on error +.RE +.PP + diff --git a/doc/man3/alpm_list_count.3 b/doc/man3/alpm_list_count.3 new file mode 100644 index 00000000..af27c84d --- /dev/null +++ b/doc/man3/alpm_list_count.3 @@ -0,0 +1 @@ +.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_first.3 b/doc/man3/alpm_list_first.3 new file mode 100644 index 00000000..af27c84d --- /dev/null +++ b/doc/man3/alpm_list_first.3 @@ -0,0 +1 @@ +.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_free.3 b/doc/man3/alpm_list_free.3 new file mode 100644 index 00000000..af27c84d --- /dev/null +++ b/doc/man3/alpm_list_free.3 @@ -0,0 +1 @@ +.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_getdata.3 b/doc/man3/alpm_list_getdata.3 new file mode 100644 index 00000000..af27c84d --- /dev/null +++ b/doc/man3/alpm_list_getdata.3 @@ -0,0 +1 @@ +.so man3/alpm_list.3 diff --git a/doc/man3/alpm_list_next.3 b/doc/man3/alpm_list_next.3 new file mode 100644 index 00000000..af27c84d --- /dev/null +++ b/doc/man3/alpm_list_next.3 @@ -0,0 +1 @@ +.so man3/alpm_list.3 diff --git a/doc/man3/alpm_log.3 b/doc/man3/alpm_log.3 new file mode 100644 index 00000000..1e2d9ac3 --- /dev/null +++ b/doc/man3/alpm_log.3 @@ -0,0 +1,35 @@ +.TH "Logging Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Logging Functions \- Functions to log using libalpm. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "int \fBalpm_logaction\fP (char *fmt,...)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to log using libalpm. +.PP +.SH "Function Documentation" +.PP +.SS "int alpm_logaction (char * fmt, ...)" +.PP +A printf-like function for logging. +.PP +\fBParameters:\fP +.RS 4 +\fIfmt\fP output format +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + diff --git a/doc/man3/alpm_logaction.3 b/doc/man3/alpm_logaction.3 new file mode 100644 index 00000000..bd21eb21 --- /dev/null +++ b/doc/man3/alpm_logaction.3 @@ -0,0 +1 @@ +.so man3/alpm_log.3 diff --git a/doc/man3/alpm_misc.3 b/doc/man3/alpm_misc.3 new file mode 100644 index 00000000..d2e8a3b0 --- /dev/null +++ b/doc/man3/alpm_misc.3 @@ -0,0 +1,93 @@ +.TH "Miscellaneous Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Miscellaneous Functions \- Various libalpm functions. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "char * \fBalpm_get_md5sum\fP (char *name)" +.br +.ti -1c +.RI "char * \fBalpm_get_sha1sum\fP (char *name)" +.br +.ti -1c +.RI "char * \fBalpm_fetch_pkgurl\fP (char *url)" +.br +.ti -1c +.RI "int \fBalpm_parse_config\fP (char *file, alpm_cb_db_register callback, const char *this_section)" +.br +.in -1c +.SH "Detailed Description" +.PP +Various libalpm functions. +.PP +.SH "Function Documentation" +.PP +.SS "char* alpm_fetch_pkgurl (char * url)" +.PP +Fetch a remote pkg. +.PP +\fBParameters:\fP +.RS 4 +\fIurl\fP +.RE +.PP +\fBReturns:\fP +.RS 4 +the downloaded filename on success, NULL on error +.RE +.PP + +.SS "char* alpm_get_md5sum (char * name)" +.PP +Get the md5 sum of file. +.PP +\fBParameters:\fP +.RS 4 +\fIname\fP name of the file +.RE +.PP +\fBReturns:\fP +.RS 4 +the checksum on success, NULL on error +.RE +.PP + +.SS "char* alpm_get_sha1sum (char * name)" +.PP +Get the sha1 sum of file. +.PP +\fBParameters:\fP +.RS 4 +\fIname\fP name of the file +.RE +.PP +\fBReturns:\fP +.RS 4 +the checksum on success, NULL on error +.RE +.PP + +.SS "int alpm_parse_config (char * file, alpm_cb_db_register callback, const char * this_section)" +.PP +Parses a configuration file. +.PP +\fBParameters:\fP +.RS 4 +\fIfile\fP path to the config file. +.br +\fIcallback\fP a function to be called upon new database creation +.br +\fIthis_section\fP the config current section being parsed +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + diff --git a/doc/man3/alpm_options.3 b/doc/man3/alpm_options.3 new file mode 100644 index 00000000..c43a3039 --- /dev/null +++ b/doc/man3/alpm_options.3 @@ -0,0 +1,57 @@ +.TH "Library Options" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Library Options \- Functions to set and get libalpm options. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "int \fBalpm_set_option\fP (unsigned char parm, unsigned long data)" +.br +.ti -1c +.RI "int \fBalpm_get_option\fP (unsigned char parm, long *data)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to set and get libalpm options. +.PP +.SH "Function Documentation" +.PP +.SS "int alpm_get_option (unsigned char parm, long * data)" +.PP +Get the value of a library option. +.PP +\fBParameters:\fP +.RS 4 +\fIparm\fP the parameter to get +.br +\fIdata\fP pointer argument to get the value in +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_set_option (unsigned char parm, unsigned long data)" +.PP +Set a library option. +.PP +\fBParameters:\fP +.RS 4 +\fIparm\fP the name of the parameter +.br +\fIdata\fP the value of the parameter +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + diff --git a/doc/man3/alpm_packages.3 b/doc/man3/alpm_packages.3 new file mode 100644 index 00000000..5b193c0f --- /dev/null +++ b/doc/man3/alpm_packages.3 @@ -0,0 +1,131 @@ +.TH "Package Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Package Functions \- Functions to manipulate libalpm packages. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "void * \fBalpm_pkg_getinfo\fP (pmpkg_t *pkg, unsigned char parm)" +.br +.ti -1c +.RI "int \fBalpm_pkg_load\fP (char *filename, pmpkg_t **pkg)" +.br +.ti -1c +.RI "int \fBalpm_pkg_free\fP (pmpkg_t *pkg)" +.br +.ti -1c +.RI "int \fBalpm_pkg_checksha1sum\fP (pmpkg_t *pkg)" +.br +.ti -1c +.RI "int \fBalpm_pkg_checkmd5sum\fP (pmpkg_t *pkg)" +.br +.ti -1c +.RI "int \fBalpm_pkg_vercmp\fP (const char *ver1, const char *ver2)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to manipulate libalpm packages. +.PP +.SH "Function Documentation" +.PP +.SS "int alpm_pkg_checkmd5sum (pmpkg_t * pkg)" +.PP +Check the integrity (with md5) of a package from the sync cache. +.PP +\fBParameters:\fP +.RS 4 +\fIpkg\fP package pointer +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_pkg_checksha1sum (pmpkg_t * pkg)" +.PP +Check the integrity (with sha1) of a package from the sync cache. +.PP +\fBParameters:\fP +.RS 4 +\fIpkg\fP package pointer +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_pkg_free (pmpkg_t * pkg)" +.PP +Free a package. +.PP +\fBParameters:\fP +.RS 4 +\fIpkg\fP package pointer to free +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "void* alpm_pkg_getinfo (pmpkg_t * pkg, unsigned char parm)" +.PP +Get informations about a package. +.PP +\fBParameters:\fP +.RS 4 +\fIpkg\fP package pointer +.br +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a char* on success (the value), NULL on error +.RE +.PP + +.SS "int alpm_pkg_load (char * filename, pmpkg_t ** pkg)" +.PP +Create a package from a file. +.PP +\fBParameters:\fP +.RS 4 +\fIfilename\fP location of the package tarball +.br +\fIpkg\fP address of the package pointer +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_pkg_vercmp (const char * ver1, const char * ver2)" +.PP +Compare versions. +.PP +\fBParameters:\fP +.RS 4 +\fIver1\fP first version +.br +\fIver2\fP secont version +.RE +.PP +\fBReturns:\fP +.RS 4 +postive, 0 or negative if ver1 is less, equal or more than ver2, respectively. +.RE +.PP + diff --git a/doc/man3/alpm_parse_config.3 b/doc/man3/alpm_parse_config.3 new file mode 100644 index 00000000..5c237ae4 --- /dev/null +++ b/doc/man3/alpm_parse_config.3 @@ -0,0 +1 @@ +.so man3/alpm_misc.3 diff --git a/doc/man3/alpm_pkg_checkmd5sum.3 b/doc/man3/alpm_pkg_checkmd5sum.3 new file mode 100644 index 00000000..133c7d41 --- /dev/null +++ b/doc/man3/alpm_pkg_checkmd5sum.3 @@ -0,0 +1 @@ +.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_checksha1sum.3 b/doc/man3/alpm_pkg_checksha1sum.3 new file mode 100644 index 00000000..133c7d41 --- /dev/null +++ b/doc/man3/alpm_pkg_checksha1sum.3 @@ -0,0 +1 @@ +.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_free.3 b/doc/man3/alpm_pkg_free.3 new file mode 100644 index 00000000..133c7d41 --- /dev/null +++ b/doc/man3/alpm_pkg_free.3 @@ -0,0 +1 @@ +.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_getinfo.3 b/doc/man3/alpm_pkg_getinfo.3 new file mode 100644 index 00000000..133c7d41 --- /dev/null +++ b/doc/man3/alpm_pkg_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_load.3 b/doc/man3/alpm_pkg_load.3 new file mode 100644 index 00000000..133c7d41 --- /dev/null +++ b/doc/man3/alpm_pkg_load.3 @@ -0,0 +1 @@ +.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_pkg_vercmp.3 b/doc/man3/alpm_pkg_vercmp.3 new file mode 100644 index 00000000..133c7d41 --- /dev/null +++ b/doc/man3/alpm_pkg_vercmp.3 @@ -0,0 +1 @@ +.so man3/alpm_packages.3 diff --git a/doc/man3/alpm_release.3 b/doc/man3/alpm_release.3 new file mode 100644 index 00000000..bca122ef --- /dev/null +++ b/doc/man3/alpm_release.3 @@ -0,0 +1 @@ +.so man3/alpm_interface.3 diff --git a/doc/man3/alpm_set_option.3 b/doc/man3/alpm_set_option.3 new file mode 100644 index 00000000..695ff9fd --- /dev/null +++ b/doc/man3/alpm_set_option.3 @@ -0,0 +1 @@ +.so man3/alpm_options.3 diff --git a/doc/man3/alpm_sync.3 b/doc/man3/alpm_sync.3 new file mode 100644 index 00000000..c406ff92 --- /dev/null +++ b/doc/man3/alpm_sync.3 @@ -0,0 +1,55 @@ +.TH "Sync Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Sync Functions \- Functions to get informations about libalpm syncs. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "void * \fBalpm_sync_getinfo\fP (pmsyncpkg_t *sync, unsigned char parm)" +.br +.ti -1c +.RI "PMList * \fBalpm_db_search\fP (pmdb_t *db)" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to get informations about libalpm syncs. +.PP +.SH "Function Documentation" +.PP +.SS "PMList* alpm_db_search (pmdb_t * db)" +.PP +Searches a database +.PP +\fBParameters:\fP +.RS 4 +\fIdb\fP pointer to the package database to search in +.RE +.PP +\fBReturns:\fP +.RS 4 +the list of packages on success, NULL on error +.RE +.PP + +.SS "void* alpm_sync_getinfo (pmsyncpkg_t * sync, unsigned char parm)" +.PP +Get informations about a sync. +.PP +\fBParameters:\fP +.RS 4 +\fIsync\fP pointer +.br +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a char* on success (the value), NULL on error +.RE +.PP + diff --git a/doc/man3/alpm_sync_getinfo.3 b/doc/man3/alpm_sync_getinfo.3 new file mode 100644 index 00000000..e26f34ce --- /dev/null +++ b/doc/man3/alpm_sync_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_sync.3 diff --git a/doc/man3/alpm_trans.3 b/doc/man3/alpm_trans.3 new file mode 100644 index 00000000..d574cdb1 --- /dev/null +++ b/doc/man3/alpm_trans.3 @@ -0,0 +1,141 @@ +.TH "Transaction Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*- +.ad l +.nh +.SH NAME +Transaction Functions \- Functions to manipulate libalpm transactions. + +.PP +.SS "Functions" + +.in +1c +.ti -1c +.RI "void * \fBalpm_trans_getinfo\fP (unsigned char parm)" +.br +.ti -1c +.RI "int \fBalpm_trans_init\fP (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)" +.br +.ti -1c +.RI "int \fBalpm_trans_sysupgrade\fP ()" +.br +.ti -1c +.RI "int \fBalpm_trans_addtarget\fP (char *target)" +.br +.ti -1c +.RI "int \fBalpm_trans_prepare\fP (PMList **data)" +.br +.ti -1c +.RI "int \fBalpm_trans_commit\fP (PMList **data)" +.br +.ti -1c +.RI "int \fBalpm_trans_release\fP ()" +.br +.in -1c +.SH "Detailed Description" +.PP +Functions to manipulate libalpm transactions. +.PP +.SH "Function Documentation" +.PP +.SS "int alpm_trans_addtarget (char * target)" +.PP +Add a target to the transaction. +.PP +\fBParameters:\fP +.RS 4 +\fItarget\fP the name of the target to add +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_trans_commit (PMList ** data)" +.PP +Commit a transaction. +.PP +\fBParameters:\fP +.RS 4 +\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files) +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "void* alpm_trans_getinfo (unsigned char parm)" +.PP +Get informations about the transaction. +.PP +\fBParameters:\fP +.RS 4 +\fIparm\fP name of the info to get +.RE +.PP +\fBReturns:\fP +.RS 4 +a char* on success (the value), NULL on error +.RE +.PP + +.SS "int alpm_trans_init (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)" +.PP +Initialize the transaction. +.PP +\fBParameters:\fP +.RS 4 +\fItype\fP type of the transaction +.br +\fIflags\fP flags of the transaction (like nodeps, etc) +.br +\fIevent\fP event callback function pointer +.br +\fIconv\fP question callback function pointer +.br +\fIprogress\fP progress callback function pointer +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_trans_prepare (PMList ** data)" +.PP +Prepare a transaction. +.PP +\fBParameters:\fP +.RS 4 +\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files) +.RE +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_trans_release ()" +.PP +Release a transaction. +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + +.SS "int alpm_trans_sysupgrade ()" +.PP +Search for packages to upgrade and add them to the transaction. +.PP +\fBReturns:\fP +.RS 4 +0 on success, -1 on error (pm_errno is set accordingly) +.RE +.PP + diff --git a/doc/man3/alpm_trans_addtarget.3 b/doc/man3/alpm_trans_addtarget.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_addtarget.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_commit.3 b/doc/man3/alpm_trans_commit.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_commit.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_getinfo.3 b/doc/man3/alpm_trans_getinfo.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_getinfo.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_init.3 b/doc/man3/alpm_trans_init.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_init.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_prepare.3 b/doc/man3/alpm_trans_prepare.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_prepare.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_release.3 b/doc/man3/alpm_trans_release.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_release.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/doc/man3/alpm_trans_sysupgrade.3 b/doc/man3/alpm_trans_sysupgrade.3 new file mode 100644 index 00000000..219cf744 --- /dev/null +++ b/doc/man3/alpm_trans_sysupgrade.3 @@ -0,0 +1 @@ +.so man3/alpm_trans.3 diff --git a/etc/makepkg.conf b/etc/makepkg.conf index 792d1dac..e97c1f50 100644 --- a/etc/makepkg.conf +++ b/etc/makepkg.conf @@ -2,58 +2,63 @@ # /etc/makepkg.conf # -######################################################################### -# SOURCE ACQUISITION -######################################################################### -# -#-- The FTP/HTTP download utility that makepkg should use to acquire sources -export FTPAGENT="/usr/bin/wget --continue --passive-ftp --tries=3 --waitretry=3 --no-check-certificate" +# The FTP/HTTP download utility that makepkg should use to acquire sources +export FTPAGENT="/usr/bin/wget -U makepkg --continue --passive-ftp --tries=3 --waitretry=3 --no-check-certificate" #export FTPAGENT="/usr/bin/snarf" #export FTPAGENT="/usr/bin/lftpget -c" -######################################################################### -# ARCHITECTURE, COMPILE FLAGS -######################################################################### -# export CARCH="i686" export CHOST="i686-pc-linux-gnu" -#-- Exclusive: will only run on i686 or higher (P6, Athlon) + +# Pentium Pro/Pentium II/Pentium III+/Pentium 4/Athlon exclusive (binaries +# will use the P6 instruction set and only run on P6+ systems) export CFLAGS="-march=i686 -O2 -pipe" export CXXFLAGS="-march=i686 -O2 -pipe" -#-- Optimized: will run on any x86, but optimized for i686 +# Pentium Pro/Pentium II/Pentium III+/Pentium 4/Athlon optimized (but binaries +# will run on any x86 system) #export CFLAGS="-mcpu=i686 -O2 -pipe" #export CXXFLAGS="-mcpu=i686 -O2 -pipe" -#-- Make Flags: change this for DistCC/SMP systems + +# SMP Systems #export MAKEFLAGS="-j2" -######################################################################### -# BUILD ENVIRONMENT -######################################################################### -# -#-- Fakeroot: for building packages as a non-root user +# Enable fakeroot for building packages as a non-root user export USE_FAKEROOT="y" -#-- DistCC: a distributed C/C++/ObjC compiler (modify MAKEFLAGS too) + +# Specify a directory for the chroot environment. +export CHROOTDIR="/var/chroot" +# Core package list to be installed in the chroot. +export COREPKGS="core chroot-core devel-core" + +# Enable distributed C/C++/ObjC compiler +# Don't forget to modify MAKEFLAGS to include -jN, where N is twice the +# number of CPUs +1 available export DISTCC="n" -#-- A space-delimited list of hosts running in the DistCC cluster +# Space-separated list of volunteer host specifications. export DISTCC_HOSTS="" -#-- Colorized output messages + +# Enable colorized output messages export USE_COLOR="y" -######################################################################### -# GLOBAL PACKAGE OPTIONS -######################################################################### -# -#-- Don't strip symbols from binaries/libraries +# Specify a fixed directory where all packages will be placed +#export PKGDEST=/home/packages + +# If you want your name to show up in the packages you build, change this. +export PACKAGER="Archlinux (http://archlinux.org)" + +# Don't strip symbols from binaries/libraries #export NOSTRIP="1" -#-- Keep doc and info directories -#export KEEPDOCS="1" +# Don't prepare documentation +#export NODOCS="1" -######################################################################### -# PACKAGE OUTPUT -######################################################################### -# -#-- Destination: specify a fixed directory where all packages will be placed -#export PKGDEST=/home/packages -#-- Packager: name/email of the person or organization building packages -#export PACKAGER="John Doe <john@doe.com>" +# LOGDIR is the location where you would like to store a +# permanant copy of the build log. +# filename = [LOGDIR_APPEND]-[pkgname]-[pkgver]-[pkgrel] +LOGDIR_APPEND=`date +%Y-%m-%d-%s` +LOGDIR=/var/log/builds +# The Standard Build Unit of this machine +# If 1, then the build time will be displayed in seconds +# Build the "binutils" package, and then write here the result you got, +# so that makepkg will could the right SBU value for you. +SBU="1" diff --git a/etc/pacman.conf b/etc/pacman.conf index 345eb8c1..72b1eec0 100644 --- a/etc/pacman.conf +++ b/etc/pacman.conf @@ -44,8 +44,14 @@ Include = /etc/pacman.d/current # Add your preferred servers here, they will be used first Include = /etc/pacman.d/extra +#[unstable] +# Add your preferred servers here, they will be used first #Include = /etc/pacman.d/unstable +[community] +# Add your preferred servers here, they will be used first +Include = /etc/pacman.d/community + # An example of a custom package repository. See the pacman manpage for # tips on creating your own repositories. #[custom] diff --git a/src/pacman/pacman.c b/src/pacman/pacman.c index 69504d43..16e1b432 100644 --- a/src/pacman/pacman.c +++ b/src/pacman/pacman.c @@ -186,8 +186,7 @@ static void cleanup(int signum) if(signum==SIGSEGV) { fprintf(stderr, "Internal pacman error: Segmentation fault\n" - "Please submit a full bug report, with the given package if appropriate.\n" - "See <URL:http://wiki.frugalware.org/Bugs> for instructions.\n"); + "Please submit a full bug report, with the given package if appropriate.\n"); exit(signum); } else if((signum == SIGINT) && (alpm_trans_release() == -1) && (pm_errno == PM_ERR_TRANS_COMMITING)) { diff --git a/src/pacman/sync.c b/src/pacman/sync.c index e77c9eab..e3262c28 100644 --- a/src/pacman/sync.c +++ b/src/pacman/sync.c @@ -615,14 +615,16 @@ int pacman_sync(list_t *targets) if(mb < 0.1) { mb = 0.1; } - if(umb < 0.1) { + if(umb > 0 && umb < 0.1) { umb = 0.1; } MSG(NL, _("\nTargets: ")); str = buildstring(list_install); indentprint(str, 9); MSG(NL, _("\nTotal Package Size: %.1f MB\n"), mb); - MSG(NL, _("\nTotal Uncompressed Package Size: %.1f MB\n"), umb); + if(umb > 0) { + MSG(NL, _("\nTotal Uncompressed Package Size: %.1f MB\n"), umb); + } FREELIST(list_install); FREE(str); |