Methods to handle package elements. More...

#include <rpmio.h>
#include <rpmpgp.h>
#include <rpmtag.h>

Include dependency graph for pkgio.h:

This graph shows which files directly or indirectly include this file:

Functions
rpmRC	headerCheck (pgpDig dig, const void uh, size_t uc, const char *msg)
	Check header consistency, performing headerGetEntry() the hard way.
rpmRC	rpmReadPackageFile (rpmts ts, FD_t fd, const char fn, Header hdrp)
	Return package header from file handle, verifying digests/signatures.
size_t	rpmpkgSizeof (const char fn, const void ptr)
	Return size of item in bytes.
rpmRC	rpmpkgWrite (const char fn, FD_t fd, void ptr, const char **msg)
	Write item onto file descriptor.
rpmRC	rpmpkgRead (const char fn, FD_t fd, void ptr, const char **msg)
	Read item from file descriptor.
rpmRC	rpmpkgCheck (const char fn, FD_t fd, const void ptr, const char **msg)
	Verify item integrity.

Detailed Description

Methods to handle package elements.

Definition in file pkgio.h.

Function Documentation

rpmRC headerCheck	(	pgpDig	dig,
		const void *	uh,
		size_t	uc,
		const char **	msg
	)

Check header consistency, performing headerGetEntry() the hard way.

Sanity checks on the header are performed while looking for a header-only digest or signature to verify the blob. If found, the digest or signature is verified.

Parameters:

dig	signature parameters container
uh	unloaded header blob
uc	no. of bytes in blob (or 0 to disable)

Return values:

*msg	verification error message (or NULL)

Returns:: RPMRC_OK on success

Check header consistency, performing headerGetEntry() the hard way.

Sanity checks on the header are performed while looking for a header-only digest or signature to verify the blob. If found, the digest or signature is verified.

Parameters:

dig	signature parameters container
uh	unloaded header blob
uc	no. of bytes in blob (or 0 to disable)

Return values:

*msg	signature verification msg

Returns:: RPMRC_OK/RPMRC_NOTFOUND/RPMRC_FAIL

Definition at line 1009 of file pkgio.c.

References _, _free(), _pkgio_debug, alloca(), entryInfo_s::count, headerGetMagic(), headerVerifyInfo(), indexEntry_s::info, entryInfo_s::offset, pgpDigVSFlags, pgpGetSig(), PGPHASHALGO_SHA1, pgpPktLen(), pgpSetSig(), pgpStatsAccumulator(), REGION_TAG_COUNT, RPM_BIN_TYPE, RPM_STRING_TYPE, RPMDIGEST_NONE, rpmDigestInit(), rpmDigestUpdate(), rpmlog(), RPMLOG_ERR, RPMRC_FAIL, RPMRC_NOTFOUND, RPMRC_OK, rpmswEnter(), rpmswExit(), RPMTAG_HEADERIMMUTABLE, rpmVerifySignature(), RPMVSF_NODSAHEADER, RPMVSF_NORSAHEADER, RPMVSF_NOSHA1HEADER, snprintf(), entryInfo_s::tag, entryInfo_s::type, vsflags, xmalloc(), and xstrdup().

Referenced by rpmReadHeader(), rpmts_HdrCheck(), and showVerifyPackage().

rpmRC rpmpkgCheck	(	const char *	fn,
		FD_t	fd,
		const void *	ptr,
		const char **	msg
	)

Verify item integrity.

Parameters:

fn	item name
fd	file handle
ptr	item buffer

Return values:

*msg	item check failure message

Returns:: RPMRC_OK on success

Definition at line 1607 of file pkgio.c.

References ckHeader(), and RPMRC_FAIL.

rpmRC rpmpkgRead	(	const char *	fn,
		FD_t	fd,
		void *	ptr,
		const char **	msg
	)

Read item from file descriptor.

Parameters:

fn	item name
fd	file handle

Return values:

*ptr	item buffer
*msg	item check failure message

Returns:: RPMRC_OK on success

Definition at line 1619 of file pkgio.c.

References rdHeader(), rdLead(), rdSignature(), and RPMRC_FAIL.

Referenced by makeHDRSignature(), readFile(), rpmgiNext(), rpmReadHeaders(), rpmReadPackageFile(), rpmReSign(), rpmSingleHeaderFromFD(), rpmVerifySignatures(), and writeRPM().

size_t rpmpkgSizeof	(	const char *	fn,
		const void *	ptr
	)

Return size of item in bytes.

Parameters:

fn	item name
ptr	item buffer

Returns:: size of item in bytes.

Definition at line 1591 of file pkgio.c.

References szHeader().

Referenced by printSize(), rpmpsmStage(), and writeRPM().

rpmRC rpmpkgWrite	(	const char *	fn,
		FD_t	fd,
		void *	ptr,
		const char **	msg
	)

Write item onto file descriptor.

Parameters:

fn	item name
fd	file handle
ptr	item buffer

Return values:

*msg	item check failure message

Returns:: RPMRC_OK on success

Definition at line 1637 of file pkgio.c.

References RPMRC_FAIL, wrHeader(), wrLead(), and wrSignature().

Referenced by makeHDRSignature(), rpmpsmStage(), rpmReSign(), rpmWriteHeaders(), and writeRPM().

rpmRC rpmReadPackageFile	(	rpmts	ts,
		FD_t	fd,
		const char *	fn,
		Header *	hdrp
	)

Return package header from file handle, verifying digests/signatures.

Todo:: The rpmts either needs to become void *, or changed to -lrpmdb scope.

Parameters:

ts	transaction set
fd	file handle
fn	file name

Return values:

hdrp	address of header (or NULL)

Returns:: RPMRC_OK on success

Todo:: Implement disable/enable/warn/error/anal policy.

Definition at line 80 of file package.c.

References _, _chk, _free(), alloca(), rpmDataType_u::argv, _HE_s::c, rpmop_s::count, fdInitDigest(), fdSetDig(), fdstat_op(), FDSTAT_READ, fdStealDigest(), Fread(), Fstrerror(), headerFree(), headerGet(), headerGetMagic(), headerIsEntry(), headerLink(), headerMergeLegacySigs(), _HE_s::p, pgpArmorUnwrap(), pgpDigVSFlags, PGPHASHALGO_MD5, PGPHASHALGO_SHA1, pgpPktLen(), pgpSetSig(), pgpStashKeyid(), pgpStatsAccumulator(), rpmDataType_u::ptr, RPM_STRING_ARRAY_TYPE, RPMDIGEST_NONE, rpmDigestInit(), rpmDigestUpdate(), rpmiobAppend(), rpmiobFree(), rpmiobNew(), rpmlog(), RPMLOG_DEBUG, RPMLOG_ERR, RPMLOG_WARNING, rpmpkgRead(), RPMRC_FAIL, RPMRC_NOKEY, RPMRC_NOTFOUND, RPMRC_NOTTRUSTED, RPMRC_OK, RPMSIGTAG_DSA, RPMSIGTAG_MD5, RPMSIGTAG_RSA, RPMSIGTAG_SHA1, rpmswAdd(), rpmswEnter(), rpmswExit(), rpmswSub(), RPMTAG_HEADERIMMUTABLE, RPMTS_OP_DIGEST, RPMTS_OP_READHDR, rpmtsCleanDig(), rpmtsDig(), rpmtsOp(), rpmVerifySignature(), RPMVSF_NEEDPAYLOAD, RPMVSF_NODSAHEADER, RPMVSF_NOMD5, RPMVSF_NORSAHEADER, RPMVSF_NOSHA1HEADER, _FD_s::stats, _HE_s::t, _HE_s::tag, and vsflags.

Referenced by IDTXglob(), main(), rpmgiReadHeader(), rpmInstallSourcePackage(), rpmrepoReadHeader(), rpmteFDHeader(), rpmts_HdrFromFdno(), and rpmtsSolve().

Functions

Detailed Description

Function Documentation