RD_CopyAudio
    7
    October 2015
    Rivendell C Library Manual
  
  
    rd_copyaudio
    Rivendell Audio Store C Library Function
  
  
    
      
        Todd
        Baker
        bakert@rfa.org
      
      Rivendell C Library Author
    
  
  
  
    
    #include <rivwebcapi/rd_copyaudio.h>
    
    int RD_CopyAudio
      const char hostname[]
      const char username[]
      const char passwd[]
      const char ticket[]
      const unsigned src_cartnumber
      const unsigned src_cutnumber
      const unsigned dest_cartnumber
      const unsigned dest_cutnumber
      const char user_agent[]
     
    
  
  Description
  
    RD_CopyAudio is  the function to use
    to copy PCM/MPEG data from one Source Cart/Cut to a Destination Cart/Cut.
  
  
    RD_CopyAudio function call fields
    
      
      
      
      
      
        
          
            FIELD NAME
          
          
            FIELD TYPE
          
          
            MEANING
          
          
            REMARKS
          
        
      
      
        
          
            hostname
          
          
          Character Array
          
          
            Name Of Rivendell DB Host
          
          
            Mandatory When NO Ticket Provided
          
        
        
          
            username
          
          
          Character Array
          
          
            Rivendell User Name
          
          
            Mandatory
          
        
        
          
            passwd
          
          
          Character Array
          
          
            Rivendell User Password
          
          
            Mandatory When NO Ticket Provided
          
        
        
          
            ticket
          
          
          Character Array
          
          
            Rivendell Authentification Ticket
          
          
            Mandatory When NO User/Password Pair Provided.
          
        
        
          
            src_cartnumber
          
          
          unsigned integer
          
          
            Source Cart Number
          
          
            Mandatory
          
        
        
          
            src_cutnumber
          
          
          unsigned integer
          
          
            Source Cut Number
          
          
            Mandatory
          
        
        
          
            dest_cartnumber
          
          
          unsigned integer
          
          
            Destination Cart Number
          
          
            Mandatory
          
        
        
          
            dest_cutnumber
          
          
          unsigned integer
          
          
            Destination Cut Number
          
          
            Mandatory
          
        
        
          
            user_agent
          
          
          Character Array
          
          
            User Agent Value put into HTTP request
          
          
            Optional (default is Rivendell-C-API/x.x.x)
          
        
      
    
  
  
  RETURN VALUE
    
      On success, zero is returned. 
    
    
      If a server error occurs a -1 is returned.
      If a client error occurs a specific error number is returned.
    
  
  ERRORS
    
      400          Missing Cart Number / Cut Number Error.
    
    
      400          Could Not Link Cart/Cut Number Error.
    
    
      403          User Authentification Error.
    
    
      404          No Such Cart.
    
    
      nnn          Unknown Error Occurred.