documented read buffer interface