nntp.h

/* This file is part of KDE
   Copyright (C) 2000 by Wolfram Diestel <wolfram@steloj.de>
   Copyright (C) 2005 by Tim Way <tim@way.hrcoxmail.com>
   Copyright (C) 2005 by Volker Krause <vkrause@kde.org>

   This is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.
*/

#ifndef _NNTP_H
#define _NNTP_H

#include <kurl.h>
#include <kio/tcpslavebase.h>

#define MAX_PACKET_LEN 8192

/* TODO:
  - test special post command
  - progress information in get, and maybe post
  - remove unnecessary debug stuff
*/
class NNTPProtocol:public KIO::TCPSlaveBase
{

 public:
  NNTPProtocol ( const QByteArray & pool, const QByteArray & app, bool isSSL );
  virtual ~NNTPProtocol();

  virtual void get(const KUrl& url );
  virtual void put( const KUrl& url, int permissions, KIO::JobFlags flags );
  virtual void stat(const KUrl& url );
  virtual void listDir(const KUrl& url );
  virtual void setHost(const QString& host, quint16 port,
        const QString& user, const QString& pass);

  virtual void special(const QByteArray& data);

 protected:

  int sendCommand( const QString &cmd );

  void nntp_close ();

  bool nntp_open();

  bool post_article();


 private:
   QString mHost, mUser, mPass;
   quint16 m_port, m_defaultPort;
   bool postingAllowed, isAuthenticated;
   char readBuffer[MAX_PACKET_LEN];
   ssize_t readBufferLen;
   QString mCurrentGroup;

   void fetchGroups( const QString &since, bool desc );
   bool fetchGroup ( QString &group, unsigned long first = 0, unsigned long max = 0 );
   bool fetchGroupRFC977( unsigned long first );
   bool fetchGroupXOVER( unsigned long first, bool &notSupported );
   void fillUDSEntry ( KIO::UDSEntry & entry, const QString & name, long size,
                       bool is_article, long access = 0 );
   void unexpected_response ( int res_code, const QString & command );
   int evalResponse ( char *data, ssize_t &len );
   int authenticate();
};

#endif