From db769f667d93d9127b570570564589337c793fbe Mon Sep 17 00:00:00 2001 From: Aaron Griffin <aaron@archlinux.org> Date: Sun, 15 Oct 2006 21:06:08 +0000 Subject: 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) --- doc/man3/alpm_conflict_getinfo.3 | 1 + doc/man3/alpm_databases.3 | 211 +++++++++++++++++++++++++++++++++++++++ doc/man3/alpm_db_getgrpcache.3 | 1 + doc/man3/alpm_db_getinfo.3 | 1 + doc/man3/alpm_db_getpkgcache.3 | 1 + doc/man3/alpm_db_readgrp.3 | 1 + doc/man3/alpm_db_readpkg.3 | 1 + doc/man3/alpm_db_register.3 | 1 + doc/man3/alpm_db_search.3 | 1 + doc/man3/alpm_db_setserver.3 | 1 + doc/man3/alpm_db_unregister.3 | 1 + doc/man3/alpm_db_update.3 | 1 + doc/man3/alpm_db_whatprovides.3 | 1 + doc/man3/alpm_dep.3 | 57 +++++++++++ doc/man3/alpm_dep_getinfo.3 | 1 + doc/man3/alpm_fetch_pkgurl.3 | 1 + doc/man3/alpm_get_md5sum.3 | 1 + doc/man3/alpm_get_option.3 | 1 + doc/man3/alpm_get_sha1sum.3 | 1 + doc/man3/alpm_groups.3 | 37 +++++++ doc/man3/alpm_grp_getinfo.3 | 1 + doc/man3/alpm_initialize.3 | 1 + doc/man3/alpm_interface.3 | 48 +++++++++ doc/man3/alpm_list.3 | 107 ++++++++++++++++++++ doc/man3/alpm_list_count.3 | 1 + doc/man3/alpm_list_first.3 | 1 + doc/man3/alpm_list_free.3 | 1 + doc/man3/alpm_list_getdata.3 | 1 + doc/man3/alpm_list_next.3 | 1 + doc/man3/alpm_log.3 | 35 +++++++ doc/man3/alpm_logaction.3 | 1 + doc/man3/alpm_misc.3 | 93 +++++++++++++++++ doc/man3/alpm_options.3 | 57 +++++++++++ doc/man3/alpm_packages.3 | 131 ++++++++++++++++++++++++ doc/man3/alpm_parse_config.3 | 1 + doc/man3/alpm_pkg_checkmd5sum.3 | 1 + doc/man3/alpm_pkg_checksha1sum.3 | 1 + doc/man3/alpm_pkg_free.3 | 1 + doc/man3/alpm_pkg_getinfo.3 | 1 + doc/man3/alpm_pkg_load.3 | 1 + doc/man3/alpm_pkg_vercmp.3 | 1 + doc/man3/alpm_release.3 | 1 + doc/man3/alpm_set_option.3 | 1 + doc/man3/alpm_sync.3 | 55 ++++++++++ doc/man3/alpm_sync_getinfo.3 | 1 + doc/man3/alpm_trans.3 | 141 ++++++++++++++++++++++++++ doc/man3/alpm_trans_addtarget.3 | 1 + doc/man3/alpm_trans_commit.3 | 1 + doc/man3/alpm_trans_getinfo.3 | 1 + doc/man3/alpm_trans_init.3 | 1 + doc/man3/alpm_trans_prepare.3 | 1 + doc/man3/alpm_trans_release.3 | 1 + doc/man3/alpm_trans_sysupgrade.3 | 1 + 53 files changed, 1014 insertions(+) create mode 100644 doc/man3/alpm_conflict_getinfo.3 create mode 100644 doc/man3/alpm_databases.3 create mode 100644 doc/man3/alpm_db_getgrpcache.3 create mode 100644 doc/man3/alpm_db_getinfo.3 create mode 100644 doc/man3/alpm_db_getpkgcache.3 create mode 100644 doc/man3/alpm_db_readgrp.3 create mode 100644 doc/man3/alpm_db_readpkg.3 create mode 100644 doc/man3/alpm_db_register.3 create mode 100644 doc/man3/alpm_db_search.3 create mode 100644 doc/man3/alpm_db_setserver.3 create mode 100644 doc/man3/alpm_db_unregister.3 create mode 100644 doc/man3/alpm_db_update.3 create mode 100644 doc/man3/alpm_db_whatprovides.3 create mode 100644 doc/man3/alpm_dep.3 create mode 100644 doc/man3/alpm_dep_getinfo.3 create mode 100644 doc/man3/alpm_fetch_pkgurl.3 create mode 100644 doc/man3/alpm_get_md5sum.3 create mode 100644 doc/man3/alpm_get_option.3 create mode 100644 doc/man3/alpm_get_sha1sum.3 create mode 100644 doc/man3/alpm_groups.3 create mode 100644 doc/man3/alpm_grp_getinfo.3 create mode 100644 doc/man3/alpm_initialize.3 create mode 100644 doc/man3/alpm_interface.3 create mode 100644 doc/man3/alpm_list.3 create mode 100644 doc/man3/alpm_list_count.3 create mode 100644 doc/man3/alpm_list_first.3 create mode 100644 doc/man3/alpm_list_free.3 create mode 100644 doc/man3/alpm_list_getdata.3 create mode 100644 doc/man3/alpm_list_next.3 create mode 100644 doc/man3/alpm_log.3 create mode 100644 doc/man3/alpm_logaction.3 create mode 100644 doc/man3/alpm_misc.3 create mode 100644 doc/man3/alpm_options.3 create mode 100644 doc/man3/alpm_packages.3 create mode 100644 doc/man3/alpm_parse_config.3 create mode 100644 doc/man3/alpm_pkg_checkmd5sum.3 create mode 100644 doc/man3/alpm_pkg_checksha1sum.3 create mode 100644 doc/man3/alpm_pkg_free.3 create mode 100644 doc/man3/alpm_pkg_getinfo.3 create mode 100644 doc/man3/alpm_pkg_load.3 create mode 100644 doc/man3/alpm_pkg_vercmp.3 create mode 100644 doc/man3/alpm_release.3 create mode 100644 doc/man3/alpm_set_option.3 create mode 100644 doc/man3/alpm_sync.3 create mode 100644 doc/man3/alpm_sync_getinfo.3 create mode 100644 doc/man3/alpm_trans.3 create mode 100644 doc/man3/alpm_trans_addtarget.3 create mode 100644 doc/man3/alpm_trans_commit.3 create mode 100644 doc/man3/alpm_trans_getinfo.3 create mode 100644 doc/man3/alpm_trans_init.3 create mode 100644 doc/man3/alpm_trans_prepare.3 create mode 100644 doc/man3/alpm_trans_release.3 create mode 100644 doc/man3/alpm_trans_sysupgrade.3 (limited to 'doc/man3') 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 -- cgit v1.2.3-70-g09d2